blogチュートリアル(5) ブログ閲覧ページの作成
============================================

.. note::

    この記事は、Symfony 2.0.7 で動作確認しています。

ページの作成
------------

Symfony2 で新しくページを作成する場合、主に2つのステップが必要になります（参考：ガイドブックの\ `Symfony2 でのページ作成`_\ ）。

- **ルート(route)の作成** : ルーティングはURIとコントローラを関連付ける役割があります。Symfony2 は Web リクエストを元に、定義されたルーティングの中からマッチするものを見つけ出し、そのコントローラのアクションを実行します。
- **コントローラの作成** : コントローラはWebリクエストを受け取って何らかの処理をした後に、Symfony2 の\ ``Response``\ オブジェクトを返す役割をになっています。
- (必要に応じて) **テンプレートの作成** : コントローラでレンダリングするテンプレートファイルです。

ルーティングの作成
------------------

デフォルトでは、アプリケーション全体のルーティング設定ファイルは ``app/config/routing.yml`` です。
ほかの Symfony2 のアプリケーションと同様に、YAML、XML、PHPの形式で記述することができます。
コントローラに直にアノテーションを書いてルーティングを定義する方法もありますが、ここでは標準的な YAML 形式で記述します。

以前実行した ``generate:bundle`` コマンドによって、\ ``app/config/routing.yml`` に以下の記述が追加されています。

.. code-block:: yaml

    # app/config/routing.yml
    MyBlogBundle:
        resource: "@MyBlogBundle/Resources/config/routing.yml"
        prefix:   /

この記述で、以下のようにルーティング名（\ ``MyBlogBundle`` → ``blog``\ ）と prefix（\ ``/`` → ``/blog``\ ） を変更します。

.. code-block:: yaml

    # app/config/routing.yml
    blog:
        resource: "@MyBlogBundle/Resources/config/routing.yml"
        prefix: /blog

このルーティング定義の意味は、「\ ``/blog`` から始まる URI に対応するルーティングは ``MyBlogBundle`` バンドル内の ``Resources/config/routing.yml`` で定義している。このルーティングルールを blog と呼ぶ」となります。
このように Symfony2 では、あるルーティング定義ファイルから別のルーティング定義ファイルを読み込むことができます。

次に、読み込まれる側のルーティング定義ファイルを記述します。自動生成された状態では ``/hello/{name}`` という URL に対する
ルーティング定義が記述されていますが、すべて削除して次のように書き換えてください:

.. code-block:: yaml

    # src/My/BlogBundle/Resources/config/routing.yml
    blog_index:
        pattern:  /
        defaults: { _controller: MyBlogBundle:Default:index }

    blog_show:
        pattern:  /{id}/show
        defaults: { _controller: MyBlogBundle:Default:show }

1つのルーティングルールは、2つの要素で成り立っています。
1つ目の要素の ``pattern`` は、どのようなURIがこのルート(route)にマッチするかを表しています。
このパターンが評価される際はprefixも考慮されることに注意してください（/blog）。
もう1つの要素の ``defaults`` は、どのコントローラが実行されるかを表しています。

さきほどのprefix定義を含めて考えると、\ ``/blog/`` というURIでアクセスされたときに、\ ``MyBlogBundle`` の ``Default`` コントローラの ``index`` アクションを実行するように定義しています。
このルーティングルールに対して、blog_indexという名前をつけています。

他にもルーティングの定義では、プレースホルダー シンタックスなどを含む、柔軟で強力な機能がたくさんあります。
詳しくは、ガイドブックの\ `ルーティング`_\ を参照してください。


コントローラの作成
------------------

さきほど作成したルーティングでは、\ ``/blog/`` というURIでアクセスされると、\ ``MyBlogBundle:Default:index`` がフレームワークによって実行されるように定義しました。
ページの作成の2つ目のステップとして、コントローラを作成していきます。

``init:bundle`` コマンドでバンドルを作成しているので、\ ``MyBlogBundle`` にはすでに ``DefaultController`` が作られているでしょう。
ファイルの中を次のように変更します:

.. code-block:: php

    <?php
    // src/My/BlogBundle/Controller/DefaultController.php
    namespace My\BlogBundle\Controller;

    use Symfony\Bundle\FrameworkBundle\Controller\Controller;

    class DefaultController extends Controller
    {
        public function indexAction()
        {
            $em = $this->getDoctrine()->getEntityManager();
            $posts = $em->getRepository('MyBlogBundle:Post')->findAll();
            return $this->render('MyBlogBundle:Default:index.html.twig', array('posts' => $posts));
        }

        public function showAction($id)
        {
            $em = $this->getDoctrine()->getEntityManager();
            $post = $em->find('MyBlogBundle:Post', $id);
            return $this->render('MyBlogBundle:Default:show.html.twig', array('post' => $post));
        }
    }

コントローラの各アクションは、メソッドの返り値として ``Response`` オブジェクトを返す必要があります。
``render()`` メソッドを使うと、テンプレートを描画してその ``Response`` オブジェクトを返す一連の流れを
簡単に記述することができます。

``index`` アクション（\ ``indexAction()`` メソッド）の中身を見てみましょう。

最初の行では、Doctrin2の ``EntityManager`` オブジェクトを取得しています。
Doctrine2では、すべてのDB操作を ``EntityManager`` を通じて行います。

2行目では、Postモデルの ``Repository`` オブジェクトを取得し、\ ``findAll()`` メソッドで全件取得しています。
Doctrine2の ``Repository`` オブジェクトは、個々のモデルに対するクエリのカプセル化を行うことができます。
``Repository`` オブジェクトはモデルごとに独自のクラスとして定義して、独自のメソッドを定義することができます。
モデルごとに定義しなかった場合は、Doctrine2の標準の ``Repository`` オブジェクトが採用されます。

3行目では、\ ``render()`` メソッドを用いて、テンプレートファイルを描画し、\ ``Response`` オブジェクトを返却しています。
テンプレートファイルの命名規則は、以下のようになっています。

.. code-block:: text

    BundleName:ControllerName:TemplateName

例えば ``MyBlogBundle:Default:index.html.twig`` であれば、\ ``MyBlogBundle`` がバンドル名、\ ``Default`` がコントローラ名、\ ``index.html.twig`` がテンプレート名を指します。
この時、テンプレートファイルは ``src/My/BlogBundle/Resources/views/Default/index.html.twig`` を参照します。

.. _`Symfony2 でのページ作成`: http://docs.symfony.gr.jp/symfony2/book/page_creation.html 
.. _`ルーティング`: http://docs.symfony.gr.jp/symfony2/book/routing.html