dbx_connect

(PHP 4 >= 4.0.6, PHP 5)

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 resource 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 persitante.

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é) :

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 dansles 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.

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 : Référez-vous à la docmentation du module utilisé.

Voir aussi dbx_close().