(PHP 4 >= 4.0.6, PHP 5 <= 5.0.4)
dbx_connect -- Ouvre une connexion à une base de données
Description
object
dbx_connect ( mixed module, string host, string database, string username, string password [, int persistent] )
dbx_connect() retourne une ressource dbx_link_object
en cas de succès, FALSE sinon. Si la connexion a
put être établie, mais que la base de données n'a pas
pu être sélectionnée, la fonction retournera quand
même une ressource.
Le paramètre persistent peut prendre la
valeur DBX_PERSISTENT, pour créer une connexion persitente.
Le paramètre module peut être soit une
chaîne, soit une constante. Les valeurs possibles de
module sont listées ci-dessous (n'oubliez pas
que cela fonctionnera que si le module associé est chargé) :
module DBX_MYSQL : "mysql"
module DBX_ODBC : "odbc"
module DBX_PGSQL : "pgsql"
module DBX_MSSQL : "mssql"
module DBX_FBSQL : "fbsql" (disponible depuis PHP 4.1.0)
module DBX_SYBASECT : "sybase_ct" (disponible depuis
PHP 4.2.0)
module DBX_OCI8 : "oci8" (disponible depuis
PHP 4.3.0)
module DBX_SQLITE : "sqlite" (PHP 5)
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.
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).
Exemple 1. Utilisation de la ressource de base de données DBX
<?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.
Exemple 2. 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é.
Voir aussi
dbx_close().
