PDO::quote
PDO::setAttribute
PDO
PHP Manual

# PDO::rollBack

(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)

PDO::rollBack — Annule une transaction

### Description

bool PDO::rollBack ( void )

Annule la transaction courante, initié par la fonction PDO::beginTransaction(). C'est une erreur que d'appeler cette méthode s'il n'y a aucune transaction active.

Si la base de données est en mode autocommit, cette fonction restaurera le mode autocommit après l'annulation de la transaction.

Quelques bases de données, dont MySQL, exécuteront automatiquement un COMMIT lorsqu'une requête de définition de langage de base de données (DDL) comme DROP TABLE ou CREATE TABLE est exécutée dans une transaction. Ce COMMIT implicite vous empêchera d'annuler toutes autres modifications faites dans cette transaction.

### Valeurs de retour

Cette fonction retourne `TRUE` en cas de succès, `FALSE` en cas d'échec.

### Exemples

Exemple #1 Annulation d'une transaction

L'exemple suivant commence une transaction et exécute deux requêtes qui modifient la base de données avant d'annuler les modifications. Sur MySQL, cependant, la requête DROP TABLE validera automatiquement la transaction, donc, aucune des modifications de la transaction ne sera annulée.

`<?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() - Démarre une transaction
- PDO::commit() - Valide une transaction

PDO::quote
PDO::setAttribute
PDO
PHP Manual