sqlsrv_connect
Crea una risorsa di connessione e apre una connessione. Per impostazione predefinita, viene eseguito un tentativo di connessione usando l'autenticazione di Windows.
Sintassi
sqlsrv_connect( string $serverName [, array $connectionInfo])
Parametri
$serverName: stringa che specifica il nome del server con cui viene stabilita la connessione. Nella stringa può essere incluso un nome di istanza (ad esempio, "myServer\instanceName") o un numero di porta (ad esempio, "myServer, 1521"). Per una descrizione completa delle opzioni disponibili per questo parametro, vedere la parola chiave Server nella sezione Parole chiave delle stringhe di connessione per il driver ODBC di Uso delle parole chiave delle stringhe di connessione con SQL Server Native Client.
A partire dalla versione 3.0 dei driver Microsoft per PHP per SQL Server, è anche possibile specificare un'istanza di Local DB con "(localdb)\instancename". Per altre informazioni, vedere Supporto per LocalDB.
In più, a partire dalla versione 3.0 dei driver Microsoft per PHP per SQL Server, è possibile specificare un nome di rete virtuale per connettersi a un gruppo di disponibilità Always On. Per altre informazioni sul supporto dei driver Microsoft per PHP per SQL Server per i gruppi di disponibilità Always On, vedere Supporto per disponibilità elevata, ripristino di emergenza.
$connectionInfo [facoltativo]: una matrice associativa che contiene attributi di connessione (ad esempio, array("Database" => "AdventureWorks")). Vedere Connection Options per un elenco delle chiavi supportate per la matrice.
Valore restituito
Una risorsa di connessione PHP. Se non è possibile creare e aprire correttamente una connessione, verrà restituito false .
Osservazioni:
Se i valori per le chiavi UID e PWD non sono specificati nel parametro $connectionInfo facoltativo, verrà eseguito un tentativo di connessione viene usando l'autenticazione di Windows. Per altre informazioni sulla connessione al server, vedere How to: Connect Using Windows Authentication e How to: Connect Using SQL Server Authentication.
Esempio
L'esempio seguente permette di creare e aprire una connessione usando l'autenticazione di Windows. Nell'esempio si presuppone che SQL Server e il database AdventureWorks siano installati nel computer locale. Quando si esegue l'esempio dalla riga di comando, tutto l'output viene scritto nel browser.
<?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);
?>