Manuel PHP
Précédent |  | Suivant

# dbx_connect

(PHP 4 >= 4.0.6, PHP 5 <= 5.0.4)

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

Précédent | Sommaire | Suivant
dbx_compare | Niveau supérieur | dbx_error