dba_open (PHP 3 >= 3.0.8, PHP 4, PHP 5) dba_open -- Ouvre une base de données DBA Descriptionresource dba_open ( string path, string mode [, string handler [, mixed ...]] )
dba_open() établit une connexion à
la base repérée par path avec le
mode mode et l'identifiant
handler.
Liste de paramètres
- path
Chemin sur votre système de fichiers.
- mode
Il vaut r pour lecture seule, w pour
lecture/écriture, c pour lecture/écriture, et
création si la base n'existe pas, et n pour
création, écrasement et accès en lecture/écriture.
De plus, vous pouvez choisir la méthode de verrouillage de la base avec le
caractère suivant. Utilisez l pour vérrouiller la base avec un
fichier .lck, ou d pour verrouiller
la base elle-même. Il est important que vos application utilisent ces
options de manière cohérente.
Si vous voulez tester la possibilité
d'accès, et ne pas attendre la disponibilité du verrou, vous pouvez
ajouter la lettre t comme troisième caractère. Lorsque
vous êtes absolument certain que votre base ne requiert pas de
verrou, vous pouvez utiliser le tiret - à la place de
l ou d.
Lorsque vous n'utilisez ni d, ni l ni
-, dba va verrouiller en mode d.
Note :
Il ne peut y avoir qu'un seul type d'écriture dans la base. Lorsque vous
utilisez dba sur un serveur web, et que plusieurs requêtes HTTP effectuent
des écritures, elles ne peuvent être faites que l'une après l'autre. De même,
la lecture durant l'écriture n'est pas possible. L'extension dba utilise
un verrou pour éviter ces problèmes. Voici la table de verrouillage :
Tableau 1. Verrouillage DBA | déjà ouverte | mode = "rl" | mode = "rlt" | mode = "wl" | mode = "wlt" | mode = "rd" | mode = "rdt" | mode = "wd" | mode = "wdt" |
|---|
| non-ouverte | ok | ok | ok | ok | ok | ok | ok | ok | | mode = "rl" | ok | ok | attente | FALSE | illegal | illegal | illegal | illegal | | mode = "wl" | attente | FALSE | attente | FALSE | illegal | illegal | illegal | illegal | | mode = "rd" | illegal | illegal | illegal | illegal | ok | ok | attente | FALSE | | mode = "wd" | illegal | illegal | illegal | illegal | attente | FALSE | attente | FALSE |
| ok: Le second appel réussit. | | wait: Le second appel attend que dba_close() soit appelé par le premier script. | | FALSE: Le second appel retourn FALSE. | | illegal: vous ne devez pas mélanger les options "l" et "d" pour le paramètre mode. |
- handler
Le nom du gestionnaire
qui doit être utilisé pour accéder à path.
C'est passé à tous les paramètres facultatifs donnés à
dba_open() et peut agir au nom d'eux.
Valeurs de retour
Retourne un gestionnaire positif en cas de succès, ou FALSE si une erreur survient.
|
