PDO::exec

Manuel de référence PHP PDO

PDO::exec — Exécute une instruction SQL et retourne le nombre de lignes affectées (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

Description

Syntaxe

int PDO::exec ( string $statement )

PDO::exec() exécute une instruction SQL en un seul appel de fonction, retournant le nombre de lignes affectées par l'instruction.

PDO::exec() ne retourne pas les résultats d'une instruction SELECT. Pour une instruction SELECT qui ne doit être émise qu'une seule fois dans votre programme, envisagez d'utiliser PDO::query().

Paramètres :

statement: L'instruction SQL à préparer et à exécuter.

Valeurs de retour

PDO::exec() renvoie le nombre de lignes affectées par l'instruction SQL modifiée ou supprimée. S'il n'y a aucune ligne affectée, PDO::exec() renvoie 0.

L'exemple suivant s'appuie incorrectement sur la valeur de retour de PDO::exec() ; une instruction avec 0 ligne affectée entraînera l'appel de die() :

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

Exemples

Exécuter une instruction DELETE

Compter le nombre de lignes supprimées par une instruction DELETE sans clause WHERE.

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

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

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

L'exemple ci-dessus affichera :

Deleted 1 rows.

Manuel de référence PHP PDO