PDO::beginTransaction
(PHP 5 >= 5.1.0, PECL pdo >= 0.1.0)
PDO::beginTransaction — Démarre une transaction
Description
PDO::beginTransaction() désactive le mode autocommit. Lorsque l'autocommit est désactivé, les modifications faites sur la base de données via les instances des objets PDO ne sont pas appliquées tant que vous ne mettez pas fin à la transaction en appelant la fonction PDO::commit(). L'appel de PDO::rollBack() annulera toutes les modifications faites à la base de données et remettra la connexion en mode autocommit.
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 ou FALSE
si une erreur survient.
Exemples
Exemple #1 Annule une transaction
<?php /* Démarre une transaction, désactivation de l'auto-commit */ $dbh->beginTransaction(); /* Modification du schéma de la base 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(); /* Le connexion à la base de données est maintenant de retour en mode auto-commit */ ?>
Voir aussi
- PDO::commit() - Valide une transaction
- PDO::rollBack() - Annule une transaction
- Transactions et auto-commit