mysqli_stmt::bind_param
mysqli_stmt_bind_param
(PHP 5, PHP 7)
mysqli_stmt::bind_param -- mysqli_stmt_bind_param — プリペアドステートメントのパラメータに変数をバインドする
説明
オブジェクト指向型
手続き型
mysqli_stmt_bind_param
( mysqli_stmt $stmt
, string $types
, mixed &$var
, mixed &...$vars
) : bool
変数を、SQL ステートメントのパラメータマーカにバインドします。 この変数は、mysqli_prepare() に渡されたものです。
注意:
データのサイズがパケットサイズの最大値（max_allowed_packet）を こえた場合、
typesにbを 指定して mysqli_stmt_send_long_data() を使用し、 データをパケットに分割して送信する必要があります。
注意:
mysqli_stmt_bind_param() と call_user_func_array() を組み合わせて使う場合は注意が必要です。 mysqli_stmt_bind_param() へのパラメータは参照渡しでなければなりませんが、 call_user_func_array() には変数のリストをパラメータとして渡すことができます。 この変数は参照であっても値であってもかまいません。
パラメータ
stmt手続き型のみ: mysqli_stmt_init() が返すステートメント ID。
typesひとつあるいは複数の文字で、対応するバインド変数の型を表します。
型指定文字 文字 説明 i 対応する変数の型は integer です。 d 対応する変数の型は double です。 s 対応する変数の型は string です。 b 対応する変数の型は blob で、複数のパケットに分割して送信されます。 var
vars変数の数。文字列
typesの長さは、ステートメント中のパラメータの数と一致する必要があります。
返り値
成功した場合に true を、失敗した場合に false を返します。
例
例1 オブジェクト指向型
<?php$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');/* 接続状況をチェックします */if (mysqli_connect_errno()) { printf("Connect failed: %s\n", mysqli_connect_error()); exit();}$stmt = $mysqli->prepare("INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");$stmt->bind_param('sssd', $code, $language, $official, $percent);$code = 'DEU';$language = 'Bavarian';$official = "F";$percent = 11.2;/* プリペアドステートメントを実行します */$stmt->execute();printf("%d Row inserted.\n", $stmt->affected_rows);/* ステートメントと接続を閉じます */$stmt->close();/* CountryLanguage テーブルをクリアします */$mysqli->query("DELETE FROM CountryLanguage WHERE Language='Bavarian'");printf("%d Row deleted.\n", $mysqli->affected_rows);/* 接続を閉じます */$mysqli->close();?>
例2 手続き型
<?php$link = mysqli_connect('localhost', 'my_user', 'my_password', 'world');/* 接続状況をチェックします */if (!$link) { printf("Connect failed: %s\n", mysqli_connect_error()); exit();}$stmt = mysqli_prepare($link, "INSERT INTO CountryLanguage VALUES (?, ?, ?, ?)");mysqli_stmt_bind_param($stmt, 'sssd', $code, $language, $official, $percent);$code = 'DEU';$language = 'Bavarian';$official = "F";$percent = 11.2;/* プリペアドステートメントを実行します */mysqli_stmt_execute($stmt);printf("%d Row inserted.\n", mysqli_stmt_affected_rows($stmt));/* ステートメントと接続を閉じます */mysqli_stmt_close($stmt);/* CountryLanguage テーブルをクリアします */mysqli_query($link, "DELETE FROM CountryLanguage WHERE Language='Bavarian'");printf("%d Row deleted.\n", mysqli_affected_rows($link));/* 接続を閉じます */mysqli_close($link);?>
上の例の出力は以下となります。
1 Row inserted. 1 Row deleted.
参考
- mysqli_stmt_bind_result() - 結果を保存するため、プリペアドステートメントに変数をバインドする
- mysqli_stmt_execute() - プリペアドクエリを実行する
- mysqli_stmt_fetch() - プリペアドステートメントから結果を取得し、バインド変数に格納する
- mysqli_prepare() - 実行するための SQL ステートメントを準備する
- mysqli_stmt_send_long_data() - データをブロックで送信する
- mysqli_stmt_errno() - 直近のステートメントのコールに関するエラーコードを返す
- mysqli_stmt_error() - 直近のステートメントのエラー内容を文字列で返す
