(PHP 4, PHP 5, PHP 7, PHP 8)
dba_popen — Установить постоянный экземпляр базы данных
dba_open() устанавливает постоянный экземпляр базы данных по пути
path
в режиме mode
, используя
обработчик handler
.
path
Путь до файлов базы данных.
mode
r
для режима чтения, w
для
режима чтения/записи с уже существующей базой данных. c
для режима чтения/записи и создания базы данных, если она ещё не была создана,
и n
для создания, обрезания и доступа для чтения/записи.
База данных создаётся с архитектурой BTree, другие архитектуры (вроде Hash или Queue)
не поддерживаются.
handler
Имя обработчика, который будет
использоваться для доступа по пути path
. Ему передаются
все необязательные параметры, заданные в dba_open().
args
Необязательная строка (string) параметров, которые передаются драйверу.
Драйверы cdb
, cdb_make
, flatfile
,
inifile
, qdbm
и tcadb
не поддерживают дополнительные параметры.
Драйверы db1
, db2
, db3
,
db4
, dbm
, gdbm
и ndbm
поддерживают единственный дополнительный параметр $filemode
,
который имеет то же значение, что и параметр $mode
в chmod()
и по умолчанию равен 0644
.
Драйвер lmdb
принимает два дополнительных параметра. Первый
позволяет указать $filemode
(смотрите описание выше), а
второй - указать $mapsize
, где значение должно быть кратным
размеру страницы ОС или нулю, чтобы использовать размер карты по умолчанию.
Параметр $mapsize
поддерживается в PHP 7.3.14 и 7.4.2 соответственно.
Возвращает обработчик в случае успешного выполнения, или false
в случае возникновения ошибки.