PDO語句::執行

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（）子句中一個單獨的命名參數。

綁定的值不能超過指定的個數。如果在input_parameters 中存在比PDO::prepare() 預處理的SQL 指定的多的鍵名，則此語句將會失敗並發出錯誤。

傳回值

成功時回傳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);?>