PDO::rollBack
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 リファレンスマニュアル