sqlsrv_connect

Artikel
06/02/2023

Erstellt eine Verbindungsressource und öffnet eine Verbindung. Standardmäßig wird versucht, die Verbindung unter Verwendung der Windows-Authentifizierung herzustellen.

Syntax

  
sqlsrv_connect( string $serverName [, array $connectionInfo])

Parameter

$serverName: Hierbei handelt es sich um eine Zeichenfolge, die den Namen des Servers angibt, zu dem eine Verbindung hergestellt wird. Ein Instanzname (z. B. „MeinServer\InstanzName“) oder Port (z. B. „MeinServer, 1521“) kann als Teil dieser Zeichenfolge enthalten sein. Eine vollständige Beschreibung der Optionen für diesen Parameter finden Sie im Abschnitt „Server-Schlüsselwort in den Kennwörtern der Verbindungszeichenfolgen des ODCB-Treibers“. Diesen finden Sie unter Verwenden von Schlüsselwörtern für Verbindungszeichenfolgen mit SQL Native Client.

Ab Version 3.0 der Microsoft-Treiber für PHP für SQL Serverkönnen Sie auch eine LocalDB-Instanz mit "(localdb)\instancename"angeben. Weitere Informationen finden Sie unter Unterstützung für LocalDB.

Zusätzlich können Sie ab der Version 3.0 der Microsoft-Treiber für PHP für SQL Servereinen virtuellen Netzwerknamen angeben, um sich mit einer Always-On-Verfügbarkeitsgruppe zu verbinden. Weitere Informationen zur Unterstützung von Microsoft-Treibern für PHP für SQL Server für Always On-Verfügbarkeitsgruppen finden Sie unter Unterstützung für hohe Verfügbarkeit und Notfallwiederherstellung.

$connectionInfo [OPTIONAL]: Ein assoziatives Array, das Verbindungsattribute (z. B. array("Database" => "AdventureWorks")) enthält. Unter Connection Options finden Sie eine Liste der unterstützten Schlüssel für das Array.

Rückgabewert

Eine PHP-Verbindungsressource. Wenn eine Verbindung nicht erfolgreich erstellt und geöffnet werden kann, wird false zurückgegeben.

Bemerkungen

Wenn im optionalen $connectionInfo -Parameter keine Werte für die Schlüssel UID und PWD angegeben sind, wird versucht, die Verbindung mithilfe der Windows-Authentifizierung herzustellen. Weitere Informationen zur Herstellung einer Verbindung mit dem Server finden Sie unter Vorgehensweise: Herstellen einer Verbindung mithilfe der Windows-Authentifizierung und Vorgehensweise: Herstellen einer Verbindung mithilfe der SQL Server-Authentifizierung

Beispiel

Das folgende Beispiel erstellt und öffnet eine Verbindung mit Windows-Authentifizierung. Das Beispiel setzt voraus, dass SQL Server und die AdventureWorks-Datenbank auf dem lokalen Computer installiert sind. 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. To connect using  
SQL Server Authentication, set values for the "UID" and "PWD"  
 attributes in the $connectionInfo parameter. For example:  
$connectionInfo = array("UID" => $uid, "PWD" => $pwd, "Database"=>"AdventureWorks");  
*/  
$serverName = "(local)";  
$connectionInfo = array( "Database"=>"AdventureWorks");  
$conn = sqlsrv_connect( $serverName, $connectionInfo);  
  
if( $conn )  
{  
     echo "Connection established.\n";  
}  
else  
{  
     echo "Connection could not be established.\n";  
     die( print_r( sqlsrv_errors(), true));  
}  
  
//-----------------------------------------------  
// Perform operations with connection.  
//-----------------------------------------------  
  
/* Close the connection. */  
sqlsrv_close( $conn);  
?>

Weitere Informationen

API-Referenz für den SQLSRV-Treiber

Verbinden mit dem Server

Informationen zu den Codebeispielen in der Dokumentation