Zend_Application-AvailableResources-Db.xml 2.9 KB

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