dbx

dbx_close
dbx_connect
dbx_error
dbx_query
dbx_sort
dbx_cmp_asc
dbx_cmp_desc

6.21.2 dbx_connect

Description

resource dbx_connect(string module ,string host ,string database ,string username ,string password ,[int persistent ])

Attention

Ce module est EXPERIMENTAL . Cela signifie que le comportement de ces fonctions, leurs noms et concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS! Soyez-en conscient, et utiliser ce module à vos risques et périls.

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

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

<?php $link = dbx_connect("mysql", "localhost", "base de donn&eacute;es", "utilisateur", "mot de passe"); mysql_close($link->handle); // dbx_close($link) est beaucoup plus adapt&eacute; 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("odbc", "", "base de donn&eacute;es", "utilisateur", "mot de passe", DBX_PERSISTENT)     or die ("Impossible de se connecter"); print ("Connexion r&eacute;ussie"); dbx_close($link); ?>

Note

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

Voir aussi dbx_close.