PDO::prepare
PDO::prepare — 実行するSQL文を準備し、PDOStatement オブジェクトを返す (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
説明
構文
public PDOStatement PDO::prepare ( string $statement [, array $driver_options = array() ] )
PDOStatement::execute() メソッドで実行するSQL文を準備します。SQL文には、名前付き(:name)または疑問符(?)のパラメータマーカーを0個以上含めることができ、SQL実行時にパラメータが置き換えられます。
SQL文には名前付き(:name)と疑問符(?)のパラメータマーカーを同時に含めることはできません。どちらか一方のスタイルのみを選択してください。
プリペアドSQL文のパラメータは、PDOStatement::execute() メソッドの使用時に実際のパラメータが渡されます。
パラメータ
statement
有効なSQL文。
driver_options
この配列には、PDOStatement オブジェクトの属性を設定するための key=>value ペアが1つ以上含まれます。最も一般的な使い方は、PDO::ATTR_CURSOR を PDO::CURSOR_SCROLL に設定して、スクロール可能なカーソルを要求することです。
戻り値
成功した場合、PDO::prepare() は PDOStatement オブジェクトを返します。失敗した場合は FALSE を返すか、例外 PDOException をスローします。
例
名前付き(:name)パラメータを使用してSQL文を準備する
例
/*配列値を使用してプリペアドステートメントに値を渡す*/
$sql = 'SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour';
$sth = $dbh->prepare($sql, array(PDO::ATTR_CURSOR => PDO::CURSOR_FWDONLY));
$sth->execute(array(':calories' => 150, ':colour' => 'red'));
$red = $sth->fetchAll();
$sth->execute(array(':calories' => 175, ':colour' => 'yellow'));
$yellow = $sth->fetchAll();
疑問符(?)パラメータを使用してSQL文を準備する
例
/*配列値を使用してプリペアドステートメントに値を渡す*/
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->execute(array(150, 'red'));
$red = $sth->fetchAll();
$sth->execute(array(175, 'yellow'));
$yellow = $sth->fetchAll();
PHP PDO リファレンスマニュアル