Fonctions SQLSRV
PHP Manual

sqlsrv_begin_transaction

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

sqlsrv_begin_transaction — Commence une transaction

Description

bool sqlsrv_begin_transaction ( resource $conn )

La transaction commençant avec la fonction sqlsrv_begin_transaction() inclut toutes les requêtes qui sont exécutées après l'appel à la fonction sqlsrv_begin_transaction() et avant l'appel à la fonction sqlsrv_rollback() ou la fonction sqlsrv_commit(). Une transaction explicite peut être commencée et validée (ou annulée) en utilisant ces fonctions au lieu d'exécuter les requêtes SQL qui commencent et valident/annulent les transactions. Pour plus d'informations, reportez-vous aux » transactions SQLSRV.

Liste de paramètres

conn

La ressource de connexion retournée par un appel à la fonction sqlsrv_connect().

Valeurs de retour

Cette fonction retourne TRUE en cas de succès ou FALSE si une erreur survient.

Exemples

Exemple #1 Exemple avec sqlsrv_begin_transaction()

L'exemple suivant montre la façon d'utiliser la fonction sqlsrv_begin_transaction() avec les fonctions sqlsrv_commit() et 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 ));
}

/* Commence la transaction. */
if ( sqlsrv_begin_transaction( $conn ) === false ) {
     die( 
print_r( sqlsrv_errors(), true ));
}

/* Initialise les valeurs des paramètres. */
$orderId = 1; $qty = 10; $productId = 100;

/* Exécute la première requête. */
$sql1 = "INSERT INTO OrdersTable (ID, Quantity, ProductID)
          VALUES (?, ?, ?)"
;
$params1 = array( $orderId, $qty, $productId );
$stmt1 = sqlsrv_query( $conn, $sql1, $params1 );

/* Exécute la seconde requête. */
$sql2 = "UPDATE InventoryTable 
          SET Quantity = (Quantity - ?) 
          WHERE ProductID = ?"
;
$params2 = array($qty, $productId);
$stmt2 = sqlsrv_query( $conn, $sql2, $params2 );

/* Si les deux requêtes sont exécutées avec succès, on valide la transaction. */
/* Sinon, on annule la transaction. */
if( $stmt1 && $stmt2 ) {
     
sqlsrv_commit( $conn );
     echo 
"Transaction validée.<br />";
} else {
     
sqlsrv_rollback( $conn );
     echo 
"Transaction annulée.<br />";
}
?>

L'exemple ci-dessus va afficher quelque chose de similaire à :

Voir aussi


Fonctions SQLSRV
PHP Manual