dba_popen
データベースを持続的にオープンする
&reftitle.description;
Dba\Connectionfalsedba_popen
stringpath
stringmode
stringnullhandler&null;
intpermission0644
intmap_size0
intnullflags&null;
dba_popen は、handler
を用いて mode で path
に持続的なデータベースインスタンスを確立します。
&reftitle.parameters;
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 をサポートしています。
&reftitle.returnvalues;
成功した場合に Dba\Connection インスタンスを返します。
&return.falseforfailure;。
&reftitle.errors;
handler
に &null; が指定されているのにデフォルトのハンドラが存在しない場合、
E_WARNING レベルのエラーが発生し、
&false; が返されます。
&reftitle.changelog;
&Version;
&Description;
8.4.0
Dba\Connection インスタンスを返すようになりました。
これより前のバージョンでは、&resource; を返していました。
8.2.0
flags が追加されました。
8.1.0
handler は、nullable になりました。
7.3.14, 7.4.2
lmdb ドライバは、
map_size パラメータを追加でサポートしました。
&reftitle.seealso;
dba_open
dba_close