|
(no version information, might be only in CVS)
PDO::__construct -- Crée une instance PDO qui représente une connexion à une base de donnéesAvertissement |
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.
Le nom de la source de données, ou DSN, contient l'information nécessaire pour se connecter à la base de données.
En général, un DSN consiste en un nom de driver PDO, suivit par deux points (:), suivit par la synthaxe spécifique au driver PDO. Des exemples pour chaque driver sont données ci-dessous :
Le préfixe DSN est soit sybase:, soit mssql: dépendamment des librairies sur lesquelles il est lié au moment de la compilation.
sybase:host=localhost; dbname=testdb
mssql:host=localhost; dbname=testdb
firebird:User=john;Password=mypass;Database=DATABASE.GDE;DataSource=localhost;Port=3050
mysql:host=localhost;dbname=testdb
Pour se cnnecter via tnsnames.ora, utilisez :
oci:mydb
Si vous utilisez instantclient, utilisez :
oci:dbname=//localhost:1521/testdb
odbc:DSN=SAMPLE;UID=john;PWD=mypass
DSN=SAMPLE se réfère à la source de données SAMPLE configurée dans le gestionnaire du driver ODBC.
pgsql:host=localhost port=5432 dbname=testdb user=john password=mypass
Notez qu'en passant user et password au DSN, les paramètres username et password deviennent optionnels. S'ils sont spécifiés, ils seront mis à la fin de la chaîne de connexion.
sqlite:/path/to/database
Pour créer une base de données en mémoire, utilisez :
sqlite::memory:
sqlite2:/path/to/database
Pour créer une base de données en mémoire, utilisez :
sqlite2::memory:
Note : Le driver PDO SQlite 2 fournit un accès aux anciennes bases de données SQlite 2 que vous avez créé avec les anciennes versions de PHP. Il est recommandé de migrer vers SQLite 3 (le driver PDO_SQLITE), car il possède plus de fonctionnalités et accroît les performance.
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 :
dsn contient le DSN complet.
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.
uri:file:///path/to/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 php.ini et non pas dans un .htaccess, ni dans le httpd.conf.
Le nom d'utilisateur pour la chaîne DSN. Ce paramètre est optionnel pour quelques drivers PDO.
Le mot de passe pour la chaîne DSN. Ce paramètre est optionnel pour quelques drivers PDO.
Un tableau clé=>valeur contenant les options de connexion spécifiques au driver.
PDO::construct() lance une PDOException si la tentative de connexion à la base de données échoue.
Exemple 2. 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 :
Le script PHP peut maintenant créer une connexion à la base de données en passant simplement le paramètre uri: pointant vers le fichier URI :
|
Exemple 3. 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:
|
Précédent | Sommaire | Suivant |
PDO::commit | Niveau supérieur | PDO::errorCode |
Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:02:13