PDO::prepare

PHP PDO 参考手册PHP PDO リファレンスマニュアル

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文を準備する

例

<?php /*配列値を使用してプリペアドステートメントに値を渡す*/ $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文を準備する

例

<?php /*配列値を使用してプリペアドステートメントに値を渡す*/ $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 参考手册PHP PDO リファレンスマニュアル

その他の拡張モジュール