sqlsrv_commit

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

sqlsrv_commit — Confirma uma transação que foi iniciada com sqlsrv_begin_transaction()

Descrição

sqlsrv_commit(resource $conn): bool

Confirma uma transação que foi iniciada com sqlsrv_begin_transaction(). A conexão é retornada ao modo de auto-commit após a chamada de sqlsrv_commit(). A transação que é confirmada inclui todas as declarações que foram executadas após a chamada para sqlsrv_begin_transaction(). Transações explícitas devem ser iniciadas e confirmadas ou revertidas usando essas funções em vez de executar declarações SQL que iniciam e confirmam/revertem transações. Para mais informações, consulte » Transações SQLSRV.

Parâmetros

conn

A conexão na qual a transação será confirmada.

Valor Retornado

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

Exemplos

Example #1 Exemplo de sqlsrv_commit()

O exemplo a seguir demonstra como usar sqlsrv_commit() juntamente com sqlsrv_begin_transaction() 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 />";
}
?>

Veja Também