repo_zf1/documentation/manual/ja/ref/project-structure.xml

<?xml version="1.0" encoding="UTF-8"?>
<!-- Reviewed: no -->
<!-- EN-Revision: 18656 -->
<appendix id="project-structure">
    <title>Zend Framework MVC アプリケーションのために推奨されるプロジェクト構造</title>

    <sect1 id="project-structure.overview">
        <title>概要</title>

        <para>
            たくさんの開発者が、比較的柔軟な環境でZend Frameworkプロジェクトのための
            最善のプロジェクト構造のガイダンスを望みます。
            「柔軟な」環境とは、
            それらのアプリケーションを実行し、かつ安全にするための
            最も理想的なプロジェクト構造を達成するために、
            必要に応じてそれらのファイルシステムとウェブサーバ構成を開発者が操作できる
            環境です。
            デフォルトのプロジェクト構造では、
            それらの配置で開発者がそのような柔軟性を持つと仮定します。
        </para>

        <para>
            以下のディレクトリ構造は、
            複雑なプロジェクトのために最大限に拡張可能に設計されています。
            その一方で、プロジェクトのためのフォルダとファイルの単純なサブセットを
            より単純な必要条件で提示します。
            この構造も、モジュラー及び非モジュラー両方のZend Frameworkアプリケーションのために、
            変更なしで動作します。
            <filename>.htaccess</filename>ファイルは、
            この付録に含まれる<link linkend="project-structure.rewrite">リライト構成ガイド</link>
            で定めるウェブサーバでも、<acronym>URL</acronym>リライト機能を必要とします。
        </para>

        <para>
            このプロジェクト構造で、可能性があるすべてのZend Frameworkプロジェクト条件を
            サポートすることは意図していません。
            <classname>Zend_Tool</classname>によって使われるデフォルトのプロジェクト・プロフィールは、
            このプロジェクト構造を反映します。
            しかし、この構造でサポートされない必要条件を持つアプリケーションでは、
            カスタム・プロジェクト・プロフィールを使わなければなりません。
        </para>
    </sect1>

    <sect1 id="project-structure.project">
        <title>推奨されるプロジェクト・ディレクトリ構造</title>

        <programlisting language="txt"><![CDATA[
<project name>/
    application/
        configs/
            application.ini
        controllers/
            helpers/
        forms/
        layouts/
            filters/
            helpers/
            scripts/
        models/
        modules/
        services/
        views/
            filters/
            helpers/
            scripts/
        Bootstrap.php
    data/
        cache/
        indexes/
        locales/
        logs/
        sessions/
        uploads/
    docs/
    library/
    public/
        css/
        images/
        js/
        .htaccess
        index.php
    scripts/
        jobs/
        build/
    temp/
    tests/
]]></programlisting>

        <para>
            以下では、一覧に記載されたディレクトリ毎に利用例を記述します。
        </para>

        <itemizedlist>
            <listitem>
                <para>
                    <emphasis><filename>application/</filename></emphasis>:
                    このディレクトリは、アプリケーションを含みます。
                    構成や利用されるサービス、及びブートストラップ・ファイルと同様に、
                    <acronym>MVC</acronym>システムを収納します。
                </para>

                <itemizedlist>
                    <listitem>
                        <para>
                            <emphasis><filename>configs/</filename></emphasis>:
                            アプリケーション全体の設定のディレクトリ
                        </para>
                    </listitem>

                    <listitem>
                        <para>
                            <emphasis><filename>controllers/</filename></emphasis>,
                            <emphasis><filename>models/</filename></emphasis>,
                            <emphasis><filename>views/</filename></emphasis>:
                            これらのディレクトリは、デフォルトのコントローラ、モデルまたは
                            ビューのディレクトリとして用いられます。
                            アプリケーション・ディレクトリの中にこれらの３つのディレクトリを持たせると、
                            グローバルな <filename>controllers/models/views</filename> を持つ
                            モジュラー・プロジェクトと同様に、
                            単純なプロジェクトを始めるための最良のレイアウトが提供されます。
                        </para>
                    </listitem>

                    <listitem>
                        <para>
                            <emphasis><filename>controllers/helpers/</filename></emphasis>:
                            これらのディレクトリにはアクション・ヘルパーを含みます。
                            アクション・ヘルパーは、デフォルト・モジュールのための
                            "<classname>Controller_Helper_</classname>"、
                            または他のモジュールの "&lt;Module&gt;_Controller_Helper" として
                            namespace されます。
                        </para>
                    </listitem>

                    <listitem>
                        <para>
                            <emphasis><filename>layouts/</filename></emphasis>:
                            このレイアウト・ディレクトリは、 <acronym>MVC</acronym> ベースのレイアウト用です。
                            <classname>Zend_Layout</classname> は <acronym>MVC</acronym> ベース、
                            及び非 <acronym>MVC</acronym> ベースのレイアウトができるので、
                            このディレクトリの位置は、レイアウトがコントローラとは１対１の関係ではなく、
                            <filename>views/</filename> 内のテンプレートから独立していることを反映します。
                        </para>
                    </listitem>

                    <listitem>
                        <para>
                            <emphasis><filename>modules/</filename></emphasis>:
                            モジュールにより、開発者は
                            一組の関連したコントローラを論理的に系統化されたグループに分類できます。
                            モジュール・ディレクトリ配下の構造は、
                            アプリケーション・ディレクトリ配下の構造に似ています。
                        </para>
                    </listitem>

                    <listitem>
                        <para>
                            <emphasis><filename>services/</filename></emphasis>:
                            このディレクトリは、
                            アプリケーションによって、
                            またはモデルのための<ulink
                                url="http://www.martinfowler.com/eaaCatalog/serviceLayer.html">サービス・レイヤ</ulink>
                            を実装するために提供される、
                            アプリケーションに依存したウェブ・サービス・ファイルのためのものです。
                        </para>
                    </listitem>

                    <listitem>
                        <para>
                            <emphasis><filename>Bootstrap.php</filename></emphasis>:
                            このファイルはアプリケーションのためのエントリ・ポイントで、
                            <classname>Zend_Application_Bootstrap_Bootstrapper</classname> を実装するべきです。
                            このファイルのための目的は、アプリケーションを起動すること、
                            及びそれらを初期化することによって、コンポーネントがアプリケーションを利用できるようにすることです。
                        </para>
                    </listitem>
                </itemizedlist>
            </listitem>

            <listitem>
                <para>
                    <emphasis><filename>data/</filename></emphasis>:
                    このディレクトリは、
                    揮発性でおそらく一時的なアプリケーションのデータを格納するための場所を提供します。
                    このディレクトリのデータの障害は、アプリケーションが失敗する原因になるかもしれません。
                    また、このディレクトリの情報は、サブバージョン・リポジトリに関与するかもしれませんし、
                    関与しないかもしれません。
                    このディレクトリの物体の例は、
                    セッション・ファイル、キャッシュ・ファイル、sqlite データベース、
                    そしてログとインデックスです。
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><filename>docs/</filename></emphasis>:
                    このディレクトリは、生成されたか、または直接編集された
                    ドキュメンテーションを含みます。
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><filename>library/</filename></emphasis>:
                    <!-- TODO: to be  translated -->
                     This directory is for
                    common libraries on which the application depends, and should be on the
                    <acronym>PHP</acronym> <property>include_path</property>. Developers should
                    place their application's library code under this directory in a unique
                    namespace, following the guidelines established in the <acronym>PHP</acronym>
                    manual's <ulink
                        url="http://www.php.net/manual/en/userlandnaming.php">Userland Naming
                        Guide</ulink>, as well as those established by Zend itself. This
                    directory may also include Zend Framework itself; if so, you would house it in
                    <filename>library/Zend/</filename>.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><filename>public/</filename></emphasis>:
                    このディレクトリは、アプリケーションのためにすべての公開ファイルを含みます。
                    <!-- TODO: to be translated -->
                     <filename>index.php</filename> sets up and
                    invokes <classname>Zend_Application</classname>, which in turn invokes the
                    <filename>application/Bootstrap.php</filename> file, resulting in dispatching
                    the front controller. The web root of your web server would typically be set to
                    this directory.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><filename>scripts/</filename></emphasis>:
                    このディレクトリは、メンテナンスやビルド・スクリプトを含みます。
                    <!-- TODO: to be translated -->
                     Such scripts might include command line,
                    cron, or phing build scripts that are not executed at runtime but are part of
                    the correct functioning of the application.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><filename>temp/</filename></emphasis>:
                     The <filename>temp/</filename>
                    folder is set aside for transient application data. This information would not
                    typically be committed to the applications svn repository. If data under the
                    <filename>temp/</filename> directory were deleted, the application should be
                    able to continue running with a possible decrease in performance until data is
                    once again restored or recached.
                </para>
            </listitem>

            <listitem>
                <para>
                    <emphasis><filename>tests/</filename></emphasis>:
                     This directory contains
                    application tests. These could be hand-written, PHPUnit tests, Selenium-RC
                    based tests or based on some other testing framework. By default, library code
                    can be tested by mimicing the directory structure of your
                    <filename>library/</filename> directory. Additionally, functional tests for
                    your application could be written mimicing the
                    <filename>application/</filename> directory structure (including the
                    application subdirectory).
                </para>
            </listitem>
        </itemizedlist>
    </sect1>

    <sect1 id="project-structure.filesystem">
        <title>モジュール構造</title>

        <para>
            The directory structure for modules should mimic that of the
            <filename>application/</filename> directory in the recommended project structure:
        </para>

        <programlisting language="xml"><![CDATA[
<modulename>
    configs/
        application.ini
    controllers/
        helpers/
    forms/
    layouts/
        filters/
        helpers/
        scripts/
    models/
    services/
    views/
        filters/
        helpers/
        scripts/
    Bootstrap.php
]]></programlisting>

        <para>
            The purpose of these directories remains exactly the same as for the recommended
            project directory structure.
        </para>
    </sect1>

    <sect1 id="project-structure.rewrite">
        <title>リライト設定ガイド</title>

        <para>
            <acronym>URL</acronym> rewriting is a common function of <acronym>HTTP</acronym>
            servers. However, the rules and configuration differ widely between them. Below are
            some common approaches across a variety of popular web servers available at the time of
            writing.
        </para>

        <sect2 id="project-structure.rewrite.apache">
            <title>Apache HTTPサーバ</title>

            <para>
                All examples that follow use <property>mod_rewrite</property>, an official
                module that comes bundled with Apache. To use it,
                <property>mod_rewrite</property> must either be included at compile time or
                enabled as a Dynamic Shared Object (<acronym>DSO</acronym>). Please consult the
                <ulink url="http://httpd.apache.org/docs/">Apache documentation</ulink> for your
                version for more information.
            </para>

            <sect3 id="project-structure.rewrite.apache.vhost">
                <title>バーチャルホスト内でのリライト</title>

                <para>
                    Here is a very basic virtual host definition. These rules direct all requests
                    to <filename>index.php</filename>, except when a matching file is found under
                    the <property>document_root</property>.
                </para>

                <programlisting language="xml"><![CDATA[
<VirtualHost my.domain.com:80>
    ServerName   my.domain.com
    DocumentRoot /path/to/server/root/my.domain.com/public

    RewriteEngine off

    <Location />
        RewriteEngine On
        RewriteCond %{REQUEST_FILENAME} -s [OR]
        RewriteCond %{REQUEST_FILENAME} -l [OR]
        RewriteCond %{REQUEST_FILENAME} -d
        RewriteRule ^.*$ - [NC,L]
        RewriteRule ^.*$ /index.php [NC,L]
    </Location>
</VirtualHost>
]]></programlisting>

                <para>
                    Note the slash ("/") prefixing <filename>index.php</filename>; the rules for
                    <filename>.htaccess</filename> differ in this regard.
                </para>
            </sect3>

            <sect3 id="project-structure.rewrite.apache.htaccess">
                <title>.htaccessファイル内でのリライト</title>

                <para>
                    下記は<property>mod_rewrite</property>を利用する
                    <filename>.htaccess</filename>ファイルの例です。
                    It is similar to the virtual host
                    configuration, except that it specifies only the rewrite rules, and the leading
                    slash is omitted from <filename>index.php</filename>.
                </para>

                <programlisting language="text"><![CDATA[
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} -s [OR]
RewriteCond %{REQUEST_FILENAME} -l [OR]
RewriteCond %{REQUEST_FILENAME} -d
RewriteRule ^.*$ - [NC,L]
RewriteRule ^.*$ index.php [NC,L]
]]></programlisting>

                <para>
                    <property>mod_rewrite</property>を設定する方法はたくさんあります。
                    もし、詳細をお好みでしたら、Jayson Minard の<ulink
                        url="http://devzone.zend.com/a/70">Blueprint for PHP Applications:
                    Bootstrapping</ulink>をご覧下さい。
                </para>
            </sect3>

        </sect2>

        <sect2 id="project-structure.rewrite.iis">
            <title>Microsoft Internet Information サーバ</title>

            <para>
                As of version 7.0, <acronym>IIS</acronym> now ships with a standard rewrite engine.
                You may use the following configuration to create the appropriate rewrite rules.
            </para>

            <programlisting language="xml"><![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<configuration>
    <system.webServer>
        <rewrite>
            <rules>
                <rule name="Imported Rule 1" stopProcessing="true">
                    <match url="^.*$" />
                    <conditions logicalGrouping="MatchAny">
                        <add input="{REQUEST_FILENAME}"
                             matchType="IsFile" pattern=""
                             ignoreCase="false" />
                        <add input="{REQUEST_FILENAME}"
                             matchType="IsDirectory"
                             pattern=""
                             ignoreCase="false" />
                    </conditions>
                    <action type="None" />
                </rule>
                <rule name="Imported Rule 2" stopProcessing="true">
                    <match url="^.*$" />
                    <action type="Rewrite" url="index.php" />
                </rule>
            </rules>
        </rewrite>
    </system.webServer>
</configuration>
]]></programlisting>
        </sect2>
    </sect1>
</appendix>