dbx_connect
(PHP 4 >= 4.0.6, PHP 5 <= 5.0.5, PECL dbx:1.1.0)
dbx_connect — Ouvre une connexion à une base de données
Description
Ouvre une connexion à une base de données.
Liste de paramètres
- 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" (disponible depuis PHP 4.1.0)
- DBX_SYBASECT ou "sybase_ct" (disponible depuis PHP 4.2.0)
- DBX_OCI8 ou "oci8" (disponible depuis PHP 4.3.0)
- DBX_SQLITE ou "sqlite" (disponible depuis PHP 5)
- host
-
L'hôte serveur SQL
- database
-
Le nom de la base de données
- username
-
Le nom d'utilisateur
- password
-
Le mot de passe
- persistent
-
Le paramètre persistent peut prendre la valeur DBX_PERSISTENT, pour créer une connexion persitente.
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.
Valeurs de retour
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 pû être sélectionnée, la connexion sera fermée et FALSE sera retourné.
L'objet retourné object a trois propriétés :
- database
- Nom de la base de données sélectionnées
- handle
-
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.
?> - module
- Utiliser en interne par dbx uniquement et actuellement, correspond au numéro du module mentionné ci-dessus.
Exemples
Example#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);
?>
Notes
Note: Reportez-vous à la documentation du module utilisé.