array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'pdo.begintransaction.php', 1 => 'PDO::beginTransaction', 2 => 'Inicia una transacción', ), 'up' => array ( 0 => 'class.pdo.php', 1 => 'PDO', ), 'prev' => array ( 0 => 'class.pdo.php', 1 => 'PDO', ), 'next' => array ( 0 => 'pdo.commit.php', 1 => 'PDO::commit', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/pdo/pdo/begintransaction.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PDO::beginTransaction

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

PDO::beginTransaction — Inicia una transacción

Descripción

public PDO::beginTransaction(): bool

Desactiva el modo autocommit. Mientras el autocommit está desactivado, las modificaciones realizadas en la base de datos mediante las instancias de los objetos PDO no se aplican hasta que se finaliza la transacción llamando a la función PDO::commit(). La llamada a PDO::rollBack() anulará todas las modificaciones realizadas en la base de datos y restablecerá la conexión en modo autocommit.

Algunas bases de datos, incluyendo MySQL, ejecutarán automáticamente un COMMIT cuando se ejecute una consulta de definición de lenguaje de base de datos (DDL) como DROP TABLE o CREATE TABLE dentro de una transacción. Este COMMIT implícito impedirá anular otras modificaciones realizadas en esta transacción.

Parámetros

Esta función no contiene ningún parámetro.

Valores devueltos

Esta función retorna true en caso de éxito o false si ocurre un error.

Errores/Excepciones

Se lanza la excepción PDOException si ya se ha iniciado una transacción o si el controlador no soporta transacciones.

Nota: Una excepción será emitida incluso si el atributo PDO::ATTR_ERRMODE no vale PDO::ERRMODE_EXCEPTION.

Ejemplos

Ejemplo #1 Anular una transacción

El siguiente ejemplo inicia una transacción y ejecuta dos consultas que modifican la base de datos antes de anular las modificaciones. En MySQL, sin embargo, la consulta DROP TABLE validará automáticamente la transacción, por lo que ninguna de las modificaciones de la transacción será anulada.

<?php
/* Inicia una transacción, desactivando el auto-commit */
$dbh->beginTransaction();

/* Modificación del esquema de la base de datos y de los datos */
$sth = $dbh->exec("DROP TABLE fruit");
$sth = $dbh->exec("UPDATE dessert
SET name = 'hamburger'");

/* Se detecta un error y se anulan las modificaciones */
$dbh->rollBack();

/* La conexión a la base de datos está ahora de vuelta en modo auto-commit */
?>

Ver también