PHP Conference Japan 2024

dba_popen

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

dba_popen持續開啟資料庫

說明

dba_popen(
    字串 $path,
    字串 $mode,
    ?字串 $handler = null,
    整數 $permission = 0644,
    整數 $map_size = 0,
    ?整數 $flags = null
): Dba\Connection|false

dba_popen() 會使用 handler 建立一個 path 的永久資料庫實例,並以 mode 模式開啟。

參數

path

通常是檔案系統中的正規路徑。

mode

可以是 r 表示讀取存取,w 表示對現有資料庫的讀寫存取,c 表示讀寫存取,如果資料庫不存在則建立,以及 n 表示建立、截斷和讀寫存取。

handler

用於存取 path處理器 名稱。傳遞給 dba_popen() 的所有選用參數都會傳遞給它,它可以代表這些參數執行操作。如果 handlernull,則會呼叫預設處理器。

permission

選用的 整數 參數,會傳遞給驅動程式。它的意義與 chmod()permissions 參數相同,預設值為 0644

db1db2db3db4dbmgdbmndbmlmdb 驅動程式支援 permission 參數。

map_size

選用的 整數 參數,會傳遞給驅動程式。其值應為作業系統頁面大小的倍數,或零,以使用預設的 mapsize。

lmdb 驅動程式接受 map_size 參數。

flags

允許將旗標傳遞給資料庫驅動程式。目前僅支援 LMDB 的 DBA_LMDB_USE_SUB_DIRDBA_LMDB_NO_SUB_DIR

返回值

成功時返回 Dba\Connection 實例,失敗時返回 false

錯誤/例外

handlernull 但沒有預設處理器時,會返回 false 並發出 E_WARNING 等級的錯誤。

更新日誌

版本 說明
8.4.0 現在返回 Dba\Connection 實例;以前返回的是 資源
8.2.0 新增了 flags
8.1.0 handler 參數現在可以為 null。
7.3.14, 7.4.2 lmdb 驅動程式現在支援額外的 map_size 參數。

另請參閱

新增註釋

使用者提供的註釋

此頁面沒有使用者提供的註釋。
To Top