mysqli
Manuel PHP

mysqli::rollback

mysqli_rollback

(PHP 5)

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

Description

Style orienté objet

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

Style procédural

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

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

<?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();
?>
<?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
Manuel PHP
LoadingChargement en cours