Manuel PHP
Précédent |  | Suivant

# 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 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