Introducción

Estas funciones forman la base para acceder a bases de datos tipo Berkeley DB.

Esta es una capa general de abstracción para varias bases de datos basadas en archivos. Como tal, su funcionalidad está limitada al sub-conjunto común de características que soportan bases de datos modernas como DB2 de Sleepycat Software. (No confundirla con el software DB2 de IBM, el cual es soportado por medio de las funciones ODBC.)

Requisitos

El comportamiento de varios aspectos depende de la implementación de la base de datos interna. Funciones como dba_optimize() y dba_sync() harán lo que prometen para una base de datos y no tendrán efecto sobre otras. Es necesario descargar e instalar los gestores de base de datos soportados.

Cuando se invocan las funciones dba_open() o dba_popen(), uno de los nombres de gestor debe entregarse como argumento. La lista de gestores realmente disponibles se muestra al invocarse phpinfo() o dba_handlers().

Instalación

Usando el conmutador de configuración --enable-dba=shared, es posible construir un módule susceptible a ser cargado dinámicamente para habilitar PHP con soporte básico de bases de datos tipo dbm. También es necesario añadir soporte para al menos uno de los siguientes gestores especificando el valor de configuración --with-XXXX en su línea 'configure' de PHP.

Configuración en tiempo de ejecución

Esta extensión no tiene directivas de configuración en php.ini.

Tipos de recursos

Las funciones dba_open() y dba_popen() devuelven un gestor al archivo de base de datos a acceder especificado, el cual es usado por todas las otras llamadas a funciones dba.

Constantes predefinidas

Esta extensión no tiene ninguna constante definida.

Ejemplos

Ejemplo 1. Ejemplo de DBA <?php $id = dba_open("/tmp/prueba.db", "n", "db2"); if (!$id) {     echo "dba_open ha fallado\n";     exit; } dba_replace("clave", "Este es un ejemplo!", $id); if (dba_exists("clave", $id)) {     echo dba_fetch("clave", $id);     dba_delete("clave", $id); } dba_close($id); ?>

DBA es seguro con material binario y no tiene límites arbitrarios. Sin embargo, hereda todos los límites establecidos por la implementación de la base de datos interna.

Todas las bases de datos basadas en archivo deben ofrecer una forma de establecer el modo de archivo de una base de datos recién creada, si es posible. Un modo de archivo es pasado por lo general como el cuarto argumento a dba_open() o dba_popen().

Es posible acceder a todas las entradas de una base de datos en una forma lineal usando las funciones dba_firstkey() y dba_nextkey(). No debe modificar la base de datos mientras la recorre.

Ejemplo 2. Recorrido de una base de datos <?php // ...abrir base de datos... $clave = dba_firstkey($id); while ($clave != false) {     if (true) {   // recordar la clave para realizar alguna accion mas adelante         $manejar_despues[] = $clave;     }     $clave = dba_nextkey($id); } foreach ($manejar_despues as $val) {     dba_delete($val, $id); } ?>