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"
  - `DBX_SYBASECT` ou "sybase_ct"
  - `DBX_OCI8` ou "oci8"
  - `DBX_SQLITE` ou "sqlite"

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

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 pu ê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.

### Historique

Version | Description
--- | ---
5.0.0 | Ajout de la constante `DBX_SQLITE`.
4.3.0 | Ajout de la constante `DBX_OCI8`.
4.2.0 | Ajout de la constante `DBX_SYBASECT`.
4.1.0 | Ajout de la constante `DBX_FBSQL`.

### 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() - Ferme une connexion à une base DBX

dbx_compare
dbx_error
Fonctions dbx
PHP Manual