7.20.9 dbx_connect()Ouvre une connexion à une base de données

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

• module DBX_MYSQL : "mysql"
• module DBX_ODBC : "odbc"
• module DBX_PGSQL : "pgsql"
• module DBX_MSSQL : "mssql"
• module DBX_FBSQL : "fbsql" (CVS uniquement)

Le support de pgsql était au stade expérimental jusqu'en avril 2001, et vous devez compiler vous-même le module pgsql après avoir modifié un des fichiers sources. Sinon, vous aurez une alerte affichée à chaque requête.

La ressource dbx_link_object a trois membres : 'handle', 'module' et 'database'. Le membre 'database' contient le nom de la base de données actuellement sélectionnée. Le membre 'module' est à usage interne à dbx, et contient le numéro de module sus-cité. Le membre 'handle' est une ressource valide de connexion à la base de données, et peut être utilisé en tant que tel dans les autres fonctions spécifiques à cette base de données.

Le message d'erreur pour Microsoft SQL server est actuellement le résultat direct de la fonction mssql_get_last_message .

Exemple avec dbx_connect

<?php   $link = dbx_connect (DBX_MYSQL, "localhost", "db", "username", "password");   mysql_close ($link->handle);   // dbx_close($link) est beaucoup plus adapté ici ?>

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.

Exemple avec dbx_connect

<?php $link = dbx_connect (DBX_ODBC, "", "db", "username", "password", DBX_PERSISTENT)     or die ("Impossible de se connecter"); print ("Connexion réussie"); dbx_close ($link); ?>

Note

Reportez-vous aussi à la documentation de la base de données que vous utilisez.

Voir aussi dbx_close .