archived-doc-ja/reference/dba/setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: b5fce74a6c0760daccc79063279e102873be6d77 Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,mumumu -->
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="dba.setup">
 &reftitle.setup;

 <!-- {{{ Requirements -->
 <section xml: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 よりも柔軟です。
        dbm 固有の制約の多くをまだ有しています（そのため、
        推奨されません）。
       </entry>
      </row>

      <row>
       <entry><literal>gdbm</literal></entry>
       <entry>
        Gdbm は、<link xlink:href="&url.gdbm;">GNU データベースマネージャ
        </link>です。
       </entry>
      </row>

      <row>
       <entry><literal>db2</literal></entry>
       <entry>
        DB2 は、<link xlink:href="&url.sleepycat;">Oracle Berkeley DB 2</link>
        用です。これは、「スタンドアローンおよびクライアント/サーバー
        アプリケーションの両方で高性能な組込みデータベースサポートを提供する
        プログラム用ツールキット」として記述されています。
       </entry>
      </row>

      <row>
       <entry><literal>db3</literal></entry>
       <entry>
        DB3 は、<link xlink:href="&url.sleepycat;">Oracle Berkeley DB
        3</link> 用です。
       </entry>
      </row>

      <row>
       <entry><literal>db4</literal></entry>
       <entry>
        DB4 は、<link xlink:href="&url.sleepycat;">Oracle Berkeley DB
        4 あるいは 5</link> 用です。
        BDB 5 を使用できるのは、PHP 5.3.3 以降です。
       </entry>
      </row>

      <row>
       <entry><literal>cdb</literal></entry>
       <entry>
        cdb は「固定データベースの作成・読込み用の、高速で高信頼性の
        軽量型パッケージ」です。これは qmail の作者によるものであり、
        <link xlink:href="&url.cdb;">&url.cdb;</link> にあります。
        固定であるため、読込操作のみがサポートされます。
        内部的な cdb ライブラリにより（更新ではなく）
        書き込みがサポートされています。
       </entry>
      </row>

      <row>
       <entry><literal>cdb_make</literal></entry>
       <entry>
        付属する cdb ライブラリを使用する場合に cdb
        ファイルの（更新ではなく）作成をサポートします。
       </entry>
      </row>

      <row>
       <entry><literal>flatfile</literal></entry>
       <entry>
        これは、古い
        <literal>dbm</literal> 拡張モジュールとの互換性の
        ためだけのものであり、使用するべきではありません。
        しかし、ファイルがこの形式で作成された場所でこれを使用する
        ことができます。これは、configure が外部ライブラリを見付ける
        ことができない場合に生じます。
       </entry>
      </row>

      <row>
       <entry><literal>inifile</literal></entry>
       <entry>
        これは PHP スクリプトから php.ini
        ファイルを書き換えられるようにします。ini ファイルを扱う場合は、
        array(0=&gt;group,1=&gt;value_name) のような配列、あるいは
        "[group]value_name" のような文字列を渡します（group はオプションです）。
        <function>dba_firstkey</function> や <function>dba_nextkey</function>
        はキーを文字列形式で返しますが、
        <function>dba_key_split</function> を用いるとそれを配列形式に
        変換できます。その際に &false; を失うこともありません。
       </entry>
      </row>

      <row>
       <entry><literal>qdbm</literal></entry>
       <entry>
        qdbm ライブラリは
        <link xlink:href="&url.qdbm;"/> からダウンロードできます。
       </entry>
      </row>

      <row>
       <entry><literal>tcadb</literal></entry>
       <entry>
        Tokyo Cabinet ライブラリは
        <link xlink:href="&url.tcadb;"/>
        からダウンロードできます。
       </entry>
      </row>

      <row>
       <entry><literal>lmdb</literal></entry>
       <entry>
        PHP 7.2.0 以降で利用可能です。
        Lightning Memory-Mapped Database ライブラリは
        <link xlink:href="&url.lmdb;"/> からダウンロードできます。
       </entry>
      </row>

     </tbody>
    </tgroup>
   </table>
  </para>
  <simpara>
   <function>dba_open</function> または <function>dba_popen</function>
   関数を実行する際、引数にハンドラ名の一つを指定する必要があります。
   実際に利用可能なハンドラのリストは、
   <function>phpinfo</function> または
   <function>dba_handlers</function> をコールした際に表示されます。
  </simpara>
 </section>
 <!-- }}} -->

 <!-- {{{ Installation -->
 &reference.dba.configure;
 <!-- }}} -->

 <!-- {{{ Configuration -->
 <section xml:id="dba.configuration">
  &reftitle.runtime;
  &extension.runtime;
  <table>
   <title>DBA &ConfigureOptions;</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="dba.configuration.list">
     <row>
      <entry>
       <link linkend="ini.dba.default_handler">dba.default_handler</link>
      </entry>
      <entry>DBA_DEFAULT</entry>
      <entry><constant>INI_ALL</constant></entry>
      <entry><!-- leave empty, this will be filled by an automatic script --></entry>
     </row>
    </tbody>
   </tgroup>
  </table>

  &ini.descriptions.title;

  <variablelist>
   <varlistentry xml:id="ini.dba.default_handler">
    <term>
     <parameter>dba.default_handler</parameter>
     <type>string</type>
    </term>
    <listitem>
     <simpara>
      デフォルトのハンドラ名。
     </simpara>
    </listitem>
   </varlistentry>

  </variablelist>
 </section>
 <!-- }}} -->

 <!-- {{{ Resources -->
 <section xml:id="dba.resources">
  &reftitle.resources;
  <simpara>
   PHP 8.4.0 より前のバージョンでは、
   ほとんどの dba 関数はリソースを返していました。
   (たとえば <function>dba_open</function>
   は、ほとんどの dba 関数で必須の DBA リンクの識別子を、
   正の整数として返していました)
  </simpara>
 </section>
 <!-- }}} -->

</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->