sqlsrv_rollback
在指定的連接上復原目前交易，並使連接回到自動認可模式。 目前交易包含在指定的連接上呼叫 sqlsrv_begin_transaction 之後和呼叫 sqlsrv_rollback 或 sqlsrv_commit之前執行的所有陳述式。
注意
Microsoft Drivers for PHP for SQL Server 預設為自動認可模式。 這表示所有查詢都會在成功時自動進行認可，除非已使用 sqlsrv_begin_transaction開始交易。
注意
如果在不屬於使用中交易 (以 sqlsrv_begin_transaction 起始) 的連線上呼叫 sqlsrv_rollback，則呼叫會傳回 false，且「不在交易中」錯誤會新增至錯誤集合。
語法
sqlsrv_rollback( resource $conn)
參數
$conn：交易所用的連接。
傳回值
布林值：如果交易已成功復原，則傳回 true 。 否則為 false。
範例
以下範例會在交易期間執行兩個查詢。 如果這兩個查詢都成功，就會認可交易。 如果其中一個 (或兩個) 查詢失敗，則會復原交易。
範例中的第一個查詢會將新的銷售訂單插入到 AdventureWorks 資料庫的 Sales.SalesOrderDetail 資料表中。 此訂單適用於具有產品識別碼 709 的五個產品單位。 第二個查詢可減少產品識別碼 709 的存貨數量 (五個單位)。 這些查詢會包含在交易中，因為對資料庫而言，這兩個查詢都必須成功，才能正確地反映訂單狀態和產品可用性。
此範例假設本機電腦上已安裝 SQL Server 和 AdventureWorks 資料庫。 從命令列執行範例時，所有輸出都會寫入至主控台。
<?php
/* Connect to the local server using Windows Authentication and
specify the AdventureWorks database as the database in use. */
$serverName = "(local)";
$connectionInfo = array( "Database"=>"AdventureWorks");
$conn = sqlsrv_connect( $serverName, $connectionInfo);
if( $conn === false )
{
echo "Could not connect.\n";
die( print_r( sqlsrv_errors(), true ));
}
/* Initiate transaction. */
/* Exit script if transaction cannot be initiated. */
if ( sqlsrv_begin_transaction( $conn) === false )
{
echo "Could not begin transaction.\n";
die( print_r( sqlsrv_errors(), true ));
}
/* Initialize parameter values. */
$orderId = 43659; $qty = 5; $productId = 709;
$offerId = 1; $price = 5.70;
/* Set up and execute the first query. */
$tsql1 = "INSERT INTO Sales.SalesOrderDetail
(SalesOrderID,
OrderQty,
ProductID,
SpecialOfferID,
UnitPrice)
VALUES (?, ?, ?, ?, ?)";
$params1 = array( $orderId, $qty, $productId, $offerId, $price);
$stmt1 = sqlsrv_query( $conn, $tsql1, $params1 );
/* Set up and execute the second query. */
$tsql2 = "UPDATE Production.ProductInventory
SET Quantity = (Quantity - ?)
WHERE ProductID = ?";
$params2 = array($qty, $productId);
$stmt2 = sqlsrv_query( $conn, $tsql2, $params2 );
/* If both queries were successful, commit the transaction. */
/* Otherwise, rollback the transaction. */
if( $stmt1 && $stmt2 )
{
sqlsrv_commit( $conn );
echo "Transaction was committed.\n";
}
else
{
sqlsrv_rollback( $conn );
echo "Transaction was rolled back.\n";
}
/* Free statement and connection resources. */
sqlsrv_free_stmt( $stmt1);
sqlsrv_free_stmt( $stmt2);
sqlsrv_close( $conn);
?>
為了將焦點放在交易行為上，上述範例中並未包含一些建議的錯誤處理方式。 對於生產應用程式，建議檢查任何對 sqlsrv 函數的呼叫是否有錯誤並予以處理。
注意
請勿使用內嵌的 Transact-SQL 來執行交易。 例如，請勿執行以 "BEGIN TRANSACTION" 作為 Transact-SQL 查詢的陳述式，進而開始交易。 使用內嵌的 Transact-SQL 來執行交易時，無法保證預期的交易行為。