dbx_connect

Manuel PHP
Précédent		Suivant

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().

Précédent	Sommaire	Suivant
dbx_compare	Niveau supérieur	dbx_error