dba_popen
(PHP 4, PHP 5, PHP 7)
dba_popen — データベースを持続的にオープンする
説明
dba_popen
( string $path
, string $mode
[, string $handler
], mixed ...$args
) : resource|false
dba_popen() は、handler
を用いて mode
で path
に持続的なデータベースインスタンスを確立します。
パラメータ
path
通常のファイルシステムのパス。
mode
既存のデータベースへの読み込みアクセスには "r"、読込み/書き込み アクセスには "w" を指定します。 読み込み/書き込みアクセスおよび存在しない場合にデータベースの作成を するには "c" を、そして作成、削除、読込み/書き込みアクセス用には "n" を指定します。
handler
path
にアクセスする際に使用する ハンドラの名前。 dba_popen() に指定したすべてのオプションが 渡され、その機能を用いることができます。args
ドライバに渡すオプションの文字列の引数
cdb
,cdb_make
,flatfile
,inifile
,qdbm
およびtcadb
ドライバは 追加の引数をサポートしていません。db1
,db2
,db3
,db4
,dbm
,gdbm
, およびndbm
ドライバは 追加の引数$filemode
をサポートします。 これは、chmod() の$mode
と同じ意味です。 デフォルトは0644
です。lmdb
ドライバは追加の引数をふたつサポートします。 最初の引数は$filemode
(上の説明を見て下さい) で、 ふたつめは OS のページサイズを指定する$mapsize
で、 デフォルト値を使うには0を指定します。$mapsize
は PHP 7.3.14 と 7.4.2 以降でサポートされています。
返り値
成功した場合に正のハンドル、失敗した場合に false
を返します。