Edit Report a Bug

    PDO::rollBack

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

    PDO::rollBack — トランザクションをロールバックする

    説明

    public PDO::rollBack(): bool

    PDO::beginTransaction() によって開始された 現在のトランザクションをロールバックします。

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

    MySQL を含むいくつかのデータベースでは、DROP TABLE や CREATE TABLE のようなデータベース定義言語 (DDL) ステートメントがトランザクション中に 発行される場合、暗黙的なコミットが自動的に発行されます。 この暗黙的なコミットにより、そのトランザクション境界で 他のあらゆる変更をロールバックすることができなくなるでしょう。

    パラメータ

    この関数にはパラメータはありません。

    戻り値

    成功した場合に true を、失敗した場合に false を返します。

    エラー / 例外

    有効なトランザクションがない場合に PDOException をスローします。

    注意: 例外は、PDO::ATTR_ERRMODE 属性が PDO::ERRMODE_EXCEPTION ではない場合でも発生します。

    例

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

    以下の例は、トランザクションを開始し、 変更をロールバックする前にデータベースを修正する 2 つのステートメントを発行します。 しかしながら MySQL では、DROP TABLE ステートメントは 自動的にトランザクションをコミットするので、 トランザクション中のどの変更もロールバックされません。

    <?php
    /* トランザクションを開始する。オートコミットがオフになる */
    $dbh->beginTransaction();

    /* データベーススキーマとデータを変更する */
    $sth = $dbh->exec("DROP TABLE fruit");
    $sth = $dbh->exec("UPDATE dessert
    SET name = 'hamburger'"    );

    /* ミスに気づき、変更をロールバックする */
    $dbh->rollBack();

    /* データベース接続はオートコミットモードに戻る */
    ?>

    参考

    add a note add a note

    User Contributed Notes 4 notes

    up
    53
    JonasJ
    16 years ago
    Just a quick (and perhaps obvious) note for MySQL users;

    Don't scratch your head if it isn't working if you are using a MyISAM table to test the rollbacks with.

    Both rollBack() and beginTransaction() will return TRUE but the rollBack will not happen.

    Convert the table to InnoDB and run the test again.
    up
    11
    brian at diamondsea dot com
    16 years ago
    Here is a way of testing that your transaction has started when using MySQL's InnoDB tables.  It will fail if you are using MySQL's MyISAM tables, which do not support transactions but will also not return an error when using them.

    <?
    // Begin the transaction
    $dbh->beginTransaction();

    // To verify that a transaction has started, try to create an (illegal for InnoDB) nested transaction.
    //    If it works, the first transaction did not start correctly or is unsupported (such as on MyISAM tables)
    try {
            $dbh->beginTransaction();
        die(    'Cancelling, Transaction was not properly started');
    } catch (    PDOException $e) {
        print     "Transaction is running (because trying another one failed)\n";
    }
    ?>
    up
    5
    Petros Giakouvakis
    14 years ago
    Should anyone reading this be slightly panicked because they just discovered that their MySQL  tables are MyIsam and not InnoDb, don't worry... You can very easily change the storage engine using the following query:

    ALTER TABLE your_table_name ENGINE = innodb;
    up
    -6
    linfo2003 at libero dot it
    17 years ago
    Since "It is an error to call this method if no transaction is active", it could be useful (even if not indispensable) to have a method which returns true if a transaction is active.

    try {
        $dbh->beginTransaction();
        ...
    } catch (PDOException $e) {
        if ($dbh->isTransactionActive())  // this function does NOT exist
            $dbh->rollBack();
        ...
    }

    In the meanwhile, I'm using this code:

        ...
    } catch (PDOException $e) {
        try { $dbh->rollBack(); } catch (Exception $e2) {}
        ...
    }

    It's not so chic, but it works fine.
    add a note add a note
    To Top