PDO::rollBack

PHP PDO 参考手册PHP PDO-Referenzhandbuch

PDO::rollBack — Macht eine Transaktion rückgängig (PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


Beschreibung

Syntax

bool PDO::rollBack ( void )

Macht die aktuelle Transaktion rückgängig, die durch PDO::beginTransaction() initiiert wurde. Wenn keine aktive Transaktion vorhanden ist, wird eine PDOException ausgelöst.

Wenn die Datenbank auf den Autocommit-Modus eingestellt ist, stellt diese Funktion (Methode) nach dem Rückgängigmachen der Transaktion den Autocommit-Modus wieder her.

In einigen Datenbanken, einschließlich MySQL, verursachen DLL-Anweisungen wie das Löschen oder Erstellen von Tabellen automatisch ein implizites Commit, wenn sie innerhalb einer Transaktion ausgeführt werden. Das implizite Commit macht es unmöglich, Änderungen im Rahmen dieser Transaktion zurückzurollen.


Rückgabewerte

Gibt bei Erfolg TRUE zurück, bei Fehlschlag FALSE.


Beispiele

Eine Transaktion zurückrollen

Das folgende Beispiel startet eine Transaktion und führt zwei Anweisungen aus, die die Datenbank ändern, bevor die Änderungen zurückgerollt werden. In MySQL führt die Anweisung DROP TABLE jedoch automatisch ein Commit der Transaktion aus, sodass keine der Änderungen in dieser Transaktion zurückgerollt wird.

<?php
/* 开始一个事务,关闭自动提交 */
$dbh->beginTransaction();

/* 更改数据库架构和数据  */
$sth = $dbh->exec("DROP TABLE fruit");
$sth = $dbh->exec("UPDATE dessert
    SET name = 'hamburger'");

/*  识别错误且回滚更改  */
$dbh->rollBack();

/*  此时数据库连接恢复到自动提交模式  */
?>

PHP PDO 参考手册PHP PDO-Referenzhandbuch

Andere Erweiterungen