sqlsrv_connect

Stáhnout ovladač PHP

Vytvoří zdroj spojení a otevře spojení. Ve výchozím nastavení se připojení pokouší pomocí Windows Authentication.

Syntax

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

Parameters

$serverName: Řetězec specifikující název serveru, ke kterému je navazováno spojení. Do tohoto řetězce lze zahrnout název instance (například <server>\instanceName) nebo číslo portu (například <server>, 1521). Pro úplný popis dostupných možností pro tento parametr viz serverové klíčové slovo v sekci ODBC Driver Connection String Keywords v knize Using Connection String Keywords with SQL Native Client.

Od verze 3.0 Microsoft Drivers for PHP for SQL Server můžete také specifikovat instanci LocalDB pomocí "(localdb)\instancename". Další informace naleznete v tématu Podpora pro LocalDB.

Také od verze 3.0 Microsoft Drivers for PHP for SQL Server můžete zadat název virtuální sítě, abyste se mohli připojit ke skupině dostupnosti Always On. Další informace o ovladačích Společnosti Microsoft pro PHP pro podporu SQL Serveru pro skupiny dostupnosti AlwaysOn naleznete v tématu Podpora pro vysokou dostupnost, zotavení po havárii.

$connectionInfo [OPTIONAL]: Asociativní pole , které obsahuje atributy spojení (například pole ("Database" => "AdventureWorks")). Viz Možnosti připojení pro seznam podporovaných klíčů pro pole.

Návratová hodnota

Zdroj pro připojení PHP. Pokud nelze spojení úspěšně vytvořit a otevřít, vrací se false (falešné ).

Poznámky

Pokud nejsou hodnoty pro klíče UID a PWD specifikovány v volitelném parametru $connectionInfo, pokusí se o připojení pomocí Windows Authentication. Pro více informací o připojení k serveru viz Jak: Připojit se pomocí Windows autentizace a Jak se připojit pomocí SQL Server Authentication.

Example

Následující příklad vytváří a otevírá spojení pomocí Windows Authentication. Příklad předpokládá, že SQL Server a databáze AdventureWorks jsou nainstalovány na lokálním počítači. Při spuštění příkladu z příkazového řádku se veškerý výstup zapíše do konzoly.

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

Viz taky

Referenční informace k rozhraní API ovladače SQLSRV

Připojení k serveru

Příklady kódu v dokumentaci