cvs: phpdoc-ja /reference/dba configure.xml reference.xml /reference/dba/functions dba-close.xml dba-delete.xml dba-exists.xml dba-fetch.xml
dba-firstkey.xml dba-handlers.xml dba-insert.xml dba-list.xml dba-nextkey.xml dba-open.xml dba-optimize.xml dba-popen.xml dba-replace.xml dba-sync.xml

From: Date: Sun, 14 Aug 2005 07:21:15 +0000
Subject: cvs: phpdoc-ja /reference/dba configure.xml reference.xml /reference/dba/functions dba-close.xml dba-delete.xml dba-exists.xml dba-fetch.xml
dba-firstkey.xml dba-handlers.xml dba-insert.xml dba-list.xml dba-nextkey.xml dba-open.xml dba-optimize.xml dba-popen.xml dba-replace.xml dba-sync.xml
Groups: php.doc.ja 
Request: Send a blank email to doc-ja+get-1124@lists.php.net to get a copy of this message
takagi Sun Aug 14 03:21:15 2005 EDT Modified files: /phpdoc-ja/reference/dba/functions dba-sync.xml dba-replace.xml dba-popen.xml dba-optimize.xml dba-open.xml dba-nextkey.xml dba-list.xml dba-insert.xml dba-handlers.xml dba-firstkey.xml dba-fetch.xml dba-exists.xml dba-delete.xml dba-close.xml /phpdoc-ja/reference/dba reference.xml configure.xml Log: sync with en.

http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-sync.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-sync.xml diff -u phpdoc-ja/reference/dba/functions/dba-sync.xml:1.4 phpdoc-ja/reference/dba/functions/dba-sync.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-sync.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-sync.xml Sun Aug 14 03:21:13 2005 @@ -1,35 +1,56 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-sync"> - <refnamediv> - <refname>dba_sync</refname> - <refpurpose>データベースを同期する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dba_sync</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_sync</function> は、<parameter>handle</parameter>で - 指定したデータベースを同期します。サポートされる場合には、おそらくディスク - への物理的アクセスへのきっかけとなることでしょう。 - </para> - <para> - <parameter>handle</parameter> は、<function>dba_open</function> により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_sync</function> は同期が成功した場合に&true;、失敗した場合に - &false;を返します。 - </para> - <para> - <function>dba_optimize</function>も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-sync"> + <refnamediv> + <refname>dba_sync</refname> + <refpurpose>データベースを同期する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_sync</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_sync</function> は + データベースを同期します。サポートされる場合には、 + おそらくディスクへの物理的アクセスへのきっかけとなることでしょう。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_optimize</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-replace.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-replace.xml diff -u phpdoc-ja/reference/dba/functions/dba-replace.xml:1.4 phpdoc-ja/reference/dba/functions/dba-replace.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-replace.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-replace.xml Sun Aug 14 03:21:13 2005 @@ -1,47 +1,78 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-replace"> - <refnamediv> - <refname>dba_replace</refname> - <refpurpose>エントリを置換または挿入する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dba_replace</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>value</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_replace</function> は、<parameter>handle</parameter>で - 指定したデータベースに<parameter>key</parameter> および - <parameter>value</parameter>で記述されるエントリを置換または挿入 - します。 - </para> - <para> - <parameter>key</parameter>は挿入するエントリのキーです。 - </para> - <para> - <parameter>value</parameter> は挿入する値です。 - </para> - <para> - <parameter>handle</parameter> は、<function>dba_open</function>により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_replace</function>は成功した場合に&true;,失敗した場合に - &false;を返します。 - </para> - <para> - <function>dba_exists</function> - <function>dba_delete</function> - <function>dba_fetch</function> - <function>dba_insert</function> も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-replace"> + <refnamediv> + <refname>dba_replace</refname> + <refpurpose>エントリを置換または挿入する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_replace</methodname> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>value</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_replace</function> は、<parameter>handle</parameter> で + 指定したデータベースに <parameter>key</parameter> および + <parameter>value</parameter> で記述されるエントリを + 置換または挿入します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + 置換するエントリのキー。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + 置換される値。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_delete</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_insert</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-popen.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-popen.xml diff -u phpdoc-ja/reference/dba/functions/dba-popen.xml:1.4 phpdoc-ja/reference/dba/functions/dba-popen.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-popen.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-popen.xml Sun Aug 14 03:21:13 2005 @@ -1,53 +1,82 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-popen"> - <refnamediv> - <refname>dba_popen</refname> - <refpurpose>データベースを持続的にオープンする</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>int</type><methodname>dba_popen</methodname> - <methodparam><type>string</type><parameter>path</parameter></methodparam> - <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - <methodparam><type></type><parameter> - <replaceable><optional>...</optional></replaceable> - </parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_popen</function> は、 <parameter>handler</parameter> - を用いて<parameter>mode</parameter>で<parameter>path</parameter> - への持続的データベースインスタンスを確立します。 - </para> - <para> - <parameter>path</parameter> は、通常のファイルシステムのパスです。 - </para> - <para> - <parameter>mode</parameter> には、既存のデータベースにアクセスする - 際に読み込みアクセス用に "r"、読込み/書き込みアクセス用に"w"を、 - 読み込み/書き込みアクセスおよび存在しない場合にデータベースの作成をする - ために"c"を、作成、上書き、読込み/書き込みアクセス用に "n" を指定 - します。 - </para> - <para> - <parameter>handler</parameter> は、<parameter>path</parameter>を - アクセスするために使用するハンドルの名前です。 - <function>dba_popen</function> に指定した全てのオプションパラメータを - 渡し、そのオプションの機能を用いることができます。 - </para> - <para> - <function>dba_popen</function> は、オープンに成功した場合に正の - ハンドラID、失敗した場合に&false;を返します。 - </para> - <para> - <function>dba_open</function>、 - <function>dba_close</function>も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-popen"> + <refnamediv> + <refname>dba_popen</refname> + <refpurpose>データベースを持続的にオープンする</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>resource</type><methodname>dba_popen</methodname> + <methodparam><type>string</type><parameter>path</parameter></methodparam> + <methodparam><type>string</type><parameter>mode</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>handler</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_popen</function> は、<parameter>handler</parameter> + を用いて <parameter>mode</parameter> で <parameter>path</parameter> + に持続的なデータベースインスタンスを確立します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>path</parameter></term> + <listitem> + <para> + 通常のファイルシステムのパス。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + 既存のデータベースへの読み込みアクセスには "r"、読込み/書き込み + アクセスには "w" を指定します。 + 読み込み/書き込みアクセスおよび存在しない場合にデータベースの作成を + するには "c" を、そして作成、削除、読込み/書き込みアクセス用には + "n" を指定します。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>handler</parameter></term> + <listitem> + <para> + <parameter>path</parameter> にアクセスする際に使用する + <link linkend="dba.requirements">ハンドラ</link>の名前。 + <function>dba_popen</function> に指定したすべてのオプションが + 渡され、その機能を用いることができます。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + 成功した場合に正のハンドル、失敗した場合に &false; を返します。 + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_open</function></member> + <member><function>dba_close</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-optimize.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-optimize.xml diff -u phpdoc-ja/reference/dba/functions/dba-optimize.xml:1.4 phpdoc-ja/reference/dba/functions/dba-optimize.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-optimize.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-optimize.xml Sun Aug 14 03:21:13 2005 @@ -1,35 +1,54 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-optimize"> - <refnamediv> - <refname>dba_optimize</refname> - <refpurpose>データベースを最適化する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dba_optimize</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_optimize</function> は、<parameter>handle</parameter> - により指定されたデータベースを最適化します。 - </para> - <para> - <parameter>handle</parameter> は、<function>dba_open</function> により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_optimize</function> は、最適化に成功した場合に&true;, - 失敗した場合に&false;を返します。 - </para> - <para> - <function>dba_sync</function>も参照ください。 - </para> - - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-optimize"> + <refnamediv> + <refname>dba_optimize</refname> + <refpurpose>データベースを最適化する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_optimize</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_optimize</function> は、指定されたデータベースを最適化します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_sync</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-open.xml?r1=1.5&r2=1.6&ty=u Index: phpdoc-ja/reference/dba/functions/dba-open.xml diff -u phpdoc-ja/reference/dba/functions/dba-open.xml:1.5 phpdoc-ja/reference/dba/functions/dba-open.xml:1.6 --- phpdoc-ja/reference/dba/functions/dba-open.xml:1.5 Thu Jan 27 06:07:37 2005 +++ phpdoc-ja/reference/dba/functions/dba-open.xml Sun Aug 14 03:21:13 2005 @@ -1,173 +1,229 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.5 $ --> -<!-- EN-Revision: 1.12 Maintainer: hirokawa Status: ready --> +<!-- $Revision: 1.6 $ --> +<!-- EN-Revision: 1.17 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <refentry id="function.dba-open"> <refnamediv> <refname>dba_open</refname> <refpurpose>データベースをオープンする</refpurpose> </refnamediv> - <refsect1> - <title>説明</title> + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>resource</type><methodname>dba_open</methodname> <methodparam><type>string</type><parameter>path</parameter></methodparam> <methodparam><type>string</type><parameter>mode</parameter></methodparam> - <methodparam><type>string</type><parameter>handler</parameter></methodparam> - <methodparam choice="opt"><parameter>...</parameter></methodparam> + <methodparam choice="opt"><type>string</type><parameter>handler</parameter></methodparam> + <methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam> </methodsynopsis> <para> - <function>dba_open</function>は、<parameter>handler</parameter>を用いて - <parameter>mode</parameter>を指定し、<parameter>path</parameter> への - データベースインスタンスを生成します。 - </para> - <para> - <parameter>path</parameter>は、ファイルシステムの通常のパスです。 + <function>dba_open</function> は、<parameter>handler</parameter> を用いて + <parameter>mode</parameter> を指定し、<parameter>path</parameter> + にデータベースインスタンスを生成します。 </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; <para> - <parameter>mode</parameter>には、既存のデータベースにアクセスする - 際に読み込みアクセス用に "r"、読込み/書き込みアクセス用に"w"を、 - 読み込み/書き込みアクセスおよび存在しない場合にデータベースの作成をする - ために"c"を、作成、上書き、読込み/書き込みアクセス用に "n" を指定 - します。さらに次の文字でデータベースをロックする方法を指定することができます。 - <filename>.lck</filename>でデータベースをロックする場合には"l"、 - データベースファイル自体をロックする場合は"d"を使用してください。 - 全てのアプリケーションで統一した方法を用いることが重要です。 - アクセスのテストを行う際にロックのために待ちたくない場合、"t"を3番目の文字に追加する - ことができます。明らかにデータベースのロックが不要な場合には、"l"や"d"の代わりに - "-"を使用してロックを行わないことができます。 - "d"、"l"または"-"のどれも指定されない場合、"d"が指定されたものとして - データベースファイルをロックします。 + <variablelist> + <varlistentry> + <term><parameter>path</parameter></term> + <listitem> + <para> + 通常のファイルシステムのパス。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>mode</parameter></term> + <listitem> + <para> + 既存のデータベースへの読み込みアクセスには "r"、読込み/書き込み + アクセスには "w" を指定します。 + 読み込み/書き込みアクセスおよび存在しない場合にデータベースの作成を + するには "c" を、そして作成、削除、読込み/書き込みアクセス用には + "n" を指定します。 + </para> + <para> + さらに、次の文字でデータベースのロック方法を指定することができます。 + <filename>.lck</filename> でデータベースをロックする場合には "l"、 + データベースファイル自体をロックする場合は "d" を使用してください。 + アプリケーション全体で統一した方法を用いることが重要です。 + </para> + <para> + アクセスのテストを行う際にロックのために待ちたくない場合、"t" を + 3 番目の文字に追加することができます。明らかにデータベースのロックが + 不要な場合には、"l" や "d" の代わりに "-" を使用してロックを + 行わないことができます。"d"、"l" または "-" のどれも指定されない場合、 + "d"が指定されたものとしてデータベースファイルをロックします。 + </para> + <note> + <para> + ひとつのデータベースファイルに同時に書き込めるのは、ひとつだけです。 + dba を Web サーバで使用している際に複数のリクエストが書き込み処理を + 行う必要がある場合、他の書き込みが終わってからでないと次の書き込みを + 行うことができません。また、書き込み中に読み込むことはできません。 + dba 拡張モジュールは、このようなことを防止するためにロックを使用します。 + 以下の表を参照してください: + <table> + <title>DBA のロック処理</title> + <tgroup cols="9"> + <thead> + <row> + <entry>既にオープンしているデータベース</entry> + <entry><parameter>mode</parameter> = "rl"</entry> + <entry><parameter>mode</parameter> = "rlt"</entry> + <entry><parameter>mode</parameter> = "wl"</entry> + <entry><parameter>mode</parameter> = "wlt"</entry> + <entry><parameter>mode</parameter> = "rd"</entry> + <entry><parameter>mode</parameter> = "rdt"</entry> + <entry><parameter>mode</parameter> = "wd"</entry> + <entry><parameter>mode</parameter> = "wdt"</entry> + </row> + </thead> + <tbody> + <row> + <entry>not open</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>ok</entry> + </row> + <row> + <entry><parameter>mode</parameter> = "rl"</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>wait</entry> + <entry>false</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + </row> + <row> + <entry><parameter>mode</parameter> = "wl"</entry> + <entry>wait</entry> + <entry>false</entry> + <entry>wait</entry> + <entry>false</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + </row> + <row> + <entry><parameter>mode</parameter> = "rd"</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>ok</entry> + <entry>ok</entry> + <entry>wait</entry> + <entry>false</entry> + </row> + <row> + <entry><parameter>mode</parameter> = "wd"</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>illegal</entry> + <entry>wait</entry> + <entry>false</entry> + <entry>wait</entry> + <entry>false</entry> + </row> + </tbody> + </tgroup> + </table> + <simplelist> + <member>ok: 2 番目のコールは成功します。</member> + <member>wait: 2 番目のコールは、最初のデータベースで <function>dba_close</function> がコールされるまで待ちます。</member> + <member>false: 2 番目のコールは、false を返します。</member> + <member>illegal: <parameter>mode</parameter> パラメータで "l" および "d" を同時に使用することはできません。</member> + </simplelist> + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>handler</parameter></term> + <listitem> + <para> + <parameter>path</parameter> にアクセスする際に使用する + <link linkend="dba.requirements">ハンドラ</link>の名前。 + <function>dba_open</function> に指定したすべてのオプションが + 渡され、その機能を用いることができます。 + </para> + </listitem> + </varlistentry> + </variablelist> </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; <para> - <parameter>handler</parameter> は、 - <link linkend="dba.requirements">ハンドラ名</link>で、 - <parameter>path</parameter>をアクセスする際に使用することができます。 - このハンドラには、<function>dba_open</function> に指定した全てのオプション - パラメータが渡され、そのオプションの機能を用いることができます。 + 成功した場合に正のハンドル、失敗した場合に &false; を返します。 </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; <para> - <function>dba_open</function> は、オープンに成功した場合に正の - ハンドラID、失敗した場合に&false;を返します。 + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3.0</entry> + <entry> + ネットワーク接続されたデータベースファイルをオープンすることができます。 + しかし、(http や ftp のような)ソケット接続が使用された場合、 + リソース自体ではなくこの接続がロックされます。このような場合、 + このリソースに関してのロック処理は単に無視されることになり、 + 他の解決策を見付ける必要があることに留意する必要があります。 + </entry> + </row> + <row> + <entry>4.3.0</entry> + <entry> + ロック処理と <parameter>mode</parameter> 修正子 "l", "d", "-", "t" + が追加されました。 + 以前のバージョンの PHP では、GDBM 以外のデータベースハンドラで + 同時データベースアクセスに対する保護を行うためには、セマフォを + 使用する必要がありました。 + <link linkend="ref.sem">System V セマフォサポート</link> を参照ください。 + </entry> + </row> + <row> + <entry>4.3.5 以前</entry> + <entry> + オープンモード 'c' はいくつかの内部ハンドラでは正常に動作せず、 + 既存のデータベースにデータを追加するのではなく、データベースを + 切り捨ててしまっていました。また、dbm と ndbm は典型的な設定で + モード 'c' の処理が正常に動作しません(これは修正できません)。 + </entry> + </row> + </tbody> + </tgroup> + </informaltable> </para> - <note> - <para> - 特定のデータベースファイルに同時に書き込めるのは、一つだけです。 - dbaをWebサーバで使用している際に複数のリクエストが書き込み処理を - 行う必要がある場合、他の書き込みが終わってからでないと次の書き込みを行うことが - できません。また、書き込み時に読み込むことはできません。 - dbaエクステンションは、このようなことを防止するためにロックを使用します。 - 以下の表を参照してください: - <table> - <title>DBAのロック処理</title> - <tgroup cols="9"> - <thead> - <row> - <entry>already open</entry> - <entry><parameter>mode</parameter> = "rl"</entry> - <entry><parameter>mode</parameter> = "rlt"</entry> - <entry><parameter>mode</parameter> = "wl"</entry> - <entry><parameter>mode</parameter> = "wlt"</entry> - <entry><parameter>mode</parameter> = "rd"</entry> - <entry><parameter>mode</parameter> = "rdt"</entry> - <entry><parameter>mode</parameter> = "wd"</entry> - <entry><parameter>mode</parameter> = "wdt"</entry> - </row> - </thead> - <tbody> - <row> - <entry>not open</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>ok</entry> - </row> - <row> - <entry><parameter>mode</parameter> = "rl"</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>wait</entry> - <entry>false</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - </row> - <row> - <entry><parameter>mode</parameter> = "wl"</entry> - <entry>wait</entry> - <entry>false</entry> - <entry>wait</entry> - <entry>false</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - </row> - <row> - <entry><parameter>mode</parameter> = "rd"</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>ok</entry> - <entry>ok</entry> - <entry>wait</entry> - <entry>false</entry> - </row> - <row> - <entry><parameter>mode</parameter> = "wd"</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>illegal</entry> - <entry>wait</entry> - <entry>false</entry> - <entry>wait</entry> - <entry>false</entry> - </row> - </tbody> - </tgroup> - </table> - <simplelist> - <member>ok: 2番目のコールに成功します。</member> - <member>wait: 2番目のコールは、最初のコールで<function>dba_close</function>がコールされるまで待ちます。</member> - <member>false: 2番目のコールは、falseを返します。</member> - <member>illegal: <parameter>mode</parameter>パラメータで"l" および "d" 修正子を混用することはできません。</member> - </simplelist> - </para> - </note> - <note> - <para> - PHP 4.3.0以降、ネットワーク接続されたデータベースファイルをオープンすることができます。 - しかし、(httpまたはftpのような)ソケット接続が使用された場合、リソース自体ではなくこの接続が - ロックされます。このような場合、このリソースに関してロック処理は単に無視されることになり、 - 他の解決策を見付ける必要があることに留意する必要があります。 - </para> - </note> - <note> - <para> - ロック処理と<parameter>mode</parameter>修正子 "l", "d", "-" および "t" は、 - PHP 4.3.0で追加されました。 - PHP 4.3.0より前のバージョンのPHPでは、 GDBMを除くデータベースハンドラで - 同時データベースアクセスに対する保護を行うためには、セマフォを使用する必要がありました。 - <link linkend="ref.sem">System V セマフォサポート</link>を参照してください。 - </para> - </note> - <note> - <para> - PHP 4.3.5までは、オープンモード'c'は、いくつかの内部ハンドラでは正常に動作せず、 - 既存のデータベースにデータを追加するのではなく、データベースを切り捨ててしまっていました。 - また、dbm と ndbm は典型的な設定でモード'c'の処理が正常に動作しません。 - (これは修正できません) - </para> - </note> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; <para> - <function>dba_popen</function>、 - <function>dba_close</function>も参照ください。 + <simplelist> + <member><function>dba_popen</function></member> + <member><function>dba_close</function></member> + </simplelist> </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-nextkey.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-nextkey.xml diff -u phpdoc-ja/reference/dba/functions/dba-nextkey.xml:1.4 phpdoc-ja/reference/dba/functions/dba-nextkey.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-nextkey.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-nextkey.xml Sun Aug 14 03:21:13 2005 @@ -1,34 +1,57 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-nextkey"> - <refnamediv> - <refname>dba_nextkey</refname> - <refpurpose>次のキーを取得する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>string</type><methodname>dba_nextkey</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_nextkey</function> は、<parameter>handle</parameter> - が指すデータベースのキーを返し、内部ポインタを進めます。 - </para> - <para> - <parameter>handle</parameter>は、<function>dba_open</function> により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_nextkey</function> は成功時にキーを、失敗した場合に - &false;を返します。 - </para> - <para> - <function>dba_firstkey</function>も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-nextkey"> + <refnamediv> + <refname>dba_nextkey</refname> + <refpurpose>次のキーを取得する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dba_nextkey</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_nextkey</function> は、 + が指すデータベースの次のキーを返し、内部キーポインタを進めます。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + 成功した場合にキー、失敗した場合に &false; を返します。 + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_firstkey</function></member> + <member><function>dba_key_split</function></member> + <member><link linkend="dba.examples">DBA の例</link>の例 2</member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-list.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/dba/functions/dba-list.xml diff -u phpdoc-ja/reference/dba/functions/dba-list.xml:1.1 phpdoc-ja/reference/dba/functions/dba-list.xml:1.2 --- phpdoc-ja/reference/dba/functions/dba-list.xml:1.1 Sun Dec 22 09:42:18 2002 +++ phpdoc-ja/reference/dba/functions/dba-list.xml Sun Aug 14 03:21:13 2005 @@ -1,21 +1,28 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 --> +<!-- EN-Revision: 1.4 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <refentry id="function.dba-list"> <refnamediv> <refname>dba_list</refname> - <refpurpose>オープンされているデータベースファイルを全リストを得る</refpurpose> + <refpurpose>オープンされている全データベースファイルのリストを得る</refpurpose> </refnamediv> - <refsect1> - <title>説明</title> + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>array</type><methodname>dba_list</methodname> <void/> </methodsynopsis> <para> - <function>dba_list</function>は、オープンされている全てのデータベー - スファイルの一覧を連想配列として返します。この配列は、 - <literal>resourceid=&gt;filename</literal>の形式です。 + <function>dba_list</function> は、オープンされている全ての + データベースファイルの一覧を返します。 + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + <literal>resourceid =&gt; filename</literal> 形式の連想配列を返します。 </para> </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-insert.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-insert.xml diff -u phpdoc-ja/reference/dba/functions/dba-insert.xml:1.4 phpdoc-ja/reference/dba/functions/dba-insert.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-insert.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-insert.xml Sun Aug 14 03:21:13 2005 @@ -1,47 +1,79 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-insert"> - <refnamediv> - <refname>dba_insert</refname> - <refpurpose>エントリを挿入する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dba_insert</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>string</type><parameter>value</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_insert</function>は、<parameter>handle</parameter> - が指すデータベースに<parameter>key</parameter> および - <parameter>value</parameter>で記述されるエントリを挿入します。 - 同じ<parameter>key</parameter>が既に存在する場合に失敗します。 - </para> - <para> - <parameter>key</parameter>は、挿入するエントリのキーです。 - </para> - <para> - <parameter>value</parameter>は、挿入するエントリの値です。 - </para> - <para> - <parameter>handle</parameter>は、<function>dba_open</function>に - より返されたデータベースハンドルです。 - </para> - <para> - <function>dba_insert</function>は成功時に&true;、失敗した場合に&false;を - 返します。 - </para> - <para> - <function>dba_exists</function> - <function>dba_delete</function> - <function>dba_fetch</function> - <function>dba_replace</function> も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-insert"> + <refnamediv> + <refname>dba_insert</refname> + <refpurpose>エントリを挿入する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_insert</methodname> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>value</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_insert</function> は、 + データベースに <parameter>key</parameter> および + <parameter>value</parameter> で記述されるエントリを挿入します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + 挿入するエントリのキー。もしこのキーが既にデータベースに存在する場合、 + この関数は失敗します。既存のキーを置き換える場合は、 + <function>dba_replace</function> を使用してください。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>value</parameter></term> + <listitem> + <para> + 挿入する値。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_delete</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_replace</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-handlers.xml?r1=1.1&r2=1.2&ty=u Index: phpdoc-ja/reference/dba/functions/dba-handlers.xml diff -u phpdoc-ja/reference/dba/functions/dba-handlers.xml:1.1 phpdoc-ja/reference/dba/functions/dba-handlers.xml:1.2 --- phpdoc-ja/reference/dba/functions/dba-handlers.xml:1.1 Sun Dec 22 09:42:18 2002 +++ phpdoc-ja/reference/dba/functions/dba-handlers.xml Sun Aug 14 03:21:13 2005 @@ -1,26 +1,87 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <!-- splitted from ./en/functions/dba.xml, last change in rev 1.2 --> +<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <refentry id="function.dba-handlers"> <refnamediv> <refname>dba_handlers</refname> <refpurpose>利用可能なハンドラの一覧を得る</refpurpose> </refnamediv> - <refsect1> - <title>説明</title> + <refsect1 role="description"> + &reftitle.description; <methodsynopsis> <type>array</type><methodname>dba_handlers</methodname> - <void/> + <methodparam choice="opt"><type>bool</type><parameter>full_info</parameter></methodparam> </methodsynopsis> <para> - <function>dba_handlers</function>は、この拡張モジュールによりサポー - トされる全てのハンドラを有する配列を返します。 + <function>dba_handlers</function> は、この拡張モジュールにより + サポートされる全てのハンドラの一覧を返します。 </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; <para> - 内部のcdbライブラリが使用される際には、'cdb'および'cdb_make'が出力 - されます。 + <variablelist> + <varlistentry> + <term><parameter>full_info</parameter></term> + <listitem> + <para> + 結果の全ての情報を表示するかどうかを切り替えます。 + デフォルトは &false; です。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + データベースハンドラの配列を返します。<parameter>full_info</parameter> が + &true; の場合、この配列はハンドラ名をキー、そのバージョンを値とする + 連想配列となります。それ以外の場合はハンドラ名を値に持つ数値添字の配列と + なります。 + </para> + <note> + <para> + cdb ライブラリが用いられている場合、 + <literal>cdb</literal> および <literal>cdb_make</literal> が表示されます。 + </para> + </note> + </refsect1> + <refsect1 role="examples"> + &reftitle.examples; + <para> + <example> + <title><function>dba_handlers</function> の例</title> + <programlisting role="php"> +<![CDATA[ +<?php + +echo "Available DBA handlers:\n"; +foreach (dba_handlers(true) as $handler_name => $handler_version) { + // バージョン番号を見やすくする + $handler_version = str_replace('$', '', $handler_version); + echo " - $handler_name: $handler_version\n"; +} + +?> +]]> + </programlisting> + &example.outputs.similar; + <screen> +<![CDATA[ +Available DBA handlers: + - cdb: 0.75, Revision: 1.3.2.3 + - cdb_make: 0.75, Revision: 1.2.2.4 + - db2: Sleepycat Software: Berkeley DB 2.7.7: (08/20/99) + - inifile: 1.0, Revision: 1.6.2.3 + - flatfile: 1.0, Revision: 1.5.2.4 +]]> + </screen> + </example> </para> - </refsect1> </refentry> http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-firstkey.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-firstkey.xml diff -u phpdoc-ja/reference/dba/functions/dba-firstkey.xml:1.4 phpdoc-ja/reference/dba/functions/dba-firstkey.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-firstkey.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-firstkey.xml Sun Aug 14 03:21:13 2005 @@ -1,35 +1,58 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-firstkey"> - <refnamediv> - <refname>dba_firstkey</refname> - <refpurpose>最初のキーを取得する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>string</type><methodname>dba_firstkey</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_firstkey</function>は、<parameter>handle</parameter>が - 指すデータベースの最初のキーを返し、内部キーポインタをリセットします。 - この関数によりデータベース全体を連続的にサーチすることが可能になります。 - </para> - <para> - <parameter>handle</parameter>は、<function>dba_open</function>により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_firstkey</function>は成功した場合にキーを、失敗した場合に - &false;を返します。 - </para> - <para> - <function>dba_nextkey</function>も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.7 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-firstkey"> + <refnamediv> + <refname>dba_firstkey</refname> + <refpurpose>最初のキーを取得する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dba_firstkey</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_firstkey</function> はデータベースの最初のキーを返し、 + 内部キーポインタをリセットします。 + この関数によりデータベース全体を連続的にサーチすることが可能になります。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + 成功した場合にキー、失敗した場合に &false; を返します。 + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_nextkey</function></member> + <member><function>dba_key_split</function></member> + <member><link linkend="dba.examples">DBA の例</link>の例 2</member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-fetch.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-fetch.xml diff -u phpdoc-ja/reference/dba/functions/dba-fetch.xml:1.4 phpdoc-ja/reference/dba/functions/dba-fetch.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-fetch.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-fetch.xml Sun Aug 14 03:21:13 2005 @@ -1,42 +1,117 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-fetch"> - <refnamediv> - <refname>dba_fetch</refname> - <refpurpose>キーが指すデータを取得する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>string</type><methodname>dba_fetch</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_fetch</function>は、<parameter>handle</parameter> - が指すデータベースから<parameter>key</parameter>が指すデータを取 - 得します。 - </para> - <para> - <parameter>key</parameter>はデータを取得するキーです。 - </para> - <para> - <parameter>handle</parameter>は、<function>dba_open</function>により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_fetch</function> はキー/データの組が見つかった場合に - 取得した文字列、見つからなかった場合に&false;を返します。 - </para> - <para> - <function>dba_exists</function>、 - <function>dba_delete</function>、 - <function>dba_insert</function>、 - <function>dba_replace</function> も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.9 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-fetch"> + <refnamediv> + <refname>dba_fetch</refname> + <refpurpose>キーが指すデータを取得する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>string</type><methodname>dba_fetch</methodname> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <methodsynopsis> + <type>string</type><methodname>dba_fetch</methodname> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>int</type><parameter>skip</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_fetch</function> は、<parameter>handle</parameter> + が指すデータベースから <parameter>key</parameter> が指すデータを + 取得します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + データを取得するキー。 + </para> + <note> + <para> + inifile を利用する際には、この関数は配列を受け入れることが可能です。 + インデックス 0 にはグループ名、インデックス 1 には値の名前を格納します。 + <function>dba_key_split</function> も参照ください。 + </para> + </note> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>skip</parameter></term> + <listitem> + <para> + dba データベースを使用する際に無視する キー / 値 の組み合わせ数。 + 複数のキーに同じ名前をつけることがサポートされていないデータベースです、 + この値は無視されます。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + キー / データの組が見つかった場合にそれに関連する文字列、 + それ以外の場合に &false; を返します。 + </para> + </refsect1> + <refsect1 role="changelog"> + &reftitle.changelog; + <para> + <informaltable> + <tgroup cols="2"> + <thead> + <row> + <entry>&Version;</entry> + <entry>&Description;</entry> + </row> + </thead> + <tbody> + <row> + <entry>4.3</entry> + <entry> + 複数のキーに同じ名前をつけられる cdb の機能に対応するため、 + <parameter>skip</parameter> パラメータが使用可能になりました。 + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_delete</function></member> + <member><function>dba_insert</function></member> + <member><function>dba_replace</function></member> + <member><function>dba_key_split</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-exists.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-exists.xml diff -u phpdoc-ja/reference/dba/functions/dba-exists.xml:1.4 phpdoc-ja/reference/dba/functions/dba-exists.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-exists.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-exists.xml Sun Aug 14 03:21:13 2005 @@ -1,42 +1,67 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-exists"> - <refnamediv> - <refname>dba_exists</refname> - <refpurpose>キーが存在するかどうかを確認する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dba_exists</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_exists</function>は<parameter>handle</parameter> - が指すデータベースに指定した - <parameter>key</parameter>が存在するかどうかを確認します。 - </para> - <para> - <parameter>key</parameter>は確認を行うキーです。 - </para> - <para> - <parameter>handle</parameter>は、<function>dba_open</function>により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_exists</function>はキーがある場合に&true;,見つからな - い場合に&false;を返します。 - </para> - <para> - <function>dba_fetch</function>、 - <function>dba_delete</function>、 - <function>dba_insert</function>、 - <function>dba_replace</function> も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.5 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-exists"> + <refnamediv> + <refname>dba_exists</refname> + <refpurpose>キーが存在するかどうかを確認する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_exists</methodname> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_exists</function> は、指定した <parameter>key</parameter> + がデータベースに存在するかどうかを確認します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + 確認を行うキー。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + キーが存在する場合に &true; 、それ以外の場合に &false; を返します。 + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_delete</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_insert</function></member> + <member><function>dba_replace</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-delete.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-delete.xml diff -u phpdoc-ja/reference/dba/functions/dba-delete.xml:1.4 phpdoc-ja/reference/dba/functions/dba-delete.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-delete.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-delete.xml Sun Aug 14 03:21:13 2005 @@ -1,42 +1,67 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-delete"> - <refnamediv> - <refname>dba_delete</refname> - <refpurpose>キーが指すエントリを削除する</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>bool</type><methodname>dba_delete</methodname> - <methodparam><type>string</type><parameter>key</parameter></methodparam> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_delete</function> は、<parameter>handle</parameter> - が指すデータベースから <parameter>key</parameter> が指すエントリを - 削除します。 - </para> - <para> - <parameter>key</parameter>は削除するエントリのキーです。 - </para> - <para> - <parameter>handle</parameter> は、<function>dba_open</function>により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_delete</function> は、エントリが削除または削除されない - 場合にそれぞれ&true;または&false;を返します。 - </para> - <para> - <function>dba_exists</function>, - <function>dba_fetch</function>, - <function>dba_insert</function>, - <function>dba_replace</function>も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-delete"> + <refnamediv> + <refname>dba_delete</refname> + <refpurpose>キーが指す DBA エントリを削除する</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>bool</type><methodname>dba_delete</methodname> + <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_delete</function> は、指定されたエントリを + データベースから削除します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>key</parameter></term> + <listitem> + <para> + 削除するエントリのキー。 + </para> + </listitem> + </varlistentry> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.success; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_exists</function></member> + <member><function>dba_fetch</function></member> + <member><function>dba_insert</function></member> + <member><function>dba_replace</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/functions/dba-close.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/functions/dba-close.xml diff -u phpdoc-ja/reference/dba/functions/dba-close.xml:1.4 phpdoc-ja/reference/dba/functions/dba-close.xml:1.5 --- phpdoc-ja/reference/dba/functions/dba-close.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/functions/dba-close.xml Sun Aug 14 03:21:13 2005 @@ -1,35 +1,56 @@ <?xml version="1.0" encoding="utf-8"?> +<!-- $Revision: 1.5 $ --> <!-- splitted from ./ja/functions/dba.xml, last change in rev 1.1 --> -<!-- EN-Revision: 1.2 Maintainer: hirokawa Status: ready --> - <refentry id="function.dba-close"> - <refnamediv> - <refname>dba_close</refname> - <refpurpose>データベースを閉じる</refpurpose> - </refnamediv> - <refsect1> - <title>説明</title> - <methodsynopsis> - <type>void</type><methodname>dba_close</methodname> - <methodparam><type>int</type><parameter>handle</parameter></methodparam> - </methodsynopsis> - <para> - <function>dba_close</function>は使用するデータベースを閉じ、 - <parameter>handle</parameter>により指定した全てのリソースを - 開放します。 - </para> - <para> - <parameter>handle</parameter>は、<function>dba_open</function>により - 返されたデータベースハンドルです。 - </para> - <para> - <function>dba_close</function>は値を返しません。 - </para> - <para> - <function>dba_open</function>、 - <function>dba_popen</function>も参照ください。 - </para> - </refsect1> - </refentry> +<!-- EN-Revision: 1.6 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> +<refentry id="function.dba-close"> + <refnamediv> + <refname>dba_close</refname> + <refpurpose>DBA データベースを閉じる</refpurpose> + </refnamediv> + <refsect1 role="description"> + &reftitle.description; + <methodsynopsis> + <type>void</type><methodname>dba_close</methodname> + <methodparam><type>resource</type><parameter>handle</parameter></methodparam> + </methodsynopsis> + <para> + <function>dba_close</function> は確立されたデータベースを閉じ、 + により指定したデータベースハンドルの全てのリソースを開放します。 + </para> + </refsect1> + <refsect1 role="parameters"> + &reftitle.parameters; + <para> + <variablelist> + <varlistentry> + <term><parameter>handle</parameter></term> + <listitem> + <para> + <function>dba_open</function> あるいは <function>dba_popen</function> + によって返されたデータベースハンドル。 + </para> + </listitem> + </varlistentry> + </variablelist> + </para> + </refsect1> + <refsect1 role="returnvalues"> + &reftitle.returnvalues; + <para> + &return.void; + </para> + </refsect1> + <refsect1 role="seealso"> + &reftitle.seealso; + <para> + <simplelist> + <member><function>dba_open</function></member> + <member><function>dba_popen</function></member> + </simplelist> + </para> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/reference.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/reference.xml diff -u phpdoc-ja/reference/dba/reference.xml:1.4 phpdoc-ja/reference/dba/reference.xml:1.5 --- phpdoc-ja/reference/dba/reference.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/reference.xml Sun Aug 14 03:21:14 2005 @@ -1,138 +1,165 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.24 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <reference id="ref.dba"> - <title>(dbm型の)データベース・アブストラクション レイヤー関数</title> + <title>(dbm 型の)データベース抽象化レイヤ関数</title> <titleabbrev>dba</titleabbrev> - + <partintro> <section id="dba.intro"> &reftitle.intro; - <para> + <para> これらの関数は、Berkeley DB 型データベースへのアクセス用の基本関数を 構成します。 - </para> - <para> - これらの関数は、複数のファイルベースのデータベース用のアブストラクション - ・レイヤーです。その機能は、<ulink url="&url.sleepycat;">Sleepycat - Software's DB2</ulink>サポートのような近代的なデータベースの機能の - サブセットに制限されています。(IBMのソフトウエアDB2と混同しないで - ください。このデータベースは、<link linkend="ref.odbc">ODBC 関数 - </link>を通じてサポートされます。) - </para> - </section> + </para> + <para> + これらの関数は、複数のファイルベースのデータベース用の抽象化レイヤです。 + その機能は、<ulink url="&url.sleepycat;">Sleepycat + Software's DB2</ulink> でサポートされているような近代的なデータベースの + 機能のサブセットに制限されています(IBM の DB2 と混同しないでください。 + このデータベースは、<link linkend="ref.odbc">ODBC 関数 + </link>を通じてサポートされます)。 + </para> + </section> <section id="dba.requirements"> &reftitle.required; <para> 各機能の動作は、使用するデータベースの実装に依存します。 - <function>dba_optimize</function> および <function>dba_sync</function> の - ような関数は、特定のデータベースでは動作しますが、他のデータベース - では機能しません。サポートされるdbaハンドラをダウンロードし、イン - ストールする必要があります。 - <table> - <title>DBAハンドラのリスト</title> - <tgroup cols="2"> - <thead> - <row> - <entry>ハンドラ</entry> - <entry>注意</entry> - </row> - </thead> - <tbody> - <row> - <entry><literal>dbm</literal></entry> - <entry> - dbm は最も古い(元祖の)Berkeley DB 型データベースです。可能なら - ば使用しない方が良いでしょう。DB2およびgdbmに組み込まれている互 - 換性を保つための関数は、サポートされません。これは、実装されて - いるのがソースレベルの互換性のみであり、元のdbmフォーマットを処 - 理することができないためです。 - </entry> - </row> - - <row> - <entry><literal>ndbm</literal></entry> - <entry> - ndbm は、より新型であり、dbmよりも柔軟です。 - dbm固有の制約の多くをまだ有しています。(そのため、古い実装です。) - </entry> - </row> - - <row> - <entry><literal>gdbm</literal></entry> - <entry> - gdbmは、<ulink url="&url.gdbm;">GNUデータベースマネージャ - </ulink>です。 - </entry> - </row> - - <row> - <entry><literal>db2</literal></entry> - <entry> - DB2 は、<ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink> - です。これは、「スタンドアローンおよびクライアント/サーバー - アプリケーションの両方で高性能な組込みデータベースサポートを提供する - プログラム用ツールキット」として記述されています。 - </entry> - </row> - - <row> - <entry><literal>db3</literal></entry> - <entry> - DB3 は、<ulink url="&url.sleepycat;">Sleepycat Softwareの - DB3</ulink>です。 - </entry> - </row> - - <row> - <entry><literal>db4</literal></entry> - <entry> - DB4 は、<ulink url="&url.sleepycat;">Sleepycat Software's - DB4</ulink>です。これは、PHP 4.4.0以降で利用可能です。 - </entry> - </row> - - <row> - <entry><literal>cdb</literal></entry> - <entry> - cdbは、固定データベースの作成・読込み用の高速で高信頼性の軽量型 - パッケージです。これは、qmailの作者によるものであり、<ulink - url="&url.cdb;">ここ</ulink>にあります。固定であるため、読込 - み操作のみがサポートされます。 - PHP 4.3.0以降、内部的なcdbライブラリにより(更新ではなく)書き - 込みがサポートされています。 - </entry> - </row> - - <row> - <entry><literal>cdb_make</literal></entry> - <entry> - PHP 4.3.0以降、付属するcdbライブラリを使用する場合にcdbファ - イルの(更新ではなく)作成をサポートします。 - </entry> - </row> - - <row> - <entry><literal>flatfile</literal></entry> - <entry> - これは、PHP 4.3.0以降で利用可能で、古い - <link linkend="ref.dbm">dbm</link> 拡張モジュールとの互換性 - のためのものであり、使用するべきではありません。 - しかし、ファイルがこの形式で作成された場所でこれを使用するこ - とができます。これは、configureが外部ライブラリを見付けるこ - とができない場合に生じます。 - </entry> - </row> - </tbody> - </tgroup> - </table> + <function>dba_optimize</function> および <function>dba_sync</function> + のような関数は、特定のデータベースでは動作しますが、他のデータベースでは + 機能しません。サポートされるdbaハンドラをダウンロードし、インストールする + 必要があります。 + <table> + <title>DBAハンドラのリスト</title> + <tgroup cols="2"> + <thead> + <row> + <entry>ハンドラ</entry> + <entry>注意</entry> + </row> + </thead> + <tbody> + <row> + <entry><literal>dbm</literal></entry> + <entry> + dbm は最も古い(元祖の)Berkeley DB 型データベースです。可能なら + ば使用しない方が良いでしょう。DB2 および gdbm に組み込まれている + 互換性を保つための関数は、サポートされません。これは、実装されて + いるのがソースレベルの互換性のみであり、元の dbm フォーマットを + 処理することができないためです。 + </entry> + </row> + + <row> + <entry><literal>ndbm</literal></entry> + <entry> + ndbm は、dbm に比べて新しく、dbm よりも柔軟です。 + dbm 固有の制約の多くをまだ有しています(そのため、 + 推奨されません)。 + </entry> + </row> + + <row> + <entry><literal>gdbm</literal></entry> + <entry> + Gdbm は、<ulink url="&url.gdbm;">GNU データベースマネージャ + </ulink>です。 + </entry> + </row> + + <row> + <entry><literal>db2</literal></entry> + <entry> + DB2 は、<ulink url="&url.sleepycat;">Sleepycat Software's DB2</ulink> + です。これは、「スタンドアローンおよびクライアント/サーバー + アプリケーションの両方で高性能な組込みデータベースサポートを提供する + プログラム用ツールキット」として記述されています。 + </entry> + </row> + + <row> + <entry><literal>db3</literal></entry> + <entry> + DB3 は、<ulink url="&url.sleepycat;">Sleepycat Software's + DB3</ulink> です。 + </entry> + </row> + + <row> + <entry><literal>db4</literal></entry> + <entry> + DB4 は、<ulink url="&url.sleepycat;">Sleepycat Software's + DB4</ulink> です。PHP 4.3.2 以降で利用可能です。 + </entry> + </row> + + <row> + <entry><literal>cdb</literal></entry> + <entry> + cdb は「固定データベースの作成・読込み用の、高速で高信頼性の + 軽量型パッケージ」です。これは qmail の作者によるものであり、 + <ulink url="&url.cdb;">&url.cdb;</ulink> にあります。 + 固定であるため、読込操作のみがサポートされます。 + PHP 4.3.0 以降、内部的な cdb ライブラリにより(更新ではなく) + 書き込みがサポートされています。 + </entry> + </row> + + <row> + <entry><literal>cdb_make</literal></entry> + <entry> + PHP 4.3.0 以降、付属する cdb ライブラリを使用する場合に cdb + ファイルの(更新ではなく)作成をサポートします。 + </entry> + </row> + + <row> + <entry><literal>flatfile</literal></entry> + <entry> + これは、PHP 4.3.0 以降で利用可能で、古い + <link linkend="ref.dbm">dbm</link> 拡張モジュールとの互換性の + ためだけのものであり、使用するべきではありません。 + しかし、ファイルがこの形式で作成された場所でこれを使用する + ことができます。これは、configure が外部ライブラリを見付ける + ことができない場合に生じます。 + </entry> + </row> + + <row> + <entry><literal>inifile</literal></entry> + <entry> + これは PHP 4.3.3 以降で利用可能で、PHP スクリプトから php.ini + ファイルを書き換えられるようにします。ini ファイルを扱う場合は、 + array(0=>group,1=>value_name) のような配列、あるいは + "[group]value_name" のような文字列を渡します(group はオプションです)。 + <function>dba_firstkey</function> や <function>dba_nextkey</function> + はキーを文字列形式で返しますが、PHP 5 以降で利用できる + <function>dba_key_split</function> を用いるとそれを配列形式に + 変換できます。その際に &false; を失うこともありません。 + </entry> + </row> + + <row> + <entry><literal>qdbm</literal></entry> + <entry> + これは PHP 5.0.0 以降で有効です。qdbm ライブラリは + <ulink url="http://qdbm.sourceforge.net">http://qdbm.sourceforge.net</ulink> + にあります。 + </entry> + </row> + + </tbody> + </tgroup> + </table> </para> <para> - <function>dba_open</function>または<function>dba_popen</function> + <function>dba_open</function> または <function>dba_popen</function> 関数を実行する際、引数にハンドラ名の一つを指定する必要があります。 実際に利用可能なハンドラのリストは、 <function>phpinfo</function> または - <function>dba_handlers</function>をコールした際に表示されます。 + <function>dba_handlers</function> をコールした際に表示されます。 </para> </section> @@ -146,10 +173,10 @@ <section id="dba.resources"> &reftitle.resources; <para> - 関数 <function>dba_open</function> および - <function>dba_popen</function> は、指定したデータベースファイルを - アクセスするためのハンドルを返します。このハンドルは、他の全ての - dba関数コールで使用されます。 + 関数 <function>dba_open</function> および + <function>dba_popen</function> は、指定したデータベースファイルに + アクセスするためのハンドルを返します。このハンドルは、他の全ての + dba 関数コールで使用されます。 </para> </section> @@ -162,68 +189,69 @@ &reftitle.examples; <para> <example> - <title>DBAの例</title> + <title>DBA の例</title> <programlisting role="php"> <![CDATA[ <?php -$id = dba_open ("/tmp/test.db", "n", "db2"); +$id = dba_open("/tmp/test.db", "n", "db2"); if (!$id) { echo "dba_open failed\n"; exit; } -dba_replace ("key", "This is an example!", $id); +dba_replace("key", "This is an example!", $id); -if (dba_exists ("key", $id)) { - echo dba_fetch ("key", $id); - dba_delete ("key", $id); +if (dba_exists("key", $id)) { + echo dba_fetch("key", $id); + dba_delete("key", $id); } -dba_close ($id); +dba_close($id); ?> ]]> </programlisting> </example> </para> <para> - DBAは、バイナリセーフでありいかなる制限も受けません。 - DBA は、使用するデータベースの実装による全ての制約を継承します。 + DBA はバイナリセーフであり、いかなる制限も受けません。しかし、 + 使用するデータベースの実装による全ての制約を継承します。 </para> <para> 全てのファイルベースのデータベースは、完全に使用可能なものについて 新規に作成されたデータベースのファイルモードを設定する手段を、 提供する必要があります。 ファイルモードは、通常 <function>dba_open</function> または - <function>dba_popen</function> に4番目の引数として渡されます。 + <function>dba_popen</function> に 4 番目の引数として渡されます。 </para> <para> <function>dba_firstkey</function> および - <function>dba_nextkey</function>関数を用いて連続的に全てのエント - リにアクセスすることができます。アクセスする際にデータベースを変 - 更できない可能性があります。 - </para> + <function>dba_nextkey</function> 関数を用いて全てのエントリに + 連続的にアクセスすることができます。アクセスする際にデータベースを + 変更できない可能性があります。 + </para> <para> - <example> - <title>データベースへの連続アクセス</title> + <example> + <title>データベースへのアクセス</title> <programlisting role="php"> <![CDATA[ <?php -# ...データベースをオープンする... +// データベースをオープンする + +$key = dba_firstkey($id); -$key = dba_firstkey ($id); - while ($key != false) { - if (...) { # 他の操作を後で行うためにキーを記憶する + if (true) { // 他の操作を後で行うためにキーを記憶する $handle_later[] = $key; } - $key = dba_nextkey ($id); + $key = dba_nextkey($id); } -for ($i = 0; $i < count($handle_later); $i++) - dba_delete ($handle_later[$i], $id); +foreach ($handle_later as $val) { + dba_delete($val, $id); +} ?> ]]> @@ -233,7 +261,7 @@ </section> </partintro> - + &reference.dba.functions; </reference> http://cvs.php.net/diff.php/phpdoc-ja/reference/dba/configure.xml?r1=1.4&r2=1.5&ty=u Index: phpdoc-ja/reference/dba/configure.xml diff -u phpdoc-ja/reference/dba/configure.xml:1.4 phpdoc-ja/reference/dba/configure.xml:1.5 --- phpdoc-ja/reference/dba/configure.xml:1.4 Sun Jan 2 02:23:29 2005 +++ phpdoc-ja/reference/dba/configure.xml Sun Aug 14 03:21:14 2005 @@ -1,69 +1,99 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- $Revision: 1.4 $ --> +<!-- $Revision: 1.5 $ --> +<!-- EN-Revision: 1.14 Maintainer: hirokawa Status: ready --> +<!-- CREDITS: takagi --> <section id="dba.installation"> &reftitle.install; <para> - 設定オプション<option role="configure">--enable-dba=shared</option> - を使用することにより、dbm形式のデータベースをサポートする動的にロー - ド可能なモジュールを有効にしてPHPを構築することができます。 - また、PHPのconfigure行に設定スイッチ <literal>--with-XXXX</literal> - を指定することにより、少なくとも以下のハンドラの一つのサポートを追加 - する必要があります。 + 設定オプション <option role="configure">--enable-dba=shared</option> + を使用することにより、dbm 形式のデータベースをサポートする動的に + ロード可能なモジュールを有効にして PHP を構築することができます。 + また、PHP の configure 行に設定スイッチ <literal>--with-XXXX</literal> + を指定することにより、少なくとも以下のハンドラの一つのサポートを + 追加する必要があります。 + </para> + <warning> + <para> + PHP の configuring とコンパイルを済ませたら、コマンドラインから次の + テストを実行する必要があります: <literal>php run-tests.php ext/dba</literal> + これは、指定したハンドラの組み合わせが動作するかどうかを調べます。 + いちばん問題のあるのは <literal>dbm</literal> と <literal>ndbm</literal> + の組み合わせで、これらは多くの場合何らかの衝突を引き起こします。 + その原因は、いくつかのシステムではこれらのライブラリが他のライブラリの + 一部となっていることで。configure 時のテストでは個々のハンドラについての + 設定不備は調べられますが、それらの組み合わせについてはテストできません。 + </para> + </warning> + <para> <table> <title>サポートされるDBAハンドラ</title> <tgroup cols="2"> <thead> <row> <entry>ハンドラ</entry> - <entry>configureのスイッチ</entry> + <entry>configure のスイッチ</entry> </row> </thead> <tbody> <row> <entry><literal>dbm</literal></entry> <entry> - dbmのサポートを有効にするには、 - <option role="configure">--with-dbm[=DIR]</option>を追加します。 + dbm のサポートを有効にするには、 + <option role="configure">--with-dbm[=DIR]</option> を追加します。 + <note> + <para> + dbm は一般的にはラッパで、しばしば失敗を引き起こします。 + その動作をしっかり把握しており、ほんとうにそれを必要とする場合のみ + dbm を使用するようにすべきです。 + </para> + </note> </entry> </row> <row> <entry><literal>ndbm</literal></entry> - <entry> - ndbmのサポートを有効にするには、 - <option role="configure">--with-ndbm[=DIR]</option>を追加します。 + <entry> + ndbm のサポートを有効にするには、 + <option role="configure">--with-ndbm[=DIR]</option> を追加します。 + <note> + <para> + ndbm は一般的にはラッパで、しばしば失敗を引き起こします。 + その動作をしっかり把握しており、ほんとうにそれを必要とする場合のみ + ndbm を使用するようにすべきです。 + </para> + </note> </entry> </row> - + <row> <entry><literal>gdbm</literal></entry> <entry> - gdbmのサポートを有効にするには、 - <option role="configure">--with-gdbm[=DIR]</option>を追加します。 + gdbm のサポートを有効にするには、 + <option role="configure">--with-gdbm[=DIR]</option> を追加します。 </entry> </row> - + <row> <entry><literal>db2</literal></entry> <entry> - db2のサポートを有効にするには、 - <option role="configure">--with-db2[=DIR]</option>を追加します。 + db2 のサポートを有効にするには、 + <option role="configure">--with-db2[=DIR]</option> を追加します。 <note> <para> - db2はdb3およびdb4とコンフリクトします。 + db2 は db3 および db4 とは同時に使えません。 </para> </note> </entry> </row> - + <row> <entry><literal>db3</literal></entry> <entry> - db3のサポートを有効にするには、 - <option role="configure">--with-db3[=DIR]</option>を追加します。 + db3 のサポートを有効にするには、 + <option role="configure">--with-db3[=DIR]</option> を追加します。 <note> <para> - db3はdb2およびdb4とコンフリクトします。 + db3 は db2 および db4 とは同時に使えません。 </para> </note> </entry> @@ -72,65 +102,103 @@ <row> <entry><literal>db4</literal></entry> <entry> - db4のサポートを有効にするには、 - <option role="configure">--with-db4[=DIR]</option>を追加します。 + db4 のサポートを有効にするには、 + <option role="configure">--with-db4[=DIR]</option> を追加します。 <note> <para> - db4はdb2およびdb3とコンフリクトします。 + db4 は db2 および db3 とは同時に使えません。 </para> </note> <note> <para> - これは、PHP 5.0.0で追加されました。これ以前のバージョンでは、 - <option role="configure">--with-db3=DIR</option>を使用し、 - DIRにdb4ライブラリのパスを指定する必要する必要があります。 - バージョン4.3.0より前のPHPでは、4.1以降のバージョンのdbを使用 - することはできません。 + これは PHP 4.3.2 で追加されました。これ以前のバージョンでは、 + <option role="configure">--with-db3=DIR</option> を使用し、 + DIR に db4 ライブラリのパスを指定する必要する必要があります。 + バージョン 4.3.0 より前の PHP では、4.1 以降のバージョンの db + を使用することはできません。また、バージョン 4.1 から 4.1.24 + までの db ライブラリは、どの PHP のバージョンでも利用できません。 </para> </note> </entry> </row> - + <row> <entry><literal>cdb</literal></entry> <entry> - cdbのサポートを有効にするには、 - <option role="configure">--with-cdb[=DIR]</option>を追加します。 + cdb のサポートを有効にするには、 + <option role="configure">--with-cdb[=DIR]</option> を追加します。 <note> <para> - PHP 4.3.0以降、付属するcdbライブラリを使用するためにDIRを省略 - することができます。この場合、cdb_makeハンドラが追加され、 - cdbファイルを作成し、PHPのストリームを用いてネットワーク上の - cdbファイルにアクセスできるようになります。 + PHP 4.3.0 以降、付属する cdb ライブラリを使用するために DIR + を省略することができます。この場合、cdb_make ハンドラが追加されます。 + これにより cdb ファイルを作成したり、PHPのストリームを用いて + ネットワーク上の cdb ファイルにアクセスできるようになります。 </para> </note> </entry> </row> + <row> <entry><literal>flatfile</literal></entry> <entry> - flatfileのサポートを有効にするには、 - <option role="configure">--with-flatfile</option>を追加します。 + flatfile のサポートを有効にするには、 + <option role="configure">--with-flatfile</option> を追加します。 <note> <para> - これは、古い<link linkend="ref.dbm">dbm</link>拡張モジュール - との互換性のためにPHP 4.3.0で追加されました。 - このハンドラは、他のハンドラで必要とされるライブラリの1つを - インストールすることができない場合、そしれ、付属するcdbハンド - ラを使用することができない場合にのみ使用してください。 + これは、古い <link linkend="ref.dbm">dbm</link> 拡張モジュール + との互換性のために PHP 4.3.0 で追加されました。 + このハンドラは、他のハンドラで必要とされるライブラリをひとつも + インストールすることができない場合、そして、付属する cdb + ハンドラを使用することができない場合にのみ使用してください。 </para> </note> </entry> </row> + + <row> + <entry><literal>inifile</literal></entry> + <entry> + inifile のサポートを有効にするには、 + <option role="configure">--with-inifile</option> を追加します。 + <note> + <para> + これは PHP 5.0.0 で追加されました。これにより Microsoft 形式の + <filename>.ini</filename> ファイル(&php.ini; のような)を + 読み書きできるようになります。 + </para> + </note> + </entry> + </row> + + <row> + <entry><literal>qdbm</literal></entry> + <entry> + qdbm のサポートを有効にするには、 + <option role="configure">--with-qdbm[=DIR]</option> を追加します。 + <note> + <para> + qdbm は dbm および gdbm とは同時に使えません。 + </para> + </note> + <note> + <para> + これは PHP 5.0.0 で追加されました。qdbm ライブラリは + <ulink url="http://qdbm.sourceforge.net">http://qdbm.sourceforge.net</ulink> + にあります。 + </para> + </note> + </entry> + </row> + </tbody> </tgroup> </table> <note> <para> - PHP 4.3.0までは、db2およびdb3ハンドラの両方を追加することができま - したが、内部的に使用できるのは片方だけでした。 + PHP 4.3.0 までは、db2 および db3 ハンドラの両方を追加することが + できましたが、内部的に使用できるのは片方だけでした。 これは、両方のファイル形式を使用することができないことを意味します。 - PHP 5.0.0以降、このような設定ミスを回避するよう設定の確認が行われます。 + PHP 5.0.0 以降、このような設定ミスを回避するよう設定の確認が行われます。 </para> </note> </para>
« previous php.doc.ja (#1124) next »