PDOStatement::bindParam
PDOStatement::bindParam — 指定した変数名にパラメータをバインドする (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
説明
構文
bool PDOStatement::bindParam ( mixed $parameter , mixed &$variable [, int $data_type = PDO::PARAM_STR [, int $length [, mixed $driver_options ]]] )
PHP 変数を、プリペアド SQL 文の対応する名前付きプレースホルダまたはクエスチョンプレースホルダにバインドします。 PDOStatement::bindValue() とは異なり、この変数は参照としてバインドされ、PDOStatement::execute() が呼び出されたときにのみ値が評価されます。
ほとんどのパラメータは入力パラメータで、クエリの構築に読み取り専用で使用されます。一部のドライバは、ストアドプロシージャを呼び出して出力パラメータとしてデータを返すことをサポートし、また一部は入力/出力パラメータとして、データの送信と更新後のデータの受信の両方をサポートします。
パラメータ
parameter
パラメータ識別子。名前付きプレースホルダを使用するプリペアドステートメントの場合は、:name 形式のパラメータ名を使用します。クエスチョンプレースホルダを使用するプリペアドステートメントの場合は、1 から始まるインデックスのパラメータ位置を使用します。
variable
SQL ステートメントのパラメータにバインドされる PHP 変数名。
data_type
PDO::PARAM_* 定数を使用して、パラメータの型を明示的に指定します。ストアドプロシージャから INOUT パラメータを返すには、data_type パラメータにビット演算子 OR を使用して PDO::PARAM_INPUT_OUTPUT ビットを設定する必要があります。
length
事前割り当てのヒント。
driverdata
データ型の長さ。パラメータがストアドプロシージャの OUT パラメータであることを示すには、この長さを明示的に設定する必要があります。
driver_options
戻り値
成功した場合に TRUE を返し、失敗した場合に FALSE を返します。
例
名前付きプレースホルダを使用したプリペアドステートメントを実行する
<?php
/* 通过绑定的 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');
$sth->bindParam(':calories', $calories, PDO::PARAM_INT);
$sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>
クエスチョンプレースホルダを使用したプリペアドステートメントを実行する
<?php
/* 通过绑定的 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->bindParam(1, $calories, PDO::PARAM_INT);
$sth->bindParam(2, $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>
INOUT パラメータを使用してストアドプロシージャを呼び出す
<?php
/* 使用 INOUT 参数调用一个存储过程 */
$colour = 'red';
$sth = $dbh->prepare('CALL puree_fruit(?)');
$sth->bindParam(1, $colour, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 12);
$sth->execute();
print("After pureeing fruit, the colour is: $colour");
?>
その他の拡張モジュール
PHP PDO リファレンスマニュアル