dbx_compare
dbx_error
Fonctions dbx
PHP Manual

# dbx_connect

(PHP 4 >= 4.0.6, PHP 5 <= 5.0.5, PECL dbx:1.1.0)

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` ] )

Ouvre une connexion à une base de données.

### Liste de paramètres

`module`

  Le paramètre `module` peut être soit une chaîne, soit une constante. Les valeurs possibles de `module` sont listées ci-dessous, mais n'oubliez pas que cela fonctionnera que si le module associé est chargé.

  - `DBX_MYSQL` ou "mysql"
  - `DBX_ODBC` ou "odbc"
  - `DBX_PGSQL` ou "pgsql"
  - `DBX_MSSQL` ou "mssql"
  - `DBX_FBSQL` ou "fbsql" (disponible depuis PHP 4.1.0)
  - `DBX_SYBASECT` ou "sybase_ct" (disponible depuis PHP 4.2.0)
  - `DBX_OCI8` ou "oci8" (disponible depuis PHP 4.3.0)
  - `DBX_SQLITE` ou "sqlite" (disponible depuis PHP 5)
`host`

  L'hôte serveur SQL

`database`

  Le nom de la base de données

`username`

  Le nom d'utilisateur

`password`

  Le mot de passe

`persistent`

  Le paramètre `persistent` peut prendre la valeur `DBX_PERSISTENT`, pour créer une connexion persitente.

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.

### Valeurs de retour

Retourne un objet en cas de succès, `FALSE` si une erreur survient. Si une connexion a été faîte mais la base de données n'a pû être sélectionnée, la connexion sera fermée et `FALSE` sera retourné.

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

  `<?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.

### Exemples

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);
?>`

### Notes

> Note: Reportez-vous à la documentation du module utilisé.

### Voir aussi

- dbx_close()

dbx_compare
dbx_error
Fonctions dbx
PHP Manual