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