dba_popen

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_popen — Встановити постійний екземпляр бази даних

Опис

dba_popen(    string $path,    string $mode,    ?string $handler = null,    int $permission = 0644,    int $map_size = 0,    ?int $flags = null): resource|false

dba_open() встановлює постійний екземпляр бази даних шляхом pathв режимеmode, используя обработчикhandler

Список параметрів

path

Шлях до файлів бази даних.

mode

rдля режима чтения,w для режиму читання/запису з вже існуючою базою даних . c для режиму читання/запису та створення бази даних, якщо вона ще не була створена, та n для створення, обрізання та доступу для читання/запису. База даних створюється з архітектурою BTree, інші архітектури (на зразок Hash або Queue) не підтримуються.

handler

Имяоброблювача, який буде використовуватися для доступу на шляху path. Йому передаються всі необов'язкові параметри, задані в dba_open(). Якщо параметр handlerравен**null**то викликається обробник за замовчуванням.

permission

Необов'язковий параметр, заданий цілим числом (int), який надсилається драйверу. У нього те саме значення, що й у параметра permissions функції chmod(), значение по умолчанию -0644

Драйвери db1 db2 db3 db4 dbm gdbm ndbmиlmdbподдерживают параметрpermission

map_size

Необов'язковий параметр, заданий цілим числом (int), який надсилається драйверу. Його значення має бути кратно розміру сторінки ОС або нулю, щоб використовувати розмір карти за замовчуванням.

Лише драйвер lmdbдопускает параметрmap_size

flags

Прапори передачі драйверам бази даних. Якщо вказано значення null, будуть надіслані прапори за замовчуванням. В даний час лише драйвер LMDB підтримує такі прапори: DBA_LMDB_USE_SUB_DIR і DBA_LMDB_NO_SUB_DIR

Значення, що повертаються

Повертає обробник у разі успішного виконання або **false**в случае возникновения ошибки.

Помилки

Функція повертає значення false та видає помилку рівня E_WARNING, якщо параметр handlerравен**null**але немає оброблювача за замовчуванням.

список змін

Версия	Опис
8.2.0	Добавлен параметр`flags`
8.1.0	Параметр`handler` тепер припускає значення `null`
7.3.14, 7.4.2	Драйвер `lmdb` тепер підтримує додатковий параметр `map_size`

Дивіться також

dba_open() - Відкриває базу даних
dba_close() - Закриває базу даних DBA