sqlsrv_begin_transaction

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

sqlsrv_begin_transaction — Inicia uma transação de banco de dados

Descrição

sqlsrv_begin_transaction(resource $conn): bool

A transação iniciada por sqlsrv_begin_transaction() inclui todas as instruções que foram executadas após a chamada para sqlsrv_begin_transaction() e antes das chamadas para sqlsrv_rollback() ou sqlsrv_commit(). Transações explícitas devem ser iniciadas e confirmadas ou revertidas usando essas funções em vez de executar instruções SQL que iniciam e confirmam/revertem transações. Para mais informações, consulte » Transações SQLSRV.

Parâmetros

conn: O recurso de conexão retornado por uma chamada para sqlsrv_connect().

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Exemplos

Example #1 Exemplo de sqlsrv_begin_transaction()

O seguinte exemplo demonstra como usar sqlsrv_begin_transaction() junto com sqlsrv_commit() e sqlsrv_rollback().

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

/* Inicia a transação. */
if ( sqlsrv_begin_transaction( $conn ) === false ) {
     die( print_r( sqlsrv_errors(), true ));
}

/* Inicializa os valores dos parâmetros. */
$orderId = 1; $qty = 10; $productId = 100;

/* Configura e executa a primeira consulta. */
$sql1 = "INSERT INTO OrdersTable (ID, Quantity, ProductID)
          VALUES (?, ?, ?)";
$params1 = array( $orderId, $qty, $productId );
$stmt1 = sqlsrv_query( $conn, $sql1, $params1 );

/* Configura e executa a segunda consulta. */
$sql2 = "UPDATE InventoryTable
          SET Quantity = (Quantity - ?)
          WHERE ProductID = ?";
$params2 = array($qty, $productId);
$stmt2 = sqlsrv_query( $conn, $sql2, $params2 );

/* Se ambas as consultas forem bem-sucedidas, confirma a transação. */
/* Caso contrário, reverte a transação. */
if( $stmt1 && $stmt2 ) {
     sqlsrv_commit( $conn );
     echo "Transaction committed.<br />";
} else {
     sqlsrv_rollback( $conn );
     echo "Transaction rolled back.<br />";
}
?>

O exemplo acima produzirá algo semelhante a:

Veja Também

sqlsrv_commit() - Confirma uma transação que foi iniciada com sqlsrv_begin_transaction
sqlsrv_rollback() - Reverte uma transação que foi iniciada com sqlsrv_begin_transaction