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 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" (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" (CVS only)

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

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

> Note : Référez-vous à la docmentation du module utilisé.

Voir aussi dbx_close().

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