dbx_connect
(PHP 4 >= 4.0.6, PHP 5 < 5.1.0, PECL dbx >= 1.1.0)
dbx_connect — Ouvre une connexion à une base de données
Description
dbx_connect
(
mixed $module
,
string $host
,
string $database
,
string $username
,
string $password
[,
int $persistent
] ) :
object
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).
-
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é.