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

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20763 -->
   4 <sect2 id="zend.application.available-resources.modules">
   5     <title>Zend_Application_Resource_Modules</title>
   6
   7     <para>
   8         <classname>Zend_Application_Resource_Modules</classname>は、
   9         アプリケーションモジュールを初期化するために使われます。
  10         モジュールのルートに<filename>Bootstrap.php</filename>ファイルがあるなら、
  11         <classname>Module_Bootstrap</classname>という名前のクラスを含みます、
  12         （ "Module" のところがモジュール名です）
  13         そして、モジュールをブートするためにそのクラスを使用します。
  14     </para>
  15
  16     <para>
  17         <classname>Zend_Application_Module_Autoloader</classname>のインスタンスは、
  18         それを初期化するためにモジュール名とディレクトリを使用して、
  19         モジュールのためにデフォルトで作成されます。
  20     </para>
  21
  22     <para>
  23         Modules リソースはデフォルトでは何も引数を受け取らないので、
  24         設定で有効にするには空の配列として作成しなければなりません。
  25         <acronym>INI</acronym> 形式で設定する場合は次のようになります。
  26     </para>
  27
  28     <programlisting language="ini"><![CDATA[
  29 resources.modules[] =
  30 ]]></programlisting>
  31
  32     <para>
  33         <acronym>XML</acronym> 形式で設定する場合は次のようになります。
  34     </para>
  35
  36     <programlisting language="xml"><![CDATA[
  37 <resources>
  38     <modules>
  39         <!-- Placeholder to ensure an array is created -->
  40         <placeholder />
  41     </modules>
  42 </resources>
  43 ]]></programlisting>
  44
  45     <para>
  46         標準の <acronym>PHP</acronym> 配列を使用する場合は、単純に空の配列を作成します。
  47     </para>
  48
  49     <programlisting language="php"><![CDATA[
  50 $options = array(
  51     'resources' => array(
  52         'modules' => array(),
  53     ),
  54 );
  55 ]]></programlisting>
  56
  57     <note>
  58         <title>フロントコントローラ・リソース依存</title>
  59
  60         <para>
  61             モジュール・リソースは、<link
  62                 linkend="zend.application.available-resources.frontcontroller">フロントコントローラ・リソース</link>
  63             に依存します。
  64             もちろん、あつらえのフロントコントローラ・リソースクラスまたはクラス・イニシャライザ・メソッドによって
  65             そのリソース自身の代用を提供できます。
  66             "Frontcontroller" で終るリソース・プラグイン・クラスや
  67             "_initFrontController" という名前のイニシャライザ・メソッドである限りは。
  68             （大文字と小文字の区別をしません）
  69         </para>
  70     </note>
  71
  72     <example id="zend.application.available-resources.modules.configExample">
  73         <title>モジュールの設定</title>
  74
  75         <para>
  76             構成ファイルのプレフィックスまたはサブセクションとして
  77             モジュール名を使用しているモジュール固有の構成を指定できます。
  78         </para>
  79
  80         <para>
  81             たとえば、アプリケーションに "news" モジュールがあると仮定します。
  82             下記は、そのモジュールでリソースの構成を示す<acronym>INI</acronym>と<acronym>XML</acronym>の例です。
  83         </para>
  84
  85         <programlisting language="ini"><![CDATA[
  86 [production]
  87 news.resources.db.adapter = "pdo_mysql"
  88 news.resources.db.params.host = "localhost"
  89 news.resources.db.params.username = "webuser"
  90 news.resources.db.params.password = "XXXXXXX"
  91 news.resources.db.params.dbname = "news"
  92 ]]></programlisting>
  93
  94         <programlisting language="xml"><![CDATA[
  95 <?xml version="1.0"?>
  96 <config>
  97     <production>
  98         <news>
  99             <resources>
 100                 <db>
 101                     <adapter>pdo_mysql</adapter>
 102                     <params>
 103                         <host>localhost</host>
 104                         <username>webuser</username>
 105                         <password>XXXXXXX</password>
 106                         <dbname>news</dbname>
 107                     </params>
 108                     <isDefaultAdapter>true</isDefaultAdapter>
 109                 </db>
 110             </resources>
 111         </news>
 112     </production>
 113 </config>
 114 ]]></programlisting>
 115     </example>
 116
 117     <example id="zend.application.available-resources.modules.retrieveBootstrapExample">
 118         <title>特定のモジュール・ブートストラップを取得する</title>
 119
 120         <para>
 121             時には、特定のモジュールのためにブートストラップ・オブジェクトを取得する必要があるかもしれません
 122             おそらくは別々のブートストラップ・メソッドを実行するためや、
 123             それを構成するためのオートローダを引き出すために。
 124             これは、モジュール・リソースの<methodname>getExecutedBootstraps()</methodname>メソッドを使用して行なえます。
 125         </para>
 126
 127         <programlisting language="php"><![CDATA[
 128 $resource = $bootstrap->getPluginResource('modules');
 129 $moduleBootstraps = $resource->getExecutedBootstraps();
 130 $newsBootstrap = $moduleBootstraps['news'];
 131 ]]></programlisting>
 132     </example>
 133 </sect2>