(PHP 8 >= 8.4.0)
PDO::connect — Connecte à une base de données et retourne une sous-classe PDO pour les pilotes qui le supportent
$dsn
,$username
= null
,$password
= null
,$options
= null
Créer une instance d'une sous-classe de PDO pour la base de données connectée si elle existe, sinon retourne une instance générique de PDO.
dsn
Le Data Source Name
, ou DSN, qui contient les
informations requises pour se connecter à la base.
En général, un DSN est constitué du nom du pilote PDO, suivi d'une syntaxe spécifique au pilote. Plus de détails sont disponibles dans la documentation PDO de chaque pilote.
Le paramètre dsn
supporte trois méthodes différentes
pour spécifier les arguments nécessaires à la création de la base de données :
dsn
contient le DSN complet.
dsn
est constitué de uri:
suivi par une URI qui définit la localisation du fichier contenant
la chaîne de DSN. L'URI peut spécifier un fichier local ou distant.
uri:file:///path/to/dsnfile
dsn
est constitué d'un nom
name
qui correspond à
pdo.dsn.
dans le fichier php.ini,
et qui définit la chaîne DSN.
name
Note:
L'alias doit être défini dans le fichier php.ini, et non pas dans un fichier .htaccess ou httpd.conf
username
Le nom d'utilisateur pour la chaîne DSN. Ce paramètre est optionnel pour certains pilote PDO.
password
Le mot de passe de la chaîne DSN. Ce paramètre est optionnel pour certains pilote PDO.
options
Un tableau clé=>valeur avec les options spécifiques de connexion.
Renvoie une instance d'une sous-classe de PDO pour le pilot PDO correspondant si elle existe, ou une instance générique de PDO.
Une exception PDOException est levée si la tentative
de connexion à la base de données demandée échoue,
indépendamment du PDO::ATTR_ERRMODE
actuellement défini.