(PHP 5 >= 5.5.0, PHP 7, PHP 8)
mysqli::begin_transaction -- mysqli_begin_transaction — Démarre une transaction
Style orienté objet
$flags = 0, ?string $name = null): boolStyle procédural:
Commence une transaction. Nécessite le moteur InnoDB (il est actif par défaut). Pour plus de détails sur le fonctionnement des transactions MySQL, voir » http://dev.mysql.com/doc/mysql/en/commit.html.
mysqlSeulement en style procédural : Un objet mysqli retourné par la fonction mysqli_connect() ou par la fonction mysqli_init().
flagsLes drapeaux valides sont :
MYSQLI_TRANS_START_READ_ONLY :
Commence la transaction comme "START TRANSACTION READ ONLY".
Nécessite MySQL 5.6 ou supérieur.
MYSQLI_TRANS_START_READ_WRITE :
Commence la transaction comme "START TRANSACTION READ WRITE".
Nécessite MySQL 5.6 et supérieur.
MYSQLI_TRANS_START_WITH_CONSISTENT_SNAPSHOT :
Commence la transaction comme "START TRANSACTION WITH CONSISTENT SNAPSHOT".
nameNom du point de sauvegarde pour la transaction.
Cette fonction retourne true en cas de succès ou false si une erreur survient.
| Version | Description |
|---|---|
| 8.0.0 |
name est désormais nullable.
|
Exemple #1 Exemple avec mysqli::begin_transaction()
Style orienté objet
<?php
/* Demande à mysqli de lancer une exception si une erreur survient */
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Le moteur de table supporte les transactions */
$mysqli->query("CREATE TABLE IF NOT EXISTS language (
Code text NOT NULL,
Speakers int(11) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;");
/* Démarre la transaction */
$mysqli->begin_transaction();
try {
/* Insère plusieurs valeurs */
$mysqli->query("INSERT INTO language(Code, Speakers) VALUES ('DE', 42000123)");
/* Tente d'insérer de mauvaises valeurs */
$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();
/* Si le code arrive à ce point sans erreur, alors on commit les données dans
la base de données */
$mysqli->commit();
} catch (mysqli_sql_exception $exception) {
$mysqli->rollback();
throw $exception;
}
Style procédural
<?php
/* Demande à mysqli de lancer une exception si une erreur survient */
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Le moteur de table supporte les transactions */
mysqli_query($mysqli, "CREATE TABLE IF NOT EXISTS language (
Code text NOT NULL,
Speakers int(11) NOT NULL
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;");
/* Commence la transaction */
mysqli_begin_transaction($mysqli);
try {
/* Insère plusieurs valeurs */
mysqli_query($mysqli, "INSERT INTO language(Code, Speakers) VALUES ('DE', 42000123)");
/* Tente d'insérer de mauvaises valeurs */
$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);
/* Si le code arrive à ce point sans erreur, alors on commit les données dans
la base de données */
mysqli_commit($mysqli);
} catch (mysqli_sql_exception $exception) {
mysqli_rollback($mysqli);
throw $exception;
}
Note:
Cette fonction ne fonctionne pas avec les types de table non transactionnelle (comme MyISAM ou ISAM).