(PHP 4, PHP 5, PHP 7, PHP 8)
dba_popen — データベースを持続的にオープンする
$path
,$mode
,$handler
= null
,$permission
= 0644,$map_size
= 0,$flags
= null
dba_popen() は、handler
を用いて mode
で path
に持続的なデータベースインスタンスを確立します。
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
ドライバに渡されるオプションの整数パラメータ。 OS のページサイズの倍数を指定すべきです。 ゼロを指定すると、デフォルトのマップサイズが使われます。
lmdb
ドライバだけが
map_size
パラメータを受け入れます。
flags
データベースドライバに渡すフラグ。
現状、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 は、nullable になりました。
|
7.3.14, 7.4.2 |
lmdb ドライバは、
map_size パラメータを追加でサポートしました。
|