PDO::rollBack
PDO::rollBack — Annule une transaction (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
Description
Syntaxe
bool PDO::rollBack ( void )
Annule la transaction courante initiée par PDO::beginTransaction(). S'il n'y a pas de transaction active, une PDOException sera levée.
Si la base de données est configurée en mode autocommit, cette fonction (méthode) restaurera le mode autocommit après l'annulation de la transaction.
Dans certaines bases de données, y compris MySQL, les instructions DLL telles que la suppression ou la création de tables provoquent automatiquement un commit implicite lorsqu'elles sont émises dans une transaction. Le commit implicite rendra impossible l'annulation de toute modification dans le cadre de cette transaction.
Valeurs de retour
Retourne TRUE en cas de succès, ou FALSE en cas d'échec.
Exemples
Annuler une transaction
L'exemple suivant démarre une transaction et exécute deux instructions qui modifient la base de données avant d'annuler les modifications. Cependant, dans MySQL, l'instruction DROP TABLE valide automatiquement la transaction, donc aucune des modifications de cette transaction ne sera annulée.
<?php
/* 开始一个事务,关闭自动提交 */
$dbh->beginTransaction();
/* 更改数据库架构和数据 */
$sth = $dbh->exec("DROP TABLE fruit");
$sth = $dbh->exec("UPDATE dessert
SET name = 'hamburger'");
/* 识别错误且回滚更改 */
$dbh->rollBack();
/* 此时数据库连接恢复到自动提交模式 */
?>
Autres extensions
Manuel de référence PHP PDO