array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.sqlsrv-execute.php', 1 => 'sqlsrv_execute', 2 => 'Exécute une requête préparée avec la fonction sqlsrv_prepare', ), 'up' => array ( 0 => 'ref.sqlsrv.php', 1 => 'Fonctions SQLSRV', ), 'prev' => array ( 0 => 'function.sqlsrv-errors.php', 1 => 'sqlsrv_errors', ), 'next' => array ( 0 => 'function.sqlsrv-fetch.php', 1 => 'sqlsrv_fetch', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/sqlsrv/functions/sqlsrv-execute.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

sqlsrv_execute

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

sqlsrv_execute — Exécute une requête préparée avec la fonction sqlsrv_prepare()

Description

sqlsrv_execute(resource $stmt): bool

Exécute une requête préparée avec la fonction sqlsrv_prepare(). Cette fonction est idéale pour exécuter une requête préparée à plusieurs reprises avec des valeurs différentes pour les paramètres.

Liste de paramètres

stmt
Une ressource de requête retournée par la fonction sqlsrv_prepare().

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple avec sqlsrv_execute()

Cet exemple montre la façon pour préparer une requête avec la fonction sqlsrv_prepare() ainsi que l'exécution à plusieurs reprises (avec des valeurs différentes pour les paramètres) en utilisant la fonction sqlsrv_execute().

<?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));
}

$sql = "UPDATE Table_1
SET OrderQty = ?
WHERE SalesOrderID = ?";

// Initialise les paramètres et prépare la requête.
// Les variables $qty et $id sont liées à la requête, $stmt.
$qty = 0; $id = 0;
$stmt = sqlsrv_prepare( $conn, $sql, array( &$qty, &$id));
if( !$stmt ) {
die( print_r( sqlsrv_errors(), true));
}

// Définition des informations SalesOrderDetailID et OrderQty.
// Ce tableau lie l'ID order à la quantitié order dans une paire key=>value.
$orders = array( 1=>10, 2=>20, 3=>30);

// Exécute la requête pour chaque ordre.
foreach( $orders as $id => $qty) {
// En raison du que $id et $qty sont liés à $stmt1, leurs valeurs
// mise à jour sont utilisées lors de chaque exécution de la requête.
if( sqlsrv_execute( $stmt ) === false ) {
die( print_r( sqlsrv_errors(), true));
}
}
?>

Notes

Lorsque l'on prépare une requête qui utilise des variables comme paramètres, les variables sont liées à la requête. Cela signifie que si l'on met à jour les valeurs des variables, la prochaine exécution de la requête utilisera les valeurs mises à jour. Pour les requêtes que l'on ne prévoit d'utiliser qu'une seule fois, il est recommandé d'utiliser plutôt la fonction sqlsrv_query().

Voir aussi