(PHP 4, PHP 5, PHP 7, PHP 8)
dba_popen — 持久打开数据库
$path
,$mode
,$handler
= null
,$permission
= 0644,$map_size
= 0,$flags
= null
dba_popen() 为 path
使用 mode
和 handler
建立一个持久化的数据库实例。
path
通常是文件系统中的常规路径。
mode
它是 r
用于读取访问,w
用于对已存在的数据库进行读写访问,c
用于读写访问并在数据库不存在时创建数据库,以及 n
用于创建、截断和读写访问。
handler
用于访问 path
的 处理程序 的名称。它会传递给 dba_popen() 的所有可选参数,并可以代表它们进行操作。如果 handler
为 null
,则调用默认处理程序。
permission
可选的 整数 参数,传递给驱动程序。它与 chmod() 的 permissions
参数具有相同的含义,默认为 0644
。
db1
、db2
、db3
、db4
、dbm
、gdbm
、ndbm
和 lmdb
驱动程序支持 permission
参数。
map_size
可选的 整数 参数,传递给驱动程序。它的值应为操作系统页面大小的倍数,或者为零,以使用默认的映射大小。
lmdb
驱动程序接受 map_size
参数。
flags
允许将标志传递给 DB 驱动程序。目前,仅支持 LMDB 的 DBA_LMDB_USE_SUB_DIR
和 DBA_LMDB_NO_SUB_DIR
。
成功时返回 Dba\Connection 实例,失败时返回 false
。
版本 | 描述 |
---|---|
8.4.0 | 现在返回 Dba\Connection 实例;以前,返回的是 资源。 |
8.2.0 |
flags 已添加。 |
8.1.0 |
handler 现在可以为 null。 |
7.3.14, 7.4.2 | lmdb 驱动程序现在支持额外的 map_size 参数。 |