8.25 Fonctions dbx
8 Référence des fonctions
Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. dbx_close
. dbx_compare
->dbx_connect
. dbx_error
. dbx_escape_string
. dbx_fetch_row
. dbx_query
. dbx_sort
|
8.25.9 dbx_connect()Ouvre une connexion à une base de données[ Exemples avec dbx_connect ] PHP 4 >= 4.0.6, PHP 5 <= 5.0.4
object
dbx_connect (
mixed
module
,
string
host
,
string
database
,
string
username
,
string
password
,
int
persistent
)
dbx_connect
retourne une ressource 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 persitente.
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" (PHP 5)
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
dans les fonctions spécifiques au module (si requis).
| Utilisation de la ressource de base de données DBX |
<?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 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 | |
Reportez-vous à la documentation du module utilisé.
|
Voir aussi
dbx_close
.
|
