dbx_connect

dbx_connect -- Ouvre une connexion à une base de données

Description

resource dbx_connect ( string module, string host, string database, string username, string password [, int persistent])

Avertissement

Ce module est EXPERIMENTAL . Cela signifie que le comportement de ces fonctions , leurs noms et concrètement , TOUT ce qui est documenté ici peut changer dans un futur proche , SANS PREAVIS ! Soyez-en conscient , et utiliser ce module à vos risques et périls .

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 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é ) :



Le support de pgsql était au stade expérimental jusqu ' en avril 2001 , et vous devez compiler vous-même le module pgsql après avoir modifié un des fichiers sources . Sinon , vous aurez une alerte affichée à chaque requête .

La ressource dbx_link_object a trois membres : ' handle' , 'module ' et 'database ' . Le membre ' database ' contient le nom de la base de données actuellement sélectionnée . Le membre ' module ' est à usage interne à dbx , et contient le numéro de module sus-cité . Le membre ' handle ' est une ressource valide de connexion à la base de données , et peut être utilisé en tant que tel dans les autres fonctions spécifiques à cette base de données .

Le message d' erreur pour Microsoft SQL server est actuellement le résultat direct de la fonction mssql_get_last_message( ) .

 
?php

 
$link

 
=

 
dbx_connect(

 
"mysql"

 
,

 
"localhost"

 
,

 
"base

 
de

 
données"

 
,

 
"utilisateur"

 
,

 
"mot

 
de

 
passe")

 
;

 
mysql_close($link

 
-

 
handle)

 
;

 
/

 
/

 
dbx_close($link

 
)

 
est

 
beaucoup

 
plus

 
adapté

 
ici

 
?





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 .

Exemple 1 . Exemple avec dbx_connect( )

 
?php

 
$link

 
=

 
dbx_connect(

 
"odbc"

 
,

 
""

 
,

 
"base

 
de

 
données"

 
,

 
"utilisateur"

 
,

 
"mot

 
de

 
passe"

 
,

 
DBX_PERSISTENT

 
)

 
or

 
die

 
("Impossible

 
de

 
se

 
connecter")

 
;

 
print

 
("Connexion

 
réussie")

 
;

 
dbx_close($link)

 
;

 
?



Reportez-vous aussi à la documentation de la base de données que vous utilisez .



Voir aussi dbx_close( ) .