PDOStatement->bindParam
PDOStatement->closeCursor
PDOStatement
PHP Manual

# PDOStatement->bindValue

(No version information available, might be only in CVS)

PDOStatement->bindValue — 値をパラメータにバインドする

### 説明

bool PDOStatement::bindValue ( mixed `$parameter` , mixed `$value` [, int `$data_type` ] )

プリペアドステートメントで使用する SQL 文の中で、 対応する名前あるいは疑問符のプレースホルダに値をバインドします。

### パラメータ

`parameter`

  パラメータ ID。名前つきプレースホルダを使用する プリペアドステートメントの場合は、 :name 形式のパラメータ名となります。 疑問符プレースホルダを使用するプリペアドステートメントの場合は、 1 から始まるパラメータの位置となります。

`value`

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

`data_type`

  パラメータに対して PDO::PARAM_* 定数を使った明示的なデータ型を指定します。 デフォルトは `PDO::PARAM_STR` です。

### 返り値

成功した場合に `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()

PDOStatement->bindParam
PDOStatement->closeCursor
PDOStatement
PHP Manual