PDO::rollBack

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

    PDO::rollBack — Annule une transaction

    Description

    publicPDO::rollBack(): bool

    Annule la transaction courante, initiée par la fonction PDO::beginTransaction().

    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.

    Liste de paramètres

    Cette fonction ne contient aucun paramètre.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    Erreurs / Exceptions

    Une exception PDOException sera lancée si aucune transaction n'est active.

    Note: Une exception sera émise même si l'attribut PDO::ATTR_ERRMODE ne vaut pas PDO::ERRMODE_EXCEPTION.

    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

    $dbh->beginTransaction();


    $sth = $dbh->exec("DROP TABLE fruit");
    $sth = $dbh->exec("UPDATE dessert
    SET name = 'hamburger'"    );


    $dbh->rollBack();


    ?>

    Voir aussi

    To Top