sqlsrv_connect

Articolo
06/02/2023

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 Procedura: Connessione con l'autenticazione di Windows e Procedura: Connettersi con l'autenticazione di SQL Server.

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

Vedere anche

Riferimento all'API del driver SQLSRV

Connessione al server

Informazioni sugli esempi di codice nella documentazione

Share via