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).

参考