sqlsrv_begin_transaction

(No version information available, might only be in Git)

sqlsrv_begin_transactionInicia una transacción de base de datos

Descripción

sqlsrv_begin_transaction ( resource $conn ) : bool

La transacción iniciada por sqlsrv_begin_transaction() incluye todas las sentencias que fueron ejecutadas después de la llamada a sqlsrv_begin_transaction() y antes de llamar a sqlsrv_rollback() o sqlsrv_commit(). Las transacciones explícitas deben empezar y ser consolidadas (commit) o revertidas utilizando estas funciones en vez de ejecutar sentencias SQL que empiecen y consoliden/reviertan transacciones. Para más información, ver » SQLSRV Transactions.

Parámetros

conn

El recurso de la conexión devuelta por una llamada a sqlsrv_connect().

Valores devueltos

Devuelve TRUE en caso de éxito o FALSE en caso de error.

Ejemplos

Ejemplo #1 Ejemplo de sqlsrv_begin_transaction()

El siguiente ejemplo demuestra cómo utilizar sqlsrv_begin_transaction() junto con sqlsrv_commit() y sqlsrv_rollback().

<?php
$serverName 
"serverName\sqlexpress";
$connectionInfo = array( "Database"=>"dbName""UID"=>"userName""PWD"=>"password");
$conn sqlsrv_connect$serverName$connectionInfo);
if( 
$conn === false ) {
    die( 
print_rsqlsrv_errors(), true ));
}

/* Iniciar la transacción. */
if ( sqlsrv_begin_transaction$conn ) === false ) {
     die( 
print_rsqlsrv_errors(), true ));
}

/* Inicializar los parámetros. */
$orderId 1$qty 10$productId 100;

/* Preprar y ejecutar la primera sentencia . */
$sql1 "INSERT INTO OrdersTable (ID, Quantity, ProductID)
          VALUES (?, ?, ?)"
;
$params1 = array( $orderId$qty$productId );
$stmt1 sqlsrv_query$conn$sql1$params1 );

/* Preparar y ejecutar la segunda sentencia. */
$sql2 "UPDATE InventoryTable 
          SET Quantity = (Quantity - ?) 
          WHERE ProductID = ?"
;
$params2 = array($qty$productId);
$stmt2 sqlsrv_query$conn$sql2$params2 );

/* Si ambas sentencias finalizaran con éxito, consolidar la transacción. */
/* En caso contrario, revertirla. */
if( $stmt1 && $stmt2 ) {
     
sqlsrv_commit$conn );
     echo 
"Transaccion consolidada.<br />";
} else {
     
sqlsrv_rollback$conn );
     echo 
"Transaccion revertida.<br />";
}
?>

El resultado del ejemplo sería algo similar a:

Ver también

  • sqlsrv_commit() - Consolida una transacción que se inició con sqlsrv_begin_transaction
  • sqlsrv_rollback() - Rolls back a transaction that was begun with sqlsrv_begin_transaction