PDOStatement::bindValue

PHP PDO 参考手册PHP PDO リファレンスマニュアル

PDOStatement::bindValue — 値をパラメータにバインドする (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


説明

構文

bool PDOStatement::bindValue ( mixed $parameter , mixed $value [, int $data_type = PDO::PARAM_STR ] )

プリペアドステートメントで使用する SQL 文の対応する名前付きプレースホルダまたはクエスチョンマークのプレースホルダに値をバインドします。


パラメータ

parameter
パラメータ識別子。名前付きプレースホルダを使用するプリペアドステートメントの場合は、:name 形式のパラメータ名です。クエスチョンマークのプレースホルダを使用するプリペアドステートメントの場合は、1 から始まるパラメータ位置です。

value
パラメータにバインドする値

data_type
PDO::PARAM_* 定数を使用して、パラメータの型を明示的に指定します。


戻り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。


例

名前付きプレースホルダを使用するプリペアドステートメントを実行する

<?php
/* 通过绑定的 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < :calories AND colour = :colour');
$sth->bindValue(':calories', $calories, PDO::PARAM_INT);
$sth->bindValue(':colour', $colour, PDO::PARAM_STR);
$sth->execute();
?>

クエスチョンマークのプレースホルダを使用するプリペアドステートメントを実行する

<?php
/* 通过绑定的 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < ? AND colour = ?');
$sth->bindValue(1, $calories, PDO::PARAM_INT);
$sth->bindValue(2, $colour, PDO::PARAM_STR);
$sth->execute();
?>

PHP PDO 参考手册PHP PDO リファレンスマニュアル

その他の拡張