(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)
PDOStatement::execute — 執行一條預處理語(yǔ)句
$input_parameters
= ?): bool執行預處理過(guò)的語(yǔ)句。如果預處理過(guò)的語(yǔ)句含有參數標記,必須選擇下面其中一種做法:
調用 PDOStatement::bindParam() 綁定 PHP 變量到參數標記:如果有的話(huà),通過(guò)關(guān)聯(lián)參數標記綁定的變量來(lái)傳遞輸入值和取得輸出值
或傳遞一個(gè)只作為輸入參數值的數組
input_parameters
一個(gè)元素個(gè)數和將被執行的 SQL 語(yǔ)句中綁定的參數一樣多的數組。所有的值作為 PDO::PARAM_STR
對待。
不能綁定多個(gè)值到一個(gè)單獨的參數;比如,不能綁定兩個(gè)值到 IN()子句中一個(gè)單獨的命名參數。
綁定的值不能超過(guò)指定的個(gè)數。如果在 input_parameters
中存在比 PDO::prepare() 預處理的SQL 指定的多的鍵名,則此語(yǔ)句將會(huì )失敗并發(fā)出一個(gè)錯誤。
成功時(shí)返回 true
, 或者在失敗時(shí)返回 false
。
版本 | 說(shuō)明 |
---|---|
5.2.0 |
input_parameters 中的鍵名必須和 SQL 中聲明的相匹配。PHP 5.2.0 之前默認忽略。
|
示例 #1 執行一條綁定變量的預處理語(yǔ)句
<?php
/* 通過(guò)綁定 PHP 變量執行一條預處理語(yǔ)句 */
$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();
?>
示例 #2 使用一個(gè)含有插入值的數組執行一條預處理語(yǔ)句(命名參數)
<?php
/* 通過(guò)傳遞一個(gè)含有插入值的數組執行一條預處理語(yǔ)句 */
$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));
?>
示例 #3 使用一個(gè)含有插入值的數組執行一條預處理語(yǔ)句(占位符)
<?php
/* 通過(guò)傳遞一個(gè)插入值的數組執行一條預處理語(yǔ)句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
FROM fruit
WHERE calories < ? AND colour = ?');
$sth->execute(array($calories, $colour));
?>
示例 #4 執行一條問(wèn)號占位符的預處理語(yǔ)句
<?php
/* 通過(guò)綁定 PHP 變量執行一條預處理語(yǔ)句 */
$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();
?>
示例 #5 使用數組執行一條含有 IN 子句的預處理語(yǔ)句
<?php
/* 使用一個(gè)數組的值執行一條含有 IN 子句的預處理語(yǔ)句 */
$params = array(1, 21, 63, 171);
/* 創(chuàng )建一個(gè)填充了和params相同數量占位符的字符串 */
$place_holders = implode(',', array_fill(0, count($params), '?'));
/*
對于 $params 數組中的每個(gè)值,要預處理的語(yǔ)句包含足夠的未命名占位符 。
語(yǔ)句被執行時(shí), $params 數組中的值被綁定到預處理語(yǔ)句中的占位符。
這和使用 PDOStatement::bindParam() 不一樣,因為它需要一個(gè)引用變量。
PDOStatement::execute() 僅作為通過(guò)值綁定的替代。
*/
$sth = $dbh->prepare("SELECT id, name FROM contacts WHERE id IN ($place_holders)");
$sth->execute($params);
?>
注意:
有些驅動(dòng)在執行下一條語(yǔ)句前需要 關(guān)閉游標 。