Referencia de funciones
PHP Manual

Funciones de la Capa de Abstracción de Bases de Datos (tipo-dbm)

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.

Lista de gestores de DBA
Gestor Notas
dbm Dbm es el tipo más antiguo (original) de bases de datos tipo Berkeley DB. Es recomendable evitarlo, en lo posible. No soportamos las funciones de compatibilidad incorporadas en DB2 y gdbm, ya que solo son compatibles en el nivel de código fuente, pero no pueden gestionar el formato dbm original.
ndbm Ndbm es un tipo más reciente y flexible que dbm. Aun tiene muchos de los límites arbitrarios de dbm (y por lo tanto es obsoleto).
gdbm Gdbm es el » administrador de bases de datos GNU.
db2 DB2 es el formato » DB2 de Sleepycat Software. Es descrito como "un grupo de herramientas programáticas que ofrecen soporte incorporado y de alto rendimiento de bases de datos tanto para aplicaciones independientes como cliente/servidor".
db3 DB3 es » DB3 de Sleepycat Software.
db4 DB4 es » DB4 de Sleepycat Software. Este se encuentra disponible desde PHP 4.3.2.
cdb Cdb es "un paquete rápido, confiable y ligero para crear y leer bases de datos constantes." Es del creador de qmail y puede encontrarse en » http://cr.yp.to/cdb.html. Ya que es constante, sólo soportamos las operaciones de lectura. Y desde PHP 4.3.0 soportamos escritura (no actualización) a través de la biblioteca cdb interna.
cdb_make A partir de PHP 4.3.0 soportamos la creación (no actualización) de archivos cdb cuando la biblioteca cdb incorporada es usada.
flatfile Este formato está disponible desde PHP 4.3.0 únicamente para efectos de compatibilidad con la extensión obsoleta dbm y debería evitarse. Sin embargo es posible usarlo cuando los archivos fueron creados en este formato. Eso ocurre cuando 'configure' no encuentra alguna biblioteca externa.
inifile Este se encuentra disponible desde PHP 4.3.3 y tiene la capacidad de modificar archivos php.ini desde scripts PHP. Cuando se trabaja con archivos ini es posible pasar matrices de la forma array(0=>grupo,1=>nombre_valor) o cadenas de la forma "[grupo]nombre_valor" en donde el grupo es opcional. Dado que las funciones dba_firstkey() y dba_nextkey() devuelven representaciones tipo cadena de la clave, existe una nueva función, dba_key_split(), disponible desde PHP 5 que permite convertir las claves tipo cadena en claves tipo matriz sin perder FALSE.
qdbm Este se encuentra disponible desde PHP 5.0.0. La biblioteca qdbm puede encontrarse en » http://qdbm.sourceforge.net.

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ódulo 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.

Warning

Después de configurar y compilar PHP es necesario ejecutar la siguiente prueba desde la línea de comandos: php run-tests.php ext/dba. Ésta muestra si su combinación de gestores funciona. Los más problemáticos son dbm y ndbm, que ocasionan conflictos con varias instalaciones. La razón de esto es que en muchos sistemas aquellas bibliotecas son parte de más de una biblioteca externa. La prueba de configuración solo le previene de configurar gestores sencillos que operen incorrectamente, pero no de las combinaciones.

Gestores DBA soportados
Gestor Conmutador de Configuración
dbm

Para habilitar el soporte dbm agregue --with-dbm[=DIR].

Note: dbm es usualmente una envoltura que con frecuencia resulta en fallos. Esto quiere decir que únicamente debería usar dbm si está seguro de que funciona y realmente necesita este formato.

ndbm

Para habilitar soporte para ndbm agregue --with-ndbm[=DIR].

Note: ndbm es usualmente una envoltura que con frecuencia resulta en fallos. Esto quiere decir que únicamente debería usar ndbm si está seguro de que funciona y realmente necesita este formato.

gdbm Para habilitar el soporte para gdbm agregue --with-gdbm[=DIR].
db2

Para habilitar el soporte para db2 agregue --with-db2[=DIR].

Note: db2 genera un conflicto con db3 y db4.

db3

Para habilitar el soporte para db3 agregue --with-db3[=DIR].

Note: db3 genera un conflicto con db2 y db4.

db4

Para habilitar el soporte para db4 agregue --with-db4[=DIR].

Note: db4 genera un conflicto con db2 y db3.

Note: Esta opción fue agregada en PHP 4.3.2. En versiones anteriores de PHP, es necesario usar --with-db3=DIR, en donde DIR es la ruta hacia la biblioteca db4. No es posible usar versiones de db desde 4.1 con versiones de PHP anteriores a 4.3.0. Asimismo, las bibliotecas db con versiones entre 4.1 a 4.1.24 no pueden ser usadas en ninguna versión de PHP.

cdb

Para habilitar el soporte para cdb agregue --with-cdb[=DIR].

Note: Desde PHP 4.3.0 es posible omitir DIR para usar la biblioceta cdb incorporada, acción que agrega el gestor cdb_make para permitir la creación de archivos cdb y permite el acceso a archivos cdb en la red usando secuencias de PHP.

flatfile

Para habilitar el soporte para archivos planos (flatfile) agregue --with-flatfile.

Note: Este gestor fue agregado en PHP 4.3.0 para ofrecer compatibilidad con la extensión obsoleta dbm. Use este gestor únicamente cuando no pueda instalar una de las bibliotecas requeridas por los otros gestores y no pueda usar el gestor cdb incorporado.

inifile

Para habilitar el soporte para inifile agregue --with-inifile.

Note: Este gestor fue agregado en PHP 5.0.0 y le permite leer y definir archivos tipo .ini de microsoft (como el archivo php.ini).

qdbm

Para habilitar el soporte para qdbm agregue --with-qdbm[=DIR].

Note: qdbm genera un conflicto con dbm y gdbm.

Note: Este gestor fue agregado en PHP 5.0.0. La biblioteca qdbm puede obtenerse desde » http://qdbm.sourceforge.net.

Note: Hasta PHP 4.3.0 es posible agregar tanto db2 como db3 pero solo uno de ellos puede ser usado internamente. Esto quiere decir que no es posible tener ambos formatos de archivo. A partir de PHP 5.0.0 existe un chequeo de configuración para evitar tales errores de configuración.

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

Example#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.

Example#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 acción mas adelante
        
$manejar_despues[] = $clave;
    }
    
$clave dba_nextkey($id);
}

foreach (
$manejar_despues as $val) {
    
dba_delete($val$id);
}

?>

Table of Contents


Referencia de funciones
PHP Manual