repo_zf1/documentation/manual/ja/module_specs/Zend_Application-AvailableResources-Db.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 24249 -->
<sect2 id="zend.application.available-resources.db">
    <title>Zend_Application_Resource_Db(日本語)</title>

    <para>
        <classname>Zend_Application_Resource_Db</classname>は、
        それに渡されるオプションに基づいて<classname>Zend_Db</classname>アダプタを初期化します。
        デフォルトで、<classname>Zend_Db_Table</classname>用のデフォルト・アダプタとして、
        アダプタを設定します。
        複数のデータベースを同時に利用したい場合、 <link
            linkend="zend.application.available-resources.multidb">Multidb リソース・プラグイン</link>
        を利用できます。
    </para>

    <para>
        以下の構成キーが認識されます:
    </para>

    <itemizedlist>
        <listitem>
            <para>
                <emphasis><property>adapter</property></emphasis>: <classname>Zend_Db</classname>アダプタ・タイプ
            </para>
        </listitem>

        <listitem>
            <para>
                <emphasis><property>params</property></emphasis>: アダプタ・インスタンスを取得するときに使う構成パラメータの連想配列です。
            </para>
        </listitem>

        <listitem>
            <para>
                <emphasis><property>isDefaultTableAdapter</property></emphasis>: アダプタをデフォルト・テーブル・アダプタとして確立するべきかどうか。
            </para>
        </listitem>

        <listitem>
            <para>
                <emphasis><property>defaultMetadataCache</property></emphasis>:
                <classname>Zend_Db_Table</classname> 用にメタデータ・キャッシュとして使用する
                キャッシュ・テンプレートまたは <classname>Zend_Cache_Core</classname> のインスタンスの名前。
            </para>
        </listitem>
    </itemizedlist>

    <example id="zend.application.available-resources.db.configExample">
        <title>DBアダプタ・リソース構成サンプル</title>

        <para>
            下記は、DBリソースを初期化するために使える<acronym>INI</acronym>構成サンプルです。
        </para>

        <programlisting language="ini"><![CDATA[
[production]
resources.db.adapter = "pdo_mysql"
resources.db.params.host = "localhost"
resources.db.params.username = "webuser"
resources.db.params.password = "XXXXXXX"
resources.db.params.dbname = "test"
resources.db.isDefaultTableAdapter = true

; メタデータ・キャッシュ用に使用するキャッシュ・テンプレートも任意に(訳注:動詞不明)できます。
resources.db.defaultMetadataCache = "database"
]]></programlisting>
    </example>

    <note>
        <title>アダプタのインスタンスを取得する</title>

        <para>
            このリソースでインスタンス化されるアダプタを
            デフォルト・テーブル・アダプタにしないことを選ぶなら、
            あなたはどうやってアダプタ・インスタンスを取得しますか？
        </para>

        <para>
            どんなリソース・プラグインでも、
            ブートストラップからDBリソース・プラグインを取ってくることができます:
        </para>

        <programlisting language="php"><![CDATA[
$resource = $bootstrap->getPluginResource('db');
]]></programlisting>

        <para>
            一旦リソースオブジェクトを所有するなら、
            <methodname>getDbAdapter()</methodname>メソッドを用いてDBアダプタを取ってくることができます:
        </para>

        <programlisting language="php"><![CDATA[
$db = $resource->getDbAdapter();
]]></programlisting>
    </note>
</sect2>