mysqli_stmt::bind_param

mysqli_stmt_bind_param

(PHP 5, PHP 7)

mysqli_stmt::bind_param -- mysqli_stmt_bind_paramプリペアドステートメントのパラメータに変数をバインドする

説明

オブジェクト指向型

mysqli_stmt::bind_param ( string $types , mixed &$var1 [, mixed &$... ] ) : bool

手続き型

mysqli_stmt_bind_param ( mysqli_stmt $stmt , string $types , mixed &$var1 [, mixed &$... ] ) : bool

変数を、SQL ステートメントのパラメータマーカにバインドします。 この変数は、mysqli_prepare() に渡されたものです。

注意:

データのサイズがパケットサイズの最大値(max_allowed_packet)を こえた場合、typesb を 指定して 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 で、複数のパケットに分割して送信されます。

var1

変数の数。文字列 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.

参考