sqlsrv_free_stmt

Libère toutes les ressources associées à l'instruction spécifiée. L'instruction ne peut pas être utilisée à nouveau une fois que cette fonction a été appelée.

Syntaxe

sqlsrv_free_stmt( resource $stmt)

Paramètres

$stmt : instruction à fermer.

Valeur de retour

Valeur booléenne true, à moins que la fonction ne soit appelée à l'aide d'un paramètre non valide. Si la fonction est appelée à l'aide d'un paramètre non valide, la valeur false est retournée.

Remarque :

Null est un paramètre valide pour cette fonction. Cela permet à la fonction d'être appelée à plusieurs reprises dans un script. Par exemple, si vous libérez une instruction dans une condition d'erreur et si vous la libérez à nouveau à la fin du script, le second appel à sqlsrv_free_stmt retourne true, car le premier appel à sqlsrv_free_stmt (dans la condition d'erreur) définit la ressource d'instruction à null.

Exemple

L'exemple suivant crée une ressource d'instruction, exécute une requête simple et appelle sqlsrv_free_stmt pour libérer toutes les ressources associées à l'instruction. L'exemple suppose que SQL Server et la base de données AdventureWorks sont installés sur l'ordinateur local. Toutes les données de sortie sont écrites dans la console lorsque l'exemple est exécuté à partir de la ligne de commande.

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

$stmt = sqlsrv_query( $conn, "SELECT * FROM Person.Contact");
if( $stmt )
{
     echo "Statement executed.\n";
}
else
{
     echo "Query could not be executed.\n";
     die( print_r( sqlsrv_errors(), true));
}

/*-------------------------------
     Process query results here.
-------------------------------*/

/* Free the statement and connection resources. */
sqlsrv_free_stmt( $stmt);
sqlsrv_close( $conn);
?>

Voir aussi

Référence

sqlsrv_cancel

Concepts

À propos des exemples de code dans la documentation

Autres ressources

Référence de l'API (Pilote SQL Server pour PHP)