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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20763 -->
   4 <sect2 id="zend.application.available-resources.db">
   5     <title>Zend_Application_Resource_Db</title>
   6
   7     <para>
   8         <classname>Zend_Application_Resource_Db</classname>は、
   9         それに渡されるオプションに基づいて<classname>Zend_Db</classname>アダプタを初期化します。
  10         デフォルトで、<classname>Zend_Db_Table</classname>用のデフォルト・アダプタとして、
  11         アダプタを設定します。
  12         複数のデータベースを同時に利用したい場合、 <link
  13             linkend="zend.application.available-resources.multidb">Multidb リソース・プラグイン</link>
  14         を利用できます。
  15     </para>
  16
  17     <para>
  18         以下の構成キーが認識されます:
  19     </para>
  20
  21     <itemizedlist>
  22         <listitem>
  23             <para>
  24                 <emphasis><property>adapter</property></emphasis>: <classname>Zend_Db</classname>アダプタ・タイプ
  25             </para>
  26         </listitem>
  27
  28         <listitem>
  29             <para>
  30                 <emphasis><property>params</property></emphasis>: アダプタ・インスタンスを取得するときに使う構成パラメータの連想配列です。
  31             </para>
  32         </listitem>
  33
  34         <listitem>
  35             <para>
  36                 <emphasis><property>isDefaultTableAdapter</property></emphasis>: アダプタをデフォルト・テーブル・アダプタとして確立するべきかどうか。
  37             </para>
  38         </listitem>
  39     </itemizedlist>
  40
  41     <example id="zend.application.available-resources.db.configExample">
  42         <title>DBアダプタ・リソース構成サンプル</title>
  43
  44         <para>
  45             下記は、DBリソースを初期化するために使える<acronym>INI</acronym>構成サンプルです。
  46         </para>
  47
  48         <programlisting language="ini"><![CDATA[
  49 [production]
  50 resources.db.adapter = "pdo_mysql"
  51 resources.db.params.host = "localhost"
  52 resources.db.params.username = "webuser"
  53 resources.db.params.password = "XXXXXXX"
  54 resources.db.params.dbname = "test"
  55 resources.db.isDefaultTableAdapter = true
  56 ]]></programlisting>
  57     </example>
  58
  59     <note>
  60         <title>アダプタのインスタンスを取得する</title>
  61
  62         <para>
  63             このリソースでインスタンス化されるアダプタを
  64             デフォルト・テーブル・アダプタにしないことを選ぶなら、
  65             あなたはどうやってアダプタ・インスタンスを取得しますか？
  66         </para>
  67
  68         <para>
  69             どんなリソース・プラグインでも、
  70             ブートストラップからDBリソース・プラグインを取ってくることができます:
  71         </para>
  72
  73         <programlisting language="php"><![CDATA[
  74 $resource = $bootstrap->getPluginResource('db');
  75 ]]></programlisting>
  76
  77         <para>
  78             一旦リソースオブジェクトを所有するなら、
  79             <methodname>getDbAdapter()</methodname>メソッドを用いてDBアダプタを取ってくることができます:
  80         </para>
  81
  82         <programlisting language="php"><![CDATA[
  83 $db = $resource->getDbAdapter();
  84 ]]></programlisting>
  85     </note>
  86 </sect2>