Création d’une instance PDO
Description
(PHP 5 >= 5.1.0, PECL pdo:0.1-1.0.3)
PDO->__construct() — Crée une instance PDO représentant une connexion à la base.
Structure
PDO-> __construct ( string $dsn [, string $username [, string $password [, array $driver_options ]]] )
PDO->__construct() crée une instance PDO qui représente une connexion à la base de données désirée.
Détail des paramètres
dsn
- Le Data Source Name, ou DSN, contient les informations requises pour se connecter à la base de données. En général, une source de données se compose du nom du pilote PDO, suivi par un « : » puis par la syntaxe spécifique du pilote PDO.
Le paramètre Dsn prend en charge trois différentes méthodes de préciser les arguments nécessaires à la création d’une connexion à une base de données:
dsn contient le DSN complet.
dsn consiste en uri: suivi d’un URI qui définit l’emplacement d’un fichier contenant la chaîne DSN. L’URI permet de spécifier un fichier local ou distant URL.
uri: file: / / / chemin / vers / dsnfile
dsn consiste en le nom name qui équivaut à pdo.dsn.name du php.ini définissant la chaîne DSN.
Note: L’alias doit être défini dans le fichier php.ini, et non dans le .htaccess ou le httpd.conf.
username
- Le nom d’utilisateur pour la chaîne dsn. Ce paramètre est optionnel pour certains driver PDO.
- Le mot de passe pour la chaîne DSN. Ce paramètre est optionnel pour certains drivers PDO.
- Un tableau clé => valeur contenant les options de connexion spécifiques au driver.
Valeur de retour
Retourne un objet PDO en cas de succès.
Erreur / exceptions
PDO->__construct() lance une PDOException si la tentative de connexion à la base de données échoue.