PDOStatement->bindValue()
(PHP 5 >= 5.1.0, PECL pdo:1.0-1.0.3)
PDOStatement->bindValue() — 値をパラメータにバインドする
説明
PDOStatement
bool bindValue
( mixed $parameter
, mixed $value
[, int $data_type
] )
プリペアドステートメントで使用する SQL 文の中で、 対応する名前あるいは疑問符のプレースホルダに値をバインドします。
パラメータ
- parameter
-
パラメータ ID。名前つきプレースホルダを使用する プリペアドステートメントの場合は、 :name 形式のパラメータ名となります。 疑問符プレースホルダを使用するプリペアドステートメントの場合は、 1 から始まるパラメータの位置となります。
- value
-
パラメータにバインドする値。
- data_type
-
パラメータに対して PDO::PARAM_* 定数を使った明示的なデータ型を指定します。 デフォルトは PHP のネイティブ型です。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
例
Example#1 名前付けされたプレースホルダを用いてプリペアドステートメントを実行する
<?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();
?>
Example#2 疑問符プレースホルダを用いてプリペアドステートメントを実行する
<?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();
?>