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