.. index::
   single: Installation

Symfony のインストールと設定
============================

この章の目標は、Symfony ベースのアプリケーションを動作させる準備をすることです。
幸運なことに、Symfony では「ディストリビューション」を提供しています。
これは Symfony の実用的な「スターター」プロジェクトで、ダウンロードすればすぐに開発を始められます。

.. tip::

    ソースコード管理システムの元でプロジェクトを新規作成し、ソースコード管理システムに登録するベストプラクティスを知りたい方は、\ `ソースコード管理システムで管理するには`_\ の節を参照してください。

Symfony2 ディストリビューションのダウンロード
----------------------------------------------

.. tip::

    まずはじめに、PHP 5.3.2 以上が動作する Web サーバ(Apache など)がインストールされ、設定済みかどうか確認して下さい。
    Symfony2 の必要条件について詳しくは、\ :doc:`Symfony2 の実行に必要な要件</reference/requirements>` を参照してください。

Symfony2 は「ディストリビューション」をパッケージングしています。
これは Symfony2 コアライブラリ、厳選された便利なバンドル、気の利いたディレクトリ構造、
そしていくつかの初期設定を含んだ、完全に実用的なアプリケーションです。
Symfony2 のディストリビューションをダウンロードすることは、
アプリケーションをすぐに開発し始められる実用的なアプリケーションのスケルトンをダウンロードしている事にもなります。

はじめに Symfony2 ダウンロードページ(\ `http://symfony.com/download`_\ )にアクセスしてください。
ページ上に *Symfony Standard Edition* という文字が見えると思います。
これは Symfony2 のメインのディストリビューションです。
ここでは２つの項目について選ぶ必要があります。

* ``.tgz`` 形式、もしくは \ ``.zip`` 形式の選択 - どちらも中身は同じですので、
  使いやすい方を選んでください。

* ディストリビューションにベンダーを含めるか含めないかの選択
  `Git`_ がインストール済みであれば 「without vendors (ベンダーライブラリを含めない)」をダウンロードするべきです。
  そうすることで、サードパーティーやベンダーのライブラリを含めるときに、多少柔軟に追加ができるでしょう。

アーカイブの中の１つをローカルウェブサーバーの root ディレクトリの何処かにダウンロードして解凍してください。
UNIX のコマンドラインで、ダウンロードしたファイル形式に基づき、以下のコマンドのどちらかを実行すると解凍できます(\ ``###`` を実際のファイル名に置換してください\ )。

.. code-block:: bash

    # .tgz ファイル用
    tar zxvf Symfony_Standard_Vendors_2.0.###.tgz

    # .zip ファイル用
    unzip Symfony_Standard_Vendors_2.0.###.zip

解凍し終わったら、以下のような ``Symfony/`` ディレクトリがあるでしょう。

.. code-block:: text

    www/ <- ウェブルートディレクトリ
        Symfony/ <- 解凍したディレクトリ
            app/
                cache/
                config/
                logs/
            src/
                ...
            vendor/
                ...
            web/
                app.php
                ...

ベンダーの更新
~~~~~~~~~~~~~~~~

最後に、もし「without vendors」のアーカイブをダウンロードしたならば、
以下のコマンドをコマンドラインから実行してベンダーをインストールして下さい。

.. code-block:: bash

    php bin/vendors install

このコマンドは Symfony自体を含む必要なベンダーライブラリすべてを ``vendor/`` ディレクトリにダウンロードします。

設定とセットアップ
~~~~~~~~~~~~~~~~~~~~~~~

この時点で、必要とされるサードパーティのライブラリすべてが、 ``vendor/`` ディレクトリに存在します。
また標準のアプリケーションが ``app/`` ディレクトリにセットアップされ、
いくつかのサンプルコードが ``src/`` ディレクトリの中にあります。

Symfony2 には、ウェブサーバーと PHP が Symfony を使うことができる設定になっているかを、ウェブインタフェースで確認するための設定テスターが同梱されています。以下の URL を使って設定を確認してみてください。

.. code-block:: text

    http://localhost/Symfony/web/config.php

何か問題がある場合は、先に進む前に今のうちに修正してください。

.. sidebar:: パーミッション設定

    よくある問題としては、 ``app/cache`` と ``app/logs`` ディレクトリが、ウェブサーバーとコマンドラインの
    どちらのユーザーでも書き込み可能でなければならないことです。
    UNIX システム上でウェブサーバーのユーザーとコマンドラインユーザーが異なる場合は、
    以下のコマンドをプロジェクト内で1度実行するだけで、パーミッションを適切にセットアップできます。
    ``www-data`` はウェブサーバーのユーザーに、\ ``yourname`` はコマンドラインユーザーに置き換えてください。

    **1. chmod +a コマンドをサポートしているシステム上で ACL を使う**


    多くのシステムでは ``command +a`` コマンドが使えます。
    まず最初にこのコマンドを試してみてください。
    もしエラーが起きた場合は、次の方法を試してみてください。

    .. code-block:: bash

        rm -rf app/cache/*
        rm -rf app/logs/*

        sudo chmod +a "www-data allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs
        sudo chmod +a "yourname allow delete,write,append,file_inherit,directory_inherit" app/cache app/logs

    **2. chmod +a コマンドをサポートしていないシステム上で ACL を使う**

    ``chmod +a`` コマンドがサポートされていないシステムもあります。
    このようなシステムでも ``setfacl`` ユーティリティがサポートされているかもしれません。
    たとえば Ubuntu であれば、まず setfacl ユーティリティをインストールし、使用しているパーティションに対して `ACL サポートを有効にする`_ 設定を行ってください。

    .. code-block:: bash

        sudo setfacl -R -m u:www-data:rwx -m u:yourname:rwx app/cache app/logs
        sudo setfacl -dR -m u:www-data:rwx -m u:yourname:rwx app/cache app/logs

    **3. ACL を使わない方法**

    もしディレクトリの ACL を変更する方法がなければ、
    cache と log ディレクトリにグループ書き込み権限か全てのユーザー書き込み権限
    (ウェブサーバーのユーザーとコマンドラインユーザーが同じグループかどうかに依存する)を与えるために
    umask を変更する必要があります。

    権限を与えるために、以下の行を ``app/console``\ 、\ ``web/app.php``\ 、\ ``web/app_dev.php`` の
    ファイルの先頭に記述します。

    .. code-block:: php

        umask(0002); // This will let the permissions be 0775

        // or

        umask(0000); // This will let the permissions be 0777

    umask の変更はスレッドセーフではないため、これらのファイルにアクセスする場合は
    ACLを使うことをおすすめしています。

すべて設定したら、「Go to the Welcome page(ウェルカムページに行く)」をクリックして、最初の「リアルな」\ Symfony2 のウェブページをリクエストしましょう。


.. code-block:: text

    http://localhost/Symfony/web/app_dev.php/

Symfony2 今までの一苦労を労ってくれるでしょう。

.. image:: /images/quick_tour/welcome.jpg

開発を始める
------------

これで完全に実用的な Symfony2 アプリケーションになりましたので
開発を始められます！ディストリビューションの中にはいくつかのサンプルコードが含まれています。
その中に含まれる ``README.rst`` ファイルを(テキストファイルとして開いて)確認し、
どんなサンプルコードが含まれていて、後でどうやってそのサンプルコードを削除するかを学んでください。

もし Symfony が初めてでしたら、\ ":doc:`page_creation`" を御覧ください。
ページの作り方、設定の変え方、など新しいアプリケーションに必要なすべきことが載っています。

ソースコード管理システムで管理するには
--------------------------------------

``Git`` や ``Subversion`` のようなバージョンコントロールシステムを使っている場合は
バージョンコントールシステムのセットアップやいつも通りにプロジェクトをコミットし始めることができます。
Symfony Standard Edition は、新しいプロジェクトを開始する起点として使うことができます。

Git を使ったプロジェクトのセットアップに関する詳細な手順については、\ :doc:`/cookbook/workflow/new_project_git` を参照してください。


``vendor/`` ディレクトリを除外する
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

*without vendors* アーカイブをダウンロードした場合、\ ``vendor/`` ディレクトリ全体がソースコード管理対象から除外されるよう設定し、ソースコード管理システムにコミットされないようにできます。
``Git`` を使っている場合は、次の内容で ``.gitignore`` ファイルを作成して追加するだけで、除外設定が完了します。

.. code-block:: text

    vendor/

これで vendor ディレクトリはソースコード管理システムにコミットされなくなったでしょう。
他の誰かがプロジェクトをクローンしたりチェックアウトする時に、
その人は必要なベンダーライブラリ全てをダウンロードするために
``php bin/vendors install`` というスクリプトを実行するだけで良いので、
とても良いと思います(本当に素晴らしいと思います!)。


.. _`ACL サポートを有効にする`: https://help.ubuntu.com/community/FilePermissions#ACLs
.. _`http://symfony.com/download`: http://symfony.com/download
.. _`Git`: http://git-scm.com/
.. _`GitHub Bootcamp`: http://help.github.com/set-up-git-redirect

.. 2011/07/23 uechoco 9de84d1fcc3fb0f641efa5b36973ab95cddf5faa
.. 2011/08/14 hidenorigoto b21a16f5196fae0d0f1f0a20d69777ea0e685911