PDOStatement::bindValue

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 ステートメント内の対応する名前付きプレースホルダーまたは疑問符プレースホルダーに値をバインドします。

パラメータ

パラメーターパラメーターの識別子。名前付きプレースホルダーを使用する準備済みステートメントの場合、パラメーター名の形式は :name である必要があります。疑問符プレースホルダーを使用する準備済みステートメントの場合、パラメーターの位置は 1 から始まるインデックスを付ける必要があります。

値はパラメータの値にバインドされます

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

戻り値

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

例

名前付きプレースホルダーを使用して準備されたステートメントを実行する

<?php/* バインドされた PHP 変数を使用してプリペアド ステートメントを実行します*/$calers = 150;$colour = 'red';$sth = $dbh->prepare('SELECT 名前、色、カロリー FROM フルーツ WHERE カロリー < :カロリーAND color = :colour');$sth->bindValue(':カロリー', $カロリー, PDO::PARAM_INT);$sth->bindValue(':colour', $colour, PDO::PARAM_STR);$sth->execute();?>

疑問符プレースホルダーを使用して準備されたステートメントを実行する

<?php/* バインドされた PHP 変数を使用して準備済みステートメントを実行します*/$calers = 150;$colour = 'red';$sth = $dbh->prepare('SELECT 名前、色、カロリー FROM フルーツ WHERE カロリー < ? AND color = ?');$sth->bindValue(1, $カロリー, PDO::PARAM_INT);$sth->bindValue(2, $colour, PDO::PARAM_STR);$sth->execute();?>