PDO::exec

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDO::exec — 執(zhí)行一條 SQL 語句，并返回受影響的行數

說明

PDO::exec(string $statement): int

PDO::exec() 在一個單獨的函數調用中執(zhí)行一條 SQL 語句，返回受此語句影響的行數。

PDO::exec() 不會從一條 SELECT 語句中返回結果。對于在程序中只需要發(fā)出一次的 SELECT 語句，可以考慮使用 PDO::query()。對于需要發(fā)出多次的語句，可用 PDO::prepare() 來準備一個 PDOStatement 對象并用 PDOStatement::execute() 發(fā)出語句。

參數

statement

要被預處理和執(zhí)行的 SQL 語句。

查詢中的數據應該被 妥善地轉義 。

返回值

PDO::exec() 返回受修改或刪除 SQL 語句影響的行數。如果沒有受影響的行，則 PDO::exec() 返回 0。

警告

此函數可能返回布爾值 false，但也可能返回等同于 false 的非布爾值。請閱讀 布爾類型章節(jié)以獲取更多信息。應使用 === 運算符來測試此函數的返回值。

下面例子依賴 PDO::exec() 的返回值是不正確的，其中受影響行數為 0 的語句會導致調用 die() ：

<?php
$db->exec() or die(print_r($db->errorInfo(), true));
?>

范例

示例 #1 發(fā)出一條 DELETE 語句

計算由一條不帶 WHERE 字句的 DELETE 語句刪除的行數。

<?php
$dbh = new PDO('odbc:sample', 'db2inst1', 'ibmdb2');

/*  刪除 FRUIT 數據表中滿足條件的所有行 */
$count = $dbh->exec("DELETE FROM fruit WHERE colour = 'red'");

/* 返回被刪除的行數 */
print("Deleted $count rows.\n");
?>

以上例程會輸出：

Deleted 1 rows.

參見