PDOStatement::execute
PDOStatement::execute — プリペアドステートメントを実行する(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
説明
構文
bool PDOStatement::execute ([ array $input_parameters ] )
プリペアドステートメントを実行します。プリペアドステートメントにパラメータマーカーが含まれている場合は、次のいずれかの方法を選択する必要があります:
呼び出しPDOStatement::bindParam()PHP変数をパラメータマーカーにバインドします:関連するパラメータマーカーにバインドされた変数を介して、入力値を渡し、(もしあれば)出力値を取得します
または、入力パラメータ値のみとして配列を渡す
パラメータ
input_parameters
実行されるSQLステートメント内のバインドされたパラメータの数と同じ数の要素を持つ配列。すべての値は PDO::PARAM_STR として扱われます。
複数の値を単一のパラメータにバインドすることはできません。たとえば、IN()句内の単一の名前付きパラメータに2つの値をバインドすることはできません。
指定された数より多くの値をバインドすることはできません。PDO::prepare() でプリペアドされたSQLに存在するよりも多くのキーが input_parameters に存在する場合、このステートメントは失敗し、エラーが発生します。
戻り値
成功した場合は TRUE を返し、失敗した場合は FALSE を返します。
例
バインド変数を使用してプリペアドステートメントを実行する
<?php
/* 通过绑定 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');
$sth->bindParam(':calories', $calories, PDO::PARAM_INT);
$sth->bindParam(':colour', $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>
挿入値を含む配列を使用してプリペアドステートメントを実行する(名前付きパラメータ)
<?php
/* 通过传递一个含有插入值的数组执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < :calories AND colour = :colour');
$sth->execute(array(':calories' => $calories, ':colour' => $colour));
?>
挿入値を含む配列を使用してプリペアドステートメントを実行する(プレースホルダ)
<?php
/* 通过传递一个插入值的数组执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->execute(array($calories, $colour));
?>
クエスチョンマークのプレースホルダを使用してプリペアドステートメントを実行する
<?php
/* 通过绑定 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->bindParam(1, $calories, PDO::PARAM_INT);
$sth->bindParam(2, $colour, PDO::PARAM_STR, 12);
$sth->execute();
?>
配列を使用して IN 句を含むプリペアドステートメントを実行する
<?php
/* 使用一个数组的值执行一条含有 IN 子句的预处理语句 */
$params = array(1, 21, 63, 171);
/* 创建一个填充了和params相同数量占位符的字符串 */
$place_holders = implode(',', array_fill(0, count($params), '?'));
/*
对于 $params 数组中的每个值,要预处理的语句包含足够的未命名占位符 。
语句被执行时, $params 数组中的值被绑定到预处理语句中的占位符。
这和使用 PDOStatement::bindParam() 不一样,因为它需要一个引用变量。
PDOStatement::execute() 仅作为通过值绑定的替代。
*/
$sth = $dbh->prepare("SELECT id, name FROM contacts WHERE id IN ($place_holders)");
$sth->execute($params);
?>
その他の拡張モジュール
PHP PDO リファレンスマニュアル