PDO::rollBack

PHP PDO 参考手册PHP PDO リファレンスマニュアル

PDO::rollBack — トランザクションをロールバックする(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)


説明

構文

bool PDO::rollBack ( void )

PDO::beginTransaction() によって開始された現在のトランザクションをロールバックします。アクティブなトランザクションがない場合は、PDOException 例外がスローされます。

データベースが自動コミットモードに設定されている場合、この関数(メソッド)はトランザクションのロールバック後に自動コミットモードを復元します。

MySQL を含む一部のデータベースでは、トランザクション内でテーブルの削除や作成などの DDL 文を実行すると、暗黙的なコミットが自動的に発生します。暗黙的なコミットでは、このトランザクションの範囲内の変更はロールバックできません。


戻り値

成功した場合は TRUE を返し、失敗した場合は FALSE を返します。


例

トランザクションをロールバックする

次の例では、変更をロールバックする前にトランザクションを開始し、データベースを変更する 2 つのステートメントを発行します。ただし MySQL では、DROP TABLE ステートメントはトランザクションを自動コミットするため、このトランザクション内の変更はロールバックされません。

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

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

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

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

PHP PDO 参考手册PHP PDO リファレンスマニュアル

その他の拡張モジュール