(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 インスタンスを返すようになりました。 これより前のバージョンでは、resource を返していました。 |
| 8.2.0 |
flags が追加されました。
|
| 8.1.0 |
handler は、nullable になりました。
|
| 7.3.14, 7.4.2 |
lmdb ドライバは、
map_size パラメータを追加でサポートしました。
|