sqlsrv_close

  • Artikel

PHP-Treiber herunterladen

Schließt die angegebene Verbindung und gibt die zugeordneten Ressourcen frei.

Syntax

  
sqlsrv_close( resource $conn )

Parameter

$conn: Die Verbindung, die geschlossen werden soll.

Rückgabewert

Der boolesche Wert true , außer die Funktion wird mit einem ungültigen Parameter aufgerufen. Wenn die Funktion mit einem ungültigen Parameter aufgerufen wird, wird false zurückgegeben.

Hinweis

NULL ist ein gültiger Parameter für diese Funktion. Dadurch kann die Funktion mehrmals in einem Skript aufgerufen werden. Wenn Sie z.B. eine Verbindung in einem Fehlerzustand schließen und sie erneut am Ende des Skripts schließen, gibt der zweite Aufruf von sqlsrv_close den Wert TRUE zurück, da der erste Aufruf von sqlsrv_close (im Fehlerzustand) die Verbindungsressource auf NULL festlegt.

Beispiel

Im folgenden Beispiel wird eine Verbindung geschlossen. Das Beispiel setzt voraus, dass SQL Server auf dem lokalen Computer installiert ist. Wenn das Beispiel über die Befehlszeile ausgeführt wird, werden alle Ausgaben in die Konsole geschrieben.

<?php  
/*Connect to the local server using Windows Authentication and   
specify the AdventureWorks database as the database in use. */  
$serverName = "(local)";  
$conn = sqlsrv_connect( $serverName);  
if( $conn === false )  
{  
     echo "Could not connect.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
//-----------------------------------------------  
// Perform operations with connection here.  
//-----------------------------------------------  
  
/* Close the connection. */  
sqlsrv_close( $conn);  
echo "Connection closed.\n";  
?>

Weitere Informationen

API-Referenz für den SQLSRV-Treiber

Informationen zu den Codebeispielen in der Dokumentation