Annule la transaction courante

# mysqli::rollback

# mysqli_rollback

(PHP 5, PHP 7)

mysqli::rollback -- mysqli_rollback — Annule la transaction courante

### Description

Style orienté objet

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

Style procédural

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

Annule la transaction courante pour la base de données.

### Liste de paramètres

`link`

  Seulement en style procédural : Un identifiant de lien retourné par la fonction mysqli_connect() ou par la fonction mysqli_init()

`flags`

  Un masque de constantes `MYSQLI_TRANS_COR_*`.

`name`

  Si fourni, alors ROLLBACK/*name*/ est exécuté.

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès ou `FALSE` si une erreur survient.

### Historique

Version | Description
--- | ---
5.5.0 | Ajout des paramètres `flags` et `name`.

### Exemples

Exemple #1 Exemple avec mysqli::rollback()

Style orienté objet

`<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
/* Désactive l'auto-commit */
$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");
/* Validation */
$mysqli->commit();
/* Effacement de toutes les lignes */
$mysqli->query("DELETE FROM myCity");
if ($result = $mysqli->query("SELECT COUNT(*) FROM myCity")) {
$row = $result->fetch_row();
printf("%d ligne dans la table myCity.\n", $row[0]);
/* Free result */
$result->close();
}
/* Rollback */
$mysqli->rollback();
if ($result = $mysqli->query("SELECT COUNT(*) FROM myCity")) {
$row = $result->fetch_row();
printf("%d lignes dans la table myCity (après annulation).\n", $row[0]);
/* Libère le résultat */
$result->close();
}
/* Effacement de la table myCity */
$mysqli->query("DROP TABLE myCity");
$mysqli->close();
?>`

Style procédural

`<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Vérification de la connexion */
if (mysqli_connect_errno()) {
printf("Échec de la connexion : %s\n", mysqli_connect_error());
exit();
}
/* Désactive l'auto-commit */
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");
/* Validation */
mysqli_commit($link);
/* Effacement de toutes les lignes */
mysqli_query($link, "DELETE FROM myCity");
if ($result = mysqli_query($link, "SELECT COUNT(*) FROM myCity")) {
$row = mysqli_fetch_row($result);
printf("%d ligne dans la table myCity.\n", $row[0]);
/* Libère le résultat */
mysqli_free_result($result);
}
/* Rollback */
mysqli_rollback($link);
if ($result = mysqli_query($link, "SELECT COUNT(*) FROM myCity")) {
$row = mysqli_fetch_row($result);
printf("%d lignes dans la table myCity (après annulation).\n", $row[0]);
/* Free result */
mysqli_free_result($result);
}
/* Effacement de la table myCity */
mysqli_query($link, "DROP TABLE myCity");
mysqli_close($link);
?>`

Les exemples ci-dessus vont afficher :

    0 ligne dans la table myCity.
    50 lignes dans la table myCity (après annulation).

### Voir aussi

- mysqli_begin_transaction() - Démarre une transaction
- mysqli_commit() - Valide la transaction courante
- mysqli_autocommit() - Active ou désactive le mode auto-commit
- mysqli_release_savepoint() - Supprime le point de sauvegardé nommé du jeu des points de sauvegarde de la transaction courante