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

# mysqli::rollback

# mysqli_rollback

(PHP 5, PHP 7)

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

### 説明

オブジェクト指向型

mysqli::rollback ([ int `$flags` [, string `$name` ]] ) : bool

手続き型

mysqli_rollback ( mysqli `$link` [, int `$flags` [, string `$name` ]] ) : bool

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

### パラメータ

`link`

  手続き型のみ: mysqli_connect() あるいは mysqli_init() が返すリンク ID。

`flags`

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

`name`

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

### 返り値

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

### 変更履歴

バージョン | 説明
--- | ---
5.5.0 | `flags` と `name` が追加されました。

### 例

例1 mysqli::rollback() の例

オブジェクト指向型

`<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
/* 自動コミットを無効にします */
$mysqli->autocommit(FALSE);
$mysqli->query("CREATE TABLE myCity LIKE City");
$mysqli->query("ALTER TABLE myCity Type=InnoDB");
$mysqli->query("INSERT INTO myCity SELECT * FROM City LIMIT 50");
/* insert をコミットします */
$mysqli->commit();
/* すべての行を削除します */
$mysqli->query("DELETE FROM myCity");
if ($result = $mysqli->query("SELECT COUNT(*) FROM myCity")) {
$row = $result->fetch_row();
printf("%d rows in table myCity.\n", $row[0]);
/* 結果を開放します */
$result->close();
}
/* ロールバックします */
$mysqli->rollback();
if ($result = $mysqli->query("SELECT COUNT(*) FROM myCity")) {
$row = $result->fetch_row();
printf("%d rows in table myCity (after rollback).\n", $row[0]);
/* 結果を開放します */
$result->close();
}
/* myCity テーブルを削除します */
$mysqli->query("DROP TABLE myCity");
$mysqli->close();
?>`

手続き型

`<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
/* 自動コミットを無効にします */
mysqli_autocommit($link, FALSE);
mysqli_query($link, "CREATE TABLE myCity LIKE City");
mysqli_query($link, "ALTER TABLE myCity Type=InnoDB");
mysqli_query($link, "INSERT INTO myCity SELECT * FROM City LIMIT 50");
/* insert をコミットします */
mysqli_commit($link);
/* すべての行を削除します */
mysqli_query($link, "DELETE FROM myCity");
if ($result = mysqli_query($link, "SELECT COUNT(*) FROM myCity")) {
$row = mysqli_fetch_row($result);
printf("%d rows in table myCity.\n", $row[0]);
/* 結果を開放します */
mysqli_free_result($result);
}
/* ロールバックします */
mysqli_rollback($link);
if ($result = mysqli_query($link, "SELECT COUNT(*) FROM myCity")) {
$row = mysqli_fetch_row($result);
printf("%d rows in table myCity (after rollback).\n", $row[0]);
/* 結果を開放します */
mysqli_free_result($result);
}
/* myCity テーブルを削除します */
mysqli_query($link, "DROP TABLE myCity");
mysqli_close($link);
?>`

上の例の出力は以下となります。

    0 rows in table myCity.
    50 rows in table myCity (after rollback).

### 参考

- mysqli_begin_transaction() - トランザクションを開始する
- mysqli_commit() - 現在のトランザクションをコミットする
- mysqli_autocommit() - データベース更新の自動コミットをオンまたはオフにする
- mysqli_release_savepoint() - 現在のトランザクションのセーブポイント群から、指定した名前のセーブポイントを削除する