8.96 Fonctions PDO
8 Référence des fonctions
Manuel PHP
. Introduction
. Installation
. Drivers PDO
. Classes pré-définies
. Constantes pré-définies
. PDO::beginTransaction
. PDO::commit
->PDO::__construct
. PDO::errorCode
. PDO::errorInfo
. PDO::exec
. PDO::getAttribute
. PDO::lastInsertId
. PDO::prepare
. PDO::query
. PDO::quote
. PDO::rollBack
. PDO::setAttribute
. PDOStatement::bindColumn
. PDOStatement::bindParam
. PDOStatement::columnCount
. PDOStatement::errorCode
. PDOStatement::errorInfo
. PDOStatement::execute
. PDOStatement::fetch
. PDOStatement::fetchAll
. PDOStatement::fetchSingle
. PDOStatement::getAttribute
. PDOStatement::getColumnMeta
. PDOStatement::rowCount
. PDOStatement::setAttribute
. PDOStatement::setFetchMode
|
8.96.8 PDO::__construct()
Crée une instance PDO qui représente une connexion à une base de données
[ Exemples avec pdo_construct ] CVS uniquement
PDO
PDO::__construct (
string
dsn
,
string
username
,
string
password
,
array
driver_options
)
| Attention | |
Cette fonction est
EXPERIMENTALE
. Cela signifie que le comportement de
cette fonction, son nom et concrètement, TOUT ce qui est documenté ici peut
changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utilisez
cette fonction à vos risques et périls.
|
PDO::__construct
crée une instance PDO qui représente
une connexion à la base de données désirée.
- dsn
-
Le paramètre
dsn
supporte trois méthodes
différentes de spécification des arguments requis pour créer une connexion
à une base de données :
- Invocation du Driver
-
dsn
consiste en le nom du driver PDO, suivi par
deux points (
:
), suivi par la syntaxe spécifique de connexion
du driver PDO.
Par exemple,
'odbc:DSN=SAMPLE;UID=db2inst1;PWD=ibmdb2'
créera une connexion PDO_ODBC à une base de données ODBC, tandis que
'mysql:host=127.0.0.1;dbname=testdb'
créera une
connexion PDO_MYSQL à une base de données MySQL.
- Invocation d'une URI
-
dsn
consiste en l'
uri:
suivi par une URI qui définie l'emplacement d'un fichier contenant la chaîne DSN.
L'URI peut spécifier un fichier local ou une URL distante.
- Utilisation d'un alias
-
dsn
consiste en le nom
name
qui équivaut à
pdo.dsn.
name
du
php.ini
définissant la chaîne DSN.
name
ne
doit pas contenir de doubles points (
:
).
- username
-
Le nom d'utilisateur pour la chaîne DSN. Ce paramètre est optionnel pour
quelques drivers PDO.
- password
-
Le mot de passe pour la chaîne DSN. Ce paramètre est optionnel pour
quelques drivers PDO.
- driver_options
-
Un tableau clé=>valeur contenant les options de connexion spécifiques
au driver.
Retourne un objet PDO en cas de succès.
PDO::construct
lance une PDOException si la tentative
de connexion à la base de données échoue.
| Crée une instance PDO via une invocation de driver |
<?php
/* Connexion à une base de données ODBC en invoquant un driver */
$dsn = 'mysql:dbname=testdb;host=127.0.0.1';
$user = 'dbuser';
$password = 'dbpass';
try {
$dbh = new PDO($dsn, $user, $password);
}
catch (PDOException $e) {
echo 'Echec de la connexion : ' . $e->getMessage();
}
?>
|
| Création d'une instance PDO par invocation d'une URI | |
L'exemple suivant présume que le fichier
/usr/local/dbconnect
existe et que PHP y a les droits de
lecture. Le fichier contient le DSN PDO pour se connecter à une base de données
DB2 via le driver PDO_ODBC :
|
| Création d'une instance PDO en utilisant un alias | |
L'exemple suivant présume que le
php.ini
contient l'entrée suivante pour activer
une connexion à une base de données MySQL en utilisant uniquement l'alias
mydb
:
pdo.dsn.mydb=mysql:dbname=testdb;host=127.0.0.1
|
|