Index of /php_manual_ru2/f/ref.dba.htm

XVII. Функции абстрактного слоя баз данных
(в dbm-стиле)

Введение

Эти функции являются фундаментом для доступа к БД в стиле Berkeley DB.

Имеется общий абстрактный слой для различных БД на основе файлов. Сама по себе функциональность ограничена обычным поднабором возможностей, поддерживаемых современными БД, такими как Sleepycat Software's DB2. (Это не конфликтует с программой DB2 IBM, которая поддерживается с помощью ODBC-функций.)

Требования

Поведение различных аспектов зависит от реализации конкретной БД. Такие функции как dba_optimize() и dba_sync() могут выполнять свои действия с одной БД и не выполнять - с другими. вы должны загрузить и установить поддерживаемые dba-обработчики.

Таблица 1. Список обработчиков DBA

При использовании функции dba_open() или dba_popen() имя одного из обработчиков должно быть предоставлено в качестве аргумента. Действующий список обработчиков выводится вызовом функции phpinfo().

Установка

Используя опцию конфигурации --enable-dba=shared, вы можете построить динамически загружаемый модуль, чтобы сделать возможной поддержку в РНР баз данных dbm-стиля. Вы должны также добавить поддержку для как минимум одного из следующих обработчиков, специфицировав переключатель конфигурации --with-XXXX в строке конфигурации вашего PHP.

Таблица 2. Поддерживаемые обработчики DBA

Конфигурация

Это расширение не определяет никаких директив конфигурации.

Типы ресурсов

Функции dba_open() и dba_popen() возвращают дескриптор специфицированного файла БД, который используется при вызовах всех других функций dba.

Предопределённые константы

Это расширение не определяет никаких констант.

Примеры

<?php

$id = dba_open ("/tmp/test.db", "n", "db2");

if (!$id) {
    echo "dba_open failed\n";
    exit;
}

dba_replace ("key", "This is an example!", $id);

if (dba_exists ("key", $id)) {
    echo dba_fetch ("key", $id);
    dba_delete ("key", $id);
}

dba_close ($id);
?>

DBA является binary safe (безопасным в бинарном режиме) и не имеет каких-либо ограничений. Однако он наследует все ограничения, установленные реализацией БД.

БД на основе файлов обязаны предоставлять способ установки режима файла для вновь создаваемой БД, если это вообще возможно. Режим файла/file mode обычно передаётся как четвёртый аргумент в функцию dba_open() или dba_popen().

Вы можете получить доступ ко всем вхождениям БД линеарным способом, используя функции dba_firstkey() и dba_nextkey(). Вы не можете изменять БД, проходя по ней.

<?php

// ...открыть БД...

$key = dba_firstkey ($id);

while ($key != false) {
    if (...) {          // запомнить key для выполнения в дальнейшем некоторой акции
        $handle_later[] = $key;
    }
    $key = dba_nextkey ($id);
}

for ($i = 0; $i < count($handle_later); $i++)
    dba_delete ($handle_later[$i], $id);

?>

Содержание

dba_close - закрывает БД

dba_delete - удаляет вхождение, специфицированное ключом/key

dba_exists - проверяет существование ключа

dba_fetch - извлекает данные, специфицированные ключом

dba_firstkey - извлекает первый ключ

dba_insert - вставляет вхождение

dba_nextkey - извлекает следующий ключ

dba_open - открывает БД

dba_optimize - оптимизирует БД

dba_popen - открывает БД постоянно

dba_replace - заменяет или вставляет вхождение

dba_sync - синхронизирует БД