PDO::exec

PHP PDO-Referenzhandbuch

PDO::exec — Führt eine SQL-Anweisung aus und gibt die Anzahl der betroffenen Zeilen zurück (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

Beschreibung

Syntax

int PDO::exec ( string $statement )

PDO::exec() führt eine SQL-Anweisung in einem einzigen Funktionsaufruf aus und gibt die Anzahl der von der Anweisung betroffenen Zeilen zurück.

PDO::exec() gibt keine Ergebnisse aus einer SELECT-Anweisung zurück. Für eine SELECT-Anweisung, die in Ihrem Programm nur einmal ausgeführt werden muss, sollten Sie die Verwendung von PDO::query() in Betracht ziehen.

Parameter:

statement: Die SQL-Anweisung, die vorbereitet und ausgeführt werden soll.

Rückgabewerte

PDO::exec() gibt die Anzahl der von der geänderten oder gelöschten SQL-Anweisung betroffenen Zeilen zurück. Wenn keine Zeilen betroffen sind, gibt PDO::exec() 0 zurück.

Das folgende Beispiel verlässt sich fälschlicherweise auf den Rückgabewert von PDO::exec(); eine Anweisung mit 0 betroffenen Zeilen führt dazu, dass die() aufgerufen wird:

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

Beispiele

Eine DELETE-Anweisung ausführen

Zählen Sie die Anzahl der Zeilen, die durch eine DELETE-Anweisung ohne WHERE-Klausel gelöscht wurden.

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

/*  删除 FRUIT 数据表中满足条件的所有行 */
$count = $dbh->exec("DELETE FROM fruit WHERE colour = 'red'");

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

Das obige Beispiel gibt Folgendes aus:

Deleted 1 rows.

PHP PDO-Referenzhandbuch