PDO::rollBack

(no version information, might be only in CVS)

PDO::rollBack --  Annule une transaction

Description

bool PDO::rollBack ( void )

Avertissement

Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.

Lorsqu'utilisé sur une bases de données supportant les transactions, PDO::rollBack() annule tout travail en cours et remet la connexion en mode autocommit.

Vous devez appeler la fonction PDO::beginTransaction() pour remettre la connexion en mode commit manuel avant d'utiliser à nouveau PDO::rollBack(), sinon, la fonction ne produira aucun effet.

Exemples

Exemple 1. Annulation d'une transaction

<?php
/* Début d'une transaction, désactivation du mode autocommit */
$dbh->beginTransaction();

/* Modifie le schéma de la base de données ainsi que des données */
$sth = $dbh->exec("DROP TABLE fruit");
$sth = $dbh->exec("UPDATE dessert
    SET name = 'hamburger'"
);

/* On s'aperçoit d'une erreur et on annule les modifications */
$dbh->rollBack();

/* La connexion à la base de donnés revient en mode autocommit */
?>

Voir aussi

PDO::beginTransaction()
PDO::commit()