PDO::__construct

Télécharger le pilote PHP

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