PHPのお勉強！

PHP TOP
PHP 8.4.2 Released!

    mysqli::rollback

    mysqli_rollback

    (PHP 5, PHP 7, PHP 8)

    mysqli::rollback -- mysqli_rollback — 現在のトランザクションをロールバックする

    説明

    オブジェクト指向型

    public mysqli::rollback(int $flags = 0, ?string $name = null): bool

    手続き型

    mysqli_rollback(mysqli $mysql, int $flags = 0, ?string $name = null): bool

    データベースの現在のトランザクションをロールバックします。

    パラメータ

    link

    手続き型のみ: mysqli_connect() あるいは mysqli_init() が返す mysqliオブジェクト。

    flags

    定数 MYSQLI_TRANS_COR_* のビットマスク。

    name

    指定した場合は、ROLLBACK/*name*/ を実行します。

    戻り値

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

    エラー / 例外

    mysqli のエラー報告 (MYSQLI_REPORT_ERROR) が有効になっており、かつ要求された操作が失敗した場合は、警告が発生します。さらに、エラー報告のモードが MYSQLI_REPORT_STRICT に設定されていた場合は、mysqli_sql_exception が代わりにスローされます。

    変更履歴

    バージョン 説明
    8.0.0 name は、nullable になりました。

    例

    mysqli::begin_transaction() の例 を参照ください。

    注意

    注意:

    この関数は、トランザクションに 対応していないテーブル型（MyISAM あるいは ISAM など）では 動作しません。

    参考

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 4 notes

    up
    44
    Steven McCoy
    12 years ago
    Remember that MyISAM tables do not support rollbacks.

    I just drove myself crazy for an afternoon trying to figure out what was wrong with my code - meanwhile it was fine all along
    up
    34
    Lorenzo - webmaster AT 4tour DOT it
    15 years ago
    This is an example to explain the powerful of the rollback and commit functions.
    Let's suppose you want to be sure that all queries have to be executed without errors before writing data on the database.
    Here's the code:

    <?php
    $all_query_ok    =true; // our control variable

    //we make 4 inserts, the last one generates an error
    //if at least one query returns an error we change our control variable
    $mysqli->query("INSERT INTO myCity (id) VALUES (100)") ? null : $all_query_ok=false;
    $mysqli->query("INSERT INTO myCity (id) VALUES (200)") ? null : $all_query_ok=false;
    $mysqli->query("INSERT INTO myCity (id) VALUES (300)") ? null : $all_query_ok=false;
    $mysqli->query("INSERT INTO myCity (id) VALUES (100)") ? null : $all_query_ok=false; //duplicated PRIMARY KEY VALUE

    //now let's test our control variable
    $all_query_ok ? $mysqli->commit() : $mysqli->rollback();

    $mysqli->close();
    ?>

    hope to be helpful!
    up
    3
    Yorick Phoenix
    1 year ago
    If you use savepoints - eg savepoint($foo) - be wary of trying to rollback to the save point with rollback(0, $foo) as that executes "ROLLBACK /* $foo */" instead of "ROLLBACK TO `$foo`".

    The manual page is clear about this, but is easily overlooked.

    Instead use: $mysqli->query("ROLLBACK TO `$foo`");
    up
    15
    xcalibur at xcalibur dot dk
    14 years ago
    Just a note about auto incremental ids and rollback.
    When using transactions and inserting into a table containing a column with auto incremental ids, the id will be incremented even though the transaction is rolled back.

    This might occupy a lot of ids if a lot of rollbacks are performed.

    Example:
    <?php
    $mysqli     = new mysqli("localhost", "gugbageri", "gugbageri", "gugbageri");

    /* check connection */
    if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
    }

    /* disable autocommit */
    $mysqli->autocommit(FALSE);

    /* We just create a test table with one auto incremental primary column and a content column*/
    $mysqli->query("CREATE TABLE TestTable ( `id_column` INT NOT NULL AUTO_INCREMENT , `content` INT NOT NULL , PRIMARY KEY ( `id_column` )) ENGINE = InnoDB;");

    /* commit newly created table */
    $mysqli->commit();

    /* we insert a row */
    $mysqli->query("INSERT INTO TestTable (content) VALUES (99)");

    /* we commit the inserted row */
    $mysqli->commit();

    /* we insert another three rows */
    $mysqli->query("INSERT INTO TestTable (content) VALUES (99)");
    $mysqli->query("INSERT INTO TestTable (content) VALUES (99)");
    $mysqli->query("INSERT INTO TestTable (content) VALUES (99)");

    /* we the rollback */
    $mysqli->rollback();

    /* we insert a row */
    $mysqli->query("INSERT INTO TestTable (content) VALUES (99)");

    /* we commit the inserted row */
    $mysqli->commit();

    if (    $result = $mysqli->query("SELECT id_column FROM TestTable")) {

    while(    $row = $result->fetch_row()) {
    printf("Id: %d.\n", $row[0]);
    }
    /* Free result */
    $result->close();
    }

    /* Drop table TestTable */
    $mysqli->query("DROP TABLE TestTable");

    $mysqli->close();
    ?>

    This will output:
    Id: 1.
    Id: 5.
    ＋add a note
    To Top