mysqli::begin_transaction

    mysqli_begin_transaction

    (PHP 5 >= 5.5.0, PHP 7, PHP 8)

    mysqli::begin_transaction -- mysqli_begin_transaction — トランザクションを開始する

    説明

    オブジェクト指向型

    publicmysqli::begin_transaction(int$flags = 0, ?string$name = null): bool

    手続き型:

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

    トランザクションを開始します。InnoDB エンジン (デフォルトで有効になっています) が必要です。 MySQL のトランザクションの詳細な動作は、 » http://dev.mysql.com/doc/mysql/en/commit.html を参照ください。

    パラメータ

    link

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

    flags

    以下のフラグが使えます。

    • MYSQLI_TRANS_START_READ_ONLY: "START TRANSACTION READ ONLY" でトランザクションを開始します。 MySQL 5.6 以上が必要です。

    • MYSQLI_TRANS_START_READ_WRITE: "START TRANSACTION READ WRITE" でトランザクションを開始します。 MySQL 5.6 以上が必要です。

    • MYSQLI_TRANS_START_WITH_CONSISTENT_SNAPSHOT: "START TRANSACTION WITH CONSISTENT SNAPSHOT" でトランザクションを開始します。

    name

    トランザクションのセーブポイント名。

    戻り値

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

    変更履歴

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

    例

    例1 mysqli::begin_transaction() の例

    オブジェクト指向型

    <?php


    mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");


    $mysqli->query("CREATE TABLE IF NOT EXISTS language (
    Code text NOT NULL,
    Speakers int(11) NOT NULL
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;"    );


    $mysqli->begin_transaction();

    try {

    $mysqli->query("INSERT INTO language(Code, Speakers) VALUES ('DE', 42000123)");


    $language_code = 'FR';
    $native_speakers = 'Unknown';
    $stmt = $mysqli->prepare('INSERT INTO language(Code, Speakers) VALUES (?,?)');
    $stmt->bind_param('ss', $language_code, $native_speakers);
    $stmt->execute();


    $mysqli->commit();
    } catch (    mysqli_sql_exception $exception) {
    $mysqli->rollback();

    throw     $exception;
    }

    手続き型

    <?php


    mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

    $mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");


    mysqli_query($mysqli, "CREATE TABLE IF NOT EXISTS language (
    Code text NOT NULL,
    Speakers int(11) NOT NULL
    ) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;"    );


    mysqli_begin_transaction($mysqli);

    try {

    mysqli_query($mysqli, "INSERT INTO language(Code, Speakers) VALUES ('DE', 42000123)");


    $language_code = 'FR';
    $native_speakers = 'Unknown';
    $stmt = mysqli_prepare($mysqli, 'INSERT INTO language(Code, Speakers) VALUES (?,?)');
    mysqli_stmt_bind_param($stmt, 'ss', $language_code, $native_speakers);
    mysqli_stmt_execute($stmt);


    mysqli_commit($mysqli);
    } catch (    mysqli_sql_exception $exception) {
    mysqli_rollback($mysqli);

    throw     $exception;
    }
    ?>

    注意

    注意:

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

    参考

    To Top