commit

En este artículo, nos centraremos en la función mysqli_commit() de PHP, que se utiliza para confirmar una transacción en MySQL. Te proporcionaremos una descripción general de la función, cómo funciona y ejemplos de su uso.

Introducción a la función mysqli_commit()

La función mysqli_commit() es una función procedimental integrada en PHP que confirma la transacción actual para una conexión a base de datos MySQL. Esto es útil cuando necesitas guardar permanentemente los cambios realizados en una tabla de base de datos, como actualizaciones o eliminaciones, dentro de un bloque de transacción. Ten en cuenta que el equivalente orientado a objetos es el método $mysqli->commit().

Cómo usar la función mysqli_commit()

Usar mysqli_commit() requiere una conexión MySQLi válida y una transacción que haya sido iniciada (normalmente desactivando el autocommit). Aquí tienes un ejemplo procedimental básico:

Uso básico de mysqli_commit()

<?php
$mysqli = mysqli_connect("localhost", "username", "password", "database");
if (!$mysqli) {
    echo "Failed to connect to MySQL: " . mysqli_connect_error();
    exit();
}

// Disable autocommit to start a transaction
mysqli_autocommit($mysqli, false);

// execute queries using the connection

// Commit the transaction
$result = mysqli_commit($mysqli);
if ($result) {
    echo "Transaction committed successfully.";
} else {
    echo "Transaction commit failed: " . mysqli_error($mysqli);
}

mysqli_close($mysqli);
?>

Parámetros y valor de retorno:

• $mysqli: El recurso de conexión MySQLi devuelto por mysqli_connect().
• $transaction (opcional): Un string que especifica el nombre de la transacción (compatible con MySQL 8.0+).
• Retorna: true en caso de éxito, false en caso de fallo.

Uso avanzado

La función mysqli_commit() puede gestionar nombres de transacciones y a menudo se combina con manejo de errores para garantizar la integridad de los datos. Si una confirmación falla, generalmente debes revertir la transacción. Aquí tienes un ejemplo que demuestra el manejo adecuado de errores y el parámetro de transacción opcional:

Uso avanzado de mysqli_commit()

<?php
$mysqli = mysqli_connect("localhost", "username", "password", "database");
if (!$mysqli) {
    echo "Failed to connect to MySQL: " . mysqli_connect_error();
    exit();
}

mysqli_autocommit($mysqli, false);

// execute queries using the connection

// Commit with an optional transaction name
$result = mysqli_commit($mysqli, "my_transaction");
if (!$result) {
    echo "Commit failed: " . mysqli_error($mysqli);
    // Roll back changes if commit fails
    mysqli_rollback($mysqli);
}

mysqli_close($mysqli);
?>

En este ejemplo, desactivamos el autocommit, ejecutamos consultas e intentamos confirmar usando un nombre de transacción específico. Si mysqli_commit() devuelve false, capturamos el error y llamamos a mysqli_rollback() para revertir los cambios, garantizando la consistencia de la base de datos.

Conclusión

En conclusión, mysqli_commit() es una función procedimental confiable para confirmar transacciones en MySQL dentro de scripts PHP. Al comprender sus parámetros, valores de retorno y el manejo adecuado de errores, puedes gestionar de forma segura los cambios en la base de datos. Recuerda que el equivalente orientado a objetos $mysqli->commit() se comporta de manera idéntica, pero se invoca como un método en un objeto MySQLi.

Práctica