導入

これらの関数は、Berkeley DB 型データベースへのアクセス用の基本関数を 構成します。

これらの関数は、複数のファイルベースのデータベース用のアブストラクション ・レイヤーです。その機能は、サポートのような近代的なデータベースの機能の サブセットに制限されています。(IBMのソフトウエアDB2と混同しないで 下さい。このデータベースは、ODBC 関数 を通じてサポートされます。)

要件

各機能の動作は、使用するデータベースの実装に依存します。 dba_optimize() および dba_sync() の ような関数は、特定のデータベースでは動作しますが、他のデータベース では機能しません。サポートされるdbaハンドラをダウンロードし、イン ストールする必要があります。

dba_open()またはdba_popen() 関数を実行する際、引数にハンドラ名の一つを指定する必要があります。 実際に利用可能なハンドラのリストは、 phpinfo() または dba_handlers()をコールした際に表示されます。

インストール手順

設定オプション--enable-dba=shared を使用することにより、dbm形式のデータベースをサポートする動的にロー ド可能なモジュールを有効にしてPHPを構築することができます。 また、PHPのconfigure行に設定スイッチ --with-XXXX を指定することにより、少なくとも以下のハンドラの一つのサポートを追加 する必要があります。

実行用の設定

この拡張モジュールは設定ディレクティブを全く定義しません。

リソース型

関数 dba_open() および dba_popen() は、指定したデータベースファイルを アクセスするためのハンドルを返します。このハンドルは、他の全ての dba関数コールで使用されます。

定義済みの定数

この拡張モジュールは定数を全く定義しません。

例

例 1. DBAの例 <?php $id = dba_open ("/tmp/test.db", "n", "db2"); if (!$id) {    echo "dba_open failed\n";    exit; } dba_replace ("key", "This is an example!", $id); if (dba_exists ("key", $id)) {    echo dba_fetch ("key", $id);    dba_delete ("key", $id); } dba_close ($id); ?>

DBAは、バイナリセーフでありいかなる制限も受けません。 DBA は、使用するデータベースの実装による全ての制約を継承します。

全てのファイルベースのデータベースは、完全に使用可能なものについて 新規に作成されたデータベースのファイルモードを設定する手段を、 提供する必要があります。 ファイルモードは、通常 dba_open() または dba_popen() に4番目の引数として渡されます。

dba_firstkey() および dba_nextkey()関数を用いて連続的に全てのエント リにアクセスすることができます。アクセスする際にデータベースを変 更できない可能性があります。

例 2. データベースへの連続アクセス <?php # ...データベースをオープンする... $key = dba_firstkey ($id);      while ($key != false) {    if (...) { # 他の操作を後で行うためにキーを記憶する        $handle_later[] = $key;    }    $key = dba_nextkey ($id); } for ($i = 0; $i < count($handle_later); $i++)    dba_delete ($handle_later[$i], $id); ?>