Iniciar, confirmar y deshacer transacciones (beginTransaction, commit, rollBack)
En el contexto de bases de datos, las transacciones permiten ejecutar un conjunto de operaciones SQL como una sola unidad atómica. Esto significa que todas las operaciones dentro de la transacción se completan exitosamente o ninguna tiene efecto, garantizando así la integridad de los datos.
Para manejar transacciones en PHP utilizando PDO, se emplean los métodos beginTransaction, commit y rollBack. A continuación, se muestra cómo iniciar una transacción:
<?php
$dsn = 'mysql:host=localhost;dbname=mi_base_datos;charset=utf8mb4';
$usuario = 'mi_usuario';
$contraseña = 'mi_contraseña';
try {
$pdo = new PDO($dsn, $usuario, $contraseña);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// Iniciar la transacción
$pdo->beginTransaction();
// Primera operación SQL
$pdo->exec("INSERT INTO clientes (nombre, email) VALUES ('Ana', 'ana@example.com')");
// Segunda operación SQL
$pdo->exec("INSERT INTO pedidos (cliente_id, total) VALUES (LAST_INSERT_ID(), 250)");
// Confirmar la transacción
$pdo->commit();
echo "Transacción realizada con éxito.\n";
} catch (Exception $e) {
// Deshacer la transacción en caso de error
$pdo->rollBack();
echo "Error en la transacción: " . $e->getMessage() . "\n";
}
En este ejemplo, se inicia una transacción con $pdo->beginTransaction(). Se ejecutan dos operaciones SQL: insertar un nuevo cliente y crear un pedido asociado. Si ambas operaciones se completan sin errores, se confirma la transacción con $pdo->commit(). En caso de producirse una excepción, se deshace la transacción utilizando $pdo->rollBack(), lo que revierte todos los cambios realizados desde el inicio de la transacción.
Es esencial configurar el modo de error de PDO para que lance excepciones:
<?php
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
Al lanzar excepciones, se puede capturar cualquier error en el bloque catch y manejarlo adecuadamente. Esto asegura que los errores no pasen desapercibidos y que la transacción se deshaga si algo falla.
Además, es posible verificar si una transacción está en curso mediante el método $pdo->inTransaction():
<?php
if ($pdo->inTransaction()) {
echo "Ya hay una transacción activa.\n";
} else {
$pdo->beginTransaction();
}
Este chequeo es útil para evitar iniciar una nueva transacción cuando ya existe una activa, lo que podría generar conflictos.
Algunos puntos importantes a considerar al trabajar con transacciones:
- Atomicidad: Las transacciones garantizan que un conjunto de operaciones se ejecuten como una sola acción indivisible.
- Consistencia: Las transacciones mantienen la base de datos en un estado válido, cumpliendo todas las reglas definidas (como claves foráneas y restricciones).
- Aislamiento: Las operaciones dentro de una transacción son aisladas de otras transacciones concurrentes.
- Durabilidad: Una vez confirmada, los cambios realizados por una transacción persisten incluso ante fallos del sistema.
Es recomendable utilizar transacciones en operaciones críticas que involucren múltiples pasos dependientes entre sí. De esta manera, se evitan situaciones donde solo se completa parcialmente una operación, lo que podría causar inconsistencias en la base de datos.
Finalmente, siempre asegúrate de manejar adecuadamente las excepciones y de liberar recursos. Esto incluye cerrar conexiones y deshacer transacciones cuando sea necesario para mantener la estabilidad de la aplicación.
Manejo de errores en transacciones para asegurar la consistencia de datos
El manejo adecuado de errores durante las transacciones es crucial para mantener la consistencia de los datos en la base de datos. Una transacción mal gestionada puede dejar la base de datos en un estado incoherente, por lo que es esencial implementar mecanismos que aseguren su correcta ejecución o revertir los cambios en caso de fallo.
Al trabajar con PDO en PHP, se recomienda utilizar bloques try-catch para capturar excepciones y manejar errores de manera eficaz. A continuación se presenta un ejemplo de cómo gestionar errores en transacciones:
<?php
$dsn = 'mysql:host=localhost;dbname=mi_base_datos;charset=utf8mb4';
$usuario = 'mi_usuario';
$contraseña = 'mi_contraseña';
try {
$pdo = new PDO($dsn, $usuario, $contraseña, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
$pdo->beginTransaction();
// Primera operación: insertar cliente
$stmtCliente = $pdo->prepare("INSERT INTO clientes (nombre, email) VALUES (:nombre, :email)");
$stmtCliente->execute([
':nombre' => 'Laura',
':email' => 'laura@example.com',
]);
// Obtener el ID del cliente insertado
$clienteId = $pdo->lastInsertId();
// Segunda operación: insertar pedido asociado al cliente
$stmtPedido = $pdo->prepare("INSERT INTO pedidos (cliente_id, total) VALUES (:cliente_id, :total)");
$stmtPedido->execute([
':cliente_id' => $clienteId,
':total' => 150,
]);
$pdo->commit();
echo "Transacción completada con éxito.\n";
} catch (PDOException $e) {
$pdo->rollBack();
echo "Error en la transacción: " . $e->getMessage() . "\n";
}
En este ejemplo, se inicia una transacción y se ejecutan dos operaciones que dependen entre sí: la inserción de un nuevo cliente y la creación de un pedido para ese cliente. Si ocurre algún error en cualquiera de las operaciones, se lanza una excepción PDOException, se revierte la transacción con $pdo->rollBack(), y se informa del error.
Es importante destacar que se establece el atributo PDO::ATTR_ERRMODE a PDO::ERRMODE_EXCEPTION al crear la instancia de PDO. Esto garantiza que los errores generen excepciones y puedan ser capturados en el bloque catch.
Además, es buena práctica capturar excepciones genéricas Exception para manejar errores inesperados:
<?php
try {
// Código de la transacción
} catch (PDOException $e) {
$pdo->rollBack();
echo "Error de base de datos: " . $e->getMessage() . "\n";
} catch (Exception $e) {
$pdo->rollBack();
echo "Error inesperado: " . $e->getMessage() . "\n";
}
Al manejar diferentes tipos de excepciones, se puede proporcionar información más detallada sobre el error ocurrido.
Validaciones previas a la ejecución de las operaciones también son fundamentales. Antes de realizar una operación, se debe comprobar que los datos son válidos y cumplen con las restricciones de la base de datos:
<?php
if (empty($nombre) || empty($email)) {
throw new Exception("El nombre y el email son obligatorios.\n");
}
Si las validaciones fallan, es preferible lanzar una excepción antes de iniciar la transacción, evitando así operaciones innecesarias.
En entornos con múltiples transacciones simultáneas, pueden ocurrir deadlocks o bloqueos. Para manejarlos, se puede implementar una lógica de reintento:
<?php
$intentos = 0;
$maxIntentos = 3;
$exito = false;
do {
try {
$pdo->beginTransaction();
// Operaciones de la transacción
$pdo->commit();
$exito = true;
echo "Transacción realizada correctamente.\n";
} catch (PDOException $e) {
$pdo->rollBack();
if ($e->errorInfo[1] == 1213) { // Código de error de deadlock en MySQL
$intentos++;
echo "Deadlock detectado, reintentando ($intentos/$maxIntentos).\n";
usleep(100000); // Esperar 100 ms antes de reintentar
} else {
throw $e;
}
}
} while (!$exito && $intentos < $maxIntentos);
Esta estrategia permite reintentar la transacción en caso de deadlock hasta un número máximo de intentos, mejorando la robustez de la aplicación.
Otro aspecto a considerar es el nivel de aislamiento de las transacciones, que determina cómo una transacción es afectada por otras transacciones concurrentes. Se puede establecer el nivel de aislamiento adecuado mediante una consulta SQL:
<?php
$pdo->exec("SET TRANSACTION ISOLATION LEVEL REPEATABLE READ");
El uso del nivel de aislamiento correcto ayuda a prevenir problemas como lecturas sucias o no repetibles, fortaleciendo la consistencia de los datos.
Registrar los errores en un log permite su posterior análisis. Esto se puede hacer utilizando funciones de registro o librerías específicas:
<?php
function registrarError($mensaje)
{
error_log(date('[Y-m-d H:i:s] ') . $mensaje . "\n", 3, 'errores.log');
}
try {
// Código de la transacción
} catch (Exception $e) {
$pdo->rollBack();
registrarError($e->getMessage());
echo "Ha ocurrido un error. Consulte el log para más detalles.\n";
}
Registrar los errores permite identificar patrones y solucionar problemas recurrentes, mejorando la fiabilidad de la aplicación.
Alan Sastre
Ingeniero de Software y formador, CEO en CertiDevs
Ingeniero de software especializado en Full Stack y en Inteligencia Artificial. Como CEO de CertiDevs, PHP es una de sus áreas de expertise. Con más de 15 años programando, 6K seguidores en LinkedIn y experiencia como formador, Alan se dedica a crear contenido educativo de calidad para desarrolladores de todos los niveles.
Más tutoriales de PHP
Explora más contenido relacionado con PHP y continúa aprendiendo con nuestros tutoriales gratuitos.
Aprendizajes de esta lección
- Comprender y aplicar el concepto de transacciones en bases de datos.
- Utilizar los métodos
beginTransaction,commityrollBackde PDO en PHP. - Manejar errores en transacciones para mantener la consistencia de los datos.
- Establecer y verificar el modo de error de PDO con excepciones.
- Implementar verificaciones de transacciones activas y gestionar
deadlocks.