setup.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 8b2eba9e48eb1037f11aef36820db6b5b07fa08c Maintainer: takagi Status: ready -->
<!-- CREDITS: hirokawa,mumumu -->

<chapter xml:id="dba.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &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=>group,1=>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>
  <para>
   <function>dba_open</function> または <function>dba_popen</function>
   関数を実行する際、引数にハンドラ名の一つを指定する必要があります。
   実際に利用可能なハンドラのリストは、
   <function>phpinfo</function> または
   <function>dba_handlers</function> をコールした際に表示されます。
  </para>
 </section>
 <!-- }}} -->
 
 <!-- {{{ Installation -->
 &reference.dba.configure;
 <!-- }}} -->
 
 <!-- {{{ Configuration -->
 <section xml:id="dba.configuration">
  &reftitle.runtime;
  &extension.runtime;
  <para>
   <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>
  </para>
  
  &ini.descriptions.title;
  
  <para>
   <variablelist>
    <varlistentry xml:id="ini.dba.default_handler">
     <term>
      <parameter>dba.default_handler</parameter>
      <type>string</type>
     </term>
     <listitem>
      <para>
       デフォルトのハンドラ名。
      </para>
     </listitem>
    </varlistentry>
    
   </variablelist>
  </para>
 </section>
 <!-- }}} -->
 
 <!-- {{{ Resources -->
 <section xml:id="dba.resources">
  &reftitle.resources;
  <para>
   PHP 8.4.0 より前のバージョンでは、
   ほとんどの dba 関数はリソースを返していました。
   (たとえば <function>dba_open</function>
   は、ほとんどの dba 関数で必須の DBA リンクの識別子を、
   正の整数として返していました)
  </para>
 </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
-->