Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Crée une connexion à une base de données SQL Server.
Syntaxe
PDO::__construct($dsn [,$username [,$password [,$driver_options ]]] )
Paramètres
$dsn : Une chaîne contenant le préfixe (toujours sqlsrv), un deux-points, et le mot-clé Server. Par exemple : "sqlsrv:server=(local)". Vous pouvez éventuellement spécifier d’autres mots clés de connexion. Consultez Connection Options pour obtenir la description du mot clé Server et des autres mots clés de connexion. La totalité de $dsn est entre guillemets, si bien que chaque mot clé de connexion ne doit pas être individuellement mis entre guillemets.
$username : Optionnel. Chaîne qui contient le nom de l’utilisateur. Pour vous connecter avec l’authentification SQL Server, spécifiez l’ID de connexion. Pour vous connecter avec l’authentification Windows, spécifiez "".
$password : Optionnel. Chaîne qui contient le mot de passe de l’utilisateur. Pour vous connecter avec l’authentification SQL Server, spécifiez le mot de passe. Pour vous connecter avec l’authentification Windows, spécifiez "".
$driver_options : Optionnel. Vous pouvez spécifier les attributs du Gestionnaire de pilotes PDO et des attributs de pilotes spécifiques Pilotes Microsoft SQL Server pour PHP : PDO::SQLSRV_ATTR_ENCODING, PDO::SQLSRV_ATTR_DIRECT_QUERY. Lorsque PDO::ATTR_ERRMODE est PDO::ERRMODE_EXCEPTION, la valeur par défaut, un attribut ou une valeur d’attribut invalide fait que le constructeur jette un PDOException a avec SQLSTATE IMSSP.
PDO ::setAttribute valide les attributs de la même manière.
Configurez PDO::SQLSRV_ATTR_DEFAULT_STR_LENGTH$driver_options pour spécifier la longueur adaptative initiale des chaînes d’entrée éligibles dans les nouvelles instructions. La valeur par défaut est 0 (désactivé) ; les valeurs acceptées sont des entiers de 0 à 8 000. Une valeur invalide signale SQLSTATE IMSSP. Pour des exemples et des limitations, voir Déclarer les types et longueurs de chaînes d’entrée (PDO_SQLSRV).
Valeur de retour
Retourne un objet PDO. En cas d’échec, retourne un objet PDOException.
Exceptions
PDOException
Notes
Vous pouvez fermer un objet de connexion en affectant à l’instance la valeur Null.
Après une connexion, PDO::errorCode indique 01000 au lieu de 00000.
Si PDO::__construct échoue pour une raison quelconque, une exception est levée, même si PDO::ATTR_ERRMODE a la valeur PDO::ERRMODE_SILENT.
La prise en charge de PDO a été ajoutée dans la version 2.0 de Pilotes Microsoft SQL Server pour PHP.
Exemple avec base de données
Cet exemple montre comment se connecter à un serveur en utilisant l’authentification Windows et spécifier une base de données.
<?php
$c = new PDO( "sqlsrv:Server=(local) ; Database = AdventureWorks ", "", "", array(PDO::SQLSRV_ATTR_DIRECT_QUERY => true));
$query = 'SELECT * FROM Person.ContactType';
$stmt = $c->query( $query );
while ( $row = $stmt->fetch( PDO::FETCH_ASSOC ) ) {
print_r( $row );
}
$c = null;
?>
Exemple sans base de données
Cet exemple montre comment se connecter à un serveur en spécifiant la base de données plus tard.
<?php
$c = new PDO( "sqlsrv:server=(local)");
$c->exec( "USE AdventureWorks2022" );
$query = 'SELECT * FROM Person.ContactType';
$stmt = $c->query( $query );
while ( $row = $stmt->fetch( PDO::FETCH_ASSOC ) ){
print_r( $row );
}
$c = null;
?>