(PHP 4 >= 4.0.6, PHP 5 < 5.1.0, PECL dbx >= 1.1.0)
dbx_connect — Ouvre une connexion à une base de données
$module
, string $host
, string $database
, string $username
, string $password
[, int $persistent
] ) : objectOuvre une connexion à une base de données.
module
Le paramètre module peut être soit une
chaîne, soit une constante. Les valeurs possibles de
module sont listées ci-dessous, mais n'oubliez pas
que cela fonctionnera que si le module associé est chargé.
DBX_MYSQL ou "mysql"
DBX_ODBC ou "odbc"
DBX_PGSQL ou "pgsql"
DBX_MSSQL ou "mssql"
DBX_FBSQL ou "fbsql"
DBX_SYBASECT ou "sybase_ct"
DBX_OCI8 ou "oci8"
DBX_SQLITE ou "sqlite"
hostL'hôte serveur SQL
databaseLe nom de la base de données
usernameLe nom d'utilisateur
passwordLe mot de passe
persistent
Le paramètre persistent peut prendre la
valeur DBX_PERSISTENT,
pour créer une connexion persistante.
Les paramètres host, database,
username et password sont
attendus, mais ne sont pas toujours utiles, suivant la fonction de connexion
de la base de données utilisée.
Retourne un objet en cas de succès, FALSE si une erreur survient. Si une
connexion a été faîte mais la base de données n'a pu être sélectionnée,
la connexion sera fermée et FALSE sera retourné.
L'objet retourné object a trois propriétés :
Ressource de connexion de la base de données, et donc, elle peut être utilisée dans les fonctions spécifiques au module (si requis).
<?php
$link = dbx_connect(DBX_MYSQL, "localhost", "db", "username", "password");
mysql_close($link->handle); // dbx_close($link) serait plus appropriée ici.
?>
| Version | Description |
|---|---|
| 5.0.0 |
Ajout de la constante DBX_SQLITE.
|
| 4.3.0 |
Ajout de la constante DBX_OCI8.
|
| 4.2.0 |
Ajout de la constante DBX_SYBASECT.
|
| 4.1.0 |
Ajout de la constante DBX_FBSQL.
|
Exemple #1 Exemple avec dbx_connect()
<?php
$link = dbx_connect(DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)
or die("Impossible de se connecter");
echo "Connexion réussie";
dbx_close($link);
?>
Note:
Reportez-vous à la documentation du module utilisé.