PDO::rollBack

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

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

說(shuō)明

PDO::rollBack(): bool

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

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

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

返回值

成功時(shí)返回 true， 或者在失敗時(shí)返回 false。

范例

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

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

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

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

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

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

參見(jiàn)