Introduction

Ces fonctions constituent l'interface avec les bases de type Berkeley.

C'est une couche générale pour plusieurs bases de données sur fichiers. En tant que telles, les fonctionnalités sont limitées à une partie des fonctionnalités des bases de données modernes, comme Sleepycat Software's DB2 (à ne pas confondre avec IBM's DB2 software, qui fonctionne avec ODBC).

Pré-requis

Le comportement de certaines fonctions dépend de la base de données utilisée. Par exemple dba_optimize() et dba_sync() n'auront pas le même effet d'une base à l'autre.

Lors de l'utilisation de la fonction dba_open() ou de dba_popen(), une des librairies suivantes doit être fournie comme argument. La liste complète des librairies supportées par votre configuration est disponible avec la fonction phpinfo(). (Pour inclure le support de l'une de ces librairies, ajoutez l'option de configuration --with-XXXX).

Lors de l'utilisation de la fonction dba_open() ou de dba_popen(), une des librairies suivantes doit être fournie comme argument. La liste complète des librairies supportées par votre configuration est disponible avec la fonction phpinfo().

Installation

En utilisant l'option de compilation --enable-dba=shared, vous pouvez compiler un module dynamique qui activera le support des bases de données de style DBM pour PHP. Vous devez aussi ajouter le support d'au moins l'un des gestionnaires suivants, en spécifiant l'option de configuration --with-XXXX lors de la configuration de PHP.

Configuration à l'exécution

Cette extension ne définit aucune directive de configuration.

Types de ressources

Les fonctions dba_open() et dba_popen() retourne une ressource qui représente la base de données ouverte, et qui est utilisées par toutes les autres fonctions dba.

Constantes prédefinies

Cette extension ne définit aucune constante.

Exemples

Exemple 1. Exemple DBA (1) <?php $id = dba_open ("/tmp/test.db", "n", "db2"); if (!$id) {     echo "dba_open a échoué\n";     exit; } dba_replace ("cle", "Ceci est un exemple!", $id); if (dba_exists ("cle", $id)) {     echo dba_fetch ("cle", $id);     dba_delete ("cle", $id); } dba_close ($id); ?>

DBA gère les données binaires et n'a pas de limites arbitraires. Elle hérite de toutes les limites de la base sous-jacente.

Toutes les bases de données sur fichiers doivent fournir un moyen de changer le mode d'accès au fichier d'une base et, si possible, de toutes les bases. Le mode d'accès est généralement passé en quatrième argument à dba_open() ou dba_popen().

Vous pouvez accéder à toutes les entrées d'une base d'une manière linéaire, avec les fonctions dba_firstkey() et dba_nextkey(). Vous ne devez pas modifier une base lorsque vous la traversez ainsi.

Exemple 2. Passer en revue une base <?php // ...ouverture de la base... $key = dba_firstkey ($id); while ($key != false) {     if (...) {               // conserver la clé pour faire d'autres opérations plus tard         $handle_later[] = $key;     }     $key = dba_nextkey ($id); } for ($i = 0; $i < count($handle_later); $i++)     dba_delete ($handle_later[$i], $id); ?>