sqlsrv_connect

PHP-illesztőprogram letöltése

Létrehoz egy kapcsolati erőforrást és megnyitja a kapcsolatot. Alapértelmezés szerint a kapcsolatot Windows hitelesítéssel próbálják meg.

Szintaxis

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

Parameters

$serverName: Egy láncsor, amely megadja annak a szervernek a nevét, amelyhez kapcsolatot hoznak létre. Egy instance név (például <server>\instanceName) vagy portszám (például <server>, 1521) is beilleszthető ehhez a lánchoz. A paraméter Server teljes leírásáért a DSN és a Connection String kulcsszavak és attribútumok kulcsszavaként érhető el.

A Microsoft Drivers for PHP for SQL Server 3.0-s verziójától kezdve LocalDB példányt is megadhatsz ."(localdb)\instancename" További információ: LocalDB támogatása.

A Microsoft Drivers for PHP for SQL Server 3.0-s verziótól kezdve megadhatsz egy virtuális hálózati nevet, hogy csatlakozz egy Always On elérhetőségi csoporthoz. További információ a Microsoft Drivers for PHP for SQL Server Always On rendelkezésre állási csoportokhoz való támogatásáról: Magas rendelkezésre állás támogatása, Vészhelyreállítás.

$connectionInfo [OPTIONAL]: Egy asszociatív tömb , amely kapcsolati attribútumokat tartalmaz (például array("Database" => "AdventureWorks")). A tömb támogatott kulcsainak listájáért lásd a Csatlakozási Opciókat .

Visszaadott érték

Egy PHP kapcsolati forrás. Ha a kapcsolatot nem lehet sikeresen létrehozni és megnyitni, a hamis-értéket visszaadják.

Remarks

Ha az UID és PWD kulcsok értékei nincsenek megadva az opcionális $connectionInfo paraméterben, a csatlakozást Windows hitelesítéssel próbálják meg. További információért a szerverhez való csatlakozásról lásd: Hogyan csatlakozzunk Windows hitelesítéssel és Hogyan kapcsolódjunk: SQL Server hitelesítéssel.

Example

A következő példa a Windows hitelesítéssel létrehoz és megnyit egy kapcsolatot. A példa feltételezi, hogy az SQL Server és az AdventureWorks adatbázis a helyi számítógépen van telepítve. A rendszer minden kimenetet a konzolra ír, amikor a példa a parancssorból fut.

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

Lásd még

SQLSRV Driver API-referencia

Csatlakozás a kiszolgálóhoz

Tudnivalók a dokumentációban szereplő példakódokról