sqlsrv_free_stmt

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

sqlsrv_free_stmt — Libère toutes les ressources de la requête spécifiée

Description

function sqlsrv_free_stmt(resource $stmt): bool

Libère toutes les ressources pour la requête spécifiée. La requête ne pourra plus être utilisée après le passage à la fonction sqlsrv_free_stmt(). Si la requête sqlsrv_free_stmt() est appelée alors que la requête est en cours d'exécution, l'exécution de la requête est interrompue, et la requête est annulée.

Liste de paramètres

stmt: La requête dont les ressources seront libérées. Il est à noter que null est une valeur de paramètre valide. Cette valeur permet à la fonction d'être appelée à plusieurs reprises dans un script.

Valeurs de retour

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

Exemples

Exemple #1 Exemple avec sqlsrv_free_stmt()

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

$stmt = sqlsrv_query( $conn, "SELECT * FROM Table_1");
if( $stmt === false ) {
     die( print_r( sqlsrv_errors(), true));
}

/*-------------------------------
     Exploitation de la requête ici.
-------------------------------*/

/* Libération des ressources associées à la requête. */
sqlsrv_free_stmt( $stmt);

?>

Notes

La principale différence entre la fonction sqlsrv_free_stmt() et la fonction sqlsrv_cancel() est qu'une ressource de requête annulée avec la fonction sqlsrv_cancel() peut être ré-exécutée si elle a été créée avec la fonction sqlsrv_prepare(). Une ressource de requête annulée avec la fonction sqlsrv_free_statement() ne peut plus être ré-exécutée.

Voir aussi

sqlsrv_cancel() - Annule une requête

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

Anonymous ¶

11 years ago

If you accidentally call this with an invalid $stmt resource, you may see unexpected fatal errors.

I had left behind a call here when cleaning up some code and this caused the my IIS server to generate an error 500 resource not found error.  Furthermore it seemed to only affect some users and not all and I could not isolate why only selected users got the error when it was called for all users.

＋add a note