PDO::__construct

Article
06/02/2023

Crée une connexion à une base de données SQL Server.

Syntaxe

  
PDO::__construct($dsn [,$username [,$password [,$driver_options ]]] )

Paramètres

$dsn : chaîne comportant le nom du préfixe (toujours sqlsrv), un signe 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 : facultatif. 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: facultatif. 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 : facultatif. 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. Un attribut non valide ne lève pas d’exception. Les attributs non valides lèvent des exceptions quand ils sont spécifiés avec PDO::setAttribute.

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

Voir aussi

PDO, classe

PDO

Partager via