PDO::rollBack

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

PDO::rollBack — 回滾一個事務(wù)

說明

PDO::rollBack(): bool

回滾由 PDO::beginTransaction() 發(fā)起的當前事務(wù)。如果沒有事務(wù)激活，將拋出一個 PDOException 異常。

如果數(shù)據(jù)庫被設(shè)置成自動提交模式，此函數(shù)（方法）在回滾事務(wù)之后將恢復自動提交模式。

包括 MySQL 在內(nèi)的一些數(shù)據(jù)庫， 當在一個事務(wù)內(nèi)有類似刪除或創(chuàng)建數(shù)據(jù)表等 DLL 語句時，會自動導致一個隱式地提交。隱式地提交將無法回滾此事務(wù)范圍內(nèi)的任何更改。

返回值

成功時返回 true， 或者在失敗時返回 false。

范例

示例 #1 回滾一個事務(wù)

下面例子在回滾更改之前開始一個事務(wù)并發(fā)出兩條修改數(shù)據(jù)庫的語句。但在 MySQL 中，DROP TABLE 語句自動提交事務(wù)，因此在此事務(wù)內(nèi)的任何更改都不會被回滾。

<?php
/* 開始一個事務(wù)，關(guān)閉自動提交 */
$dbh->beginTransaction();

/* 更改數(shù)據(jù)庫架構(gòu)和數(shù)據(jù)  */
$sth = $dbh->exec("DROP TABLE fruit");
$sth = $dbh->exec("UPDATE dessert
    SET name = 'hamburger'");

/*  識別錯誤且回滾更改  */
$dbh->rollBack();

/*  此時數(shù)據(jù)庫連接恢復到自動提交模式  */
?>

參見