sqlsrv_connect
Crée une ressource de connexion et ouvre une connexion. Par défaut, la connexion est tentée en utilisant l’authentification Windows.
Syntaxe
sqlsrv_connect( string $serverName [, array $connectionInfo])
Paramètres
$serverName : chaîne spécifiant le nom du serveur auquel une connexion est établie. Un nom d’instance (par exemple, « monServeur\nomInstance ») ou un numéro de port (par exemple, « monServeur, 1521 ») peuvent être inclus dans cette chaîne. Pour obtenir la description complète des options disponibles pour ce paramètre, consultez le mot clé Server dans la section Mots clés de chaîne de connexion du pilote ODBC dans Utilisation de mots clés de chaîne de connexion avec SQL Server Native Client.
À compter de la version 3.0 de Pilotes Microsoft SQL Server pour PHP, vous pouvez aussi spécifier une instance LocalDB avec "(localdb)\instancename". Pour plus d’informations, consultez Prise en charge de LocalDB.
Également depuis la version 3.0 de Pilotes Microsoft SQL Server pour PHP, vous pouvez spécifier un nom de réseau virtuel, pour établir une connexion à un groupe de disponibilité Always On. Pour plus d’informations sur Pilotes Microsoft pour PHP pour la prise en charge SQL Server pour les groupes de disponibilité Always On, consultez Prise en charge de la haute disponibilité et de la récupération d’urgence.
$connectionInfo [FACULTATIF] : tableau associatif qui contient des attributs de connexion (par exemple, array("Database" => "AdventureWorks")). Consultez Connection Options pour obtenir la liste des clés prises en charge pour le tableau.
Valeur de retour
Ressource de connexion PHP. Si aucune connexion ne peut être créée et ouverte correctement, false est retourné.
Notes
Si les valeurs des clés UID et PWD ne sont pas spécifiées dans le paramètre facultatif $connectionInfo , la connexion est tentée en utilisant l’authentification Windows. Pour plus d’informations sur la connexion au serveur, consultezGuide pratique pour se connecter à l’aide de l’authentification Windows et Guide pratique pour se connecter à l’aide de l’authentification SQL Server.
Exemple
L’exemple suivant crée et ouvre une connexion en utilisant l’authentification Windows. L’exemple part du principe que SQL Server et la base de données AdventureWorks sont installés sur l’ordinateur local. Toute la sortie est écrite dans la console quand l’exemple est exécuté à partir de la ligne de commande.
<?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);
?>