ルーティング

YAML:# app/config/config.yml
framework:   
# ...
router: { resource: '%kernel.root_dir%/config/routing.yml' }

XML:<!-- app/config/config.xml --><?xml version="1.0" encoding="UTF-8" ?><container xmlns="http://symfony.com/schema/dic/services"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xmlns:framework="http://symfony.com/schema/dic/symfony"    xsi:schemaLocation="http://symfony.com/schema/dic/services        http://symfony.com/schema/dic/services/services-1.0.xsd        http://symfony.com/schema/dic/symfony        http://symfony.com/schema/dic/symfony/symfony-1.0.xsd">     <framework:config>
        <!-- ... -->
        <framework:router resource="%kernel.root_dir%/config/routing.xml" />
    </framework:config></container>

PHP:// app/config/config.php$container->loadFromExtension('framework', array(
   // ...    'router' => array(        'resource' => '%kernel.root_dir%/config/routing.php',    ),));

基本的なルーティング構成 ¶

ルートを定義するのは簡単で、一般的なアプリケーションには多くのルートが必要です。基本ルートには 2 つの部分が含まれます: path match と defaults array:

Annotations:// src/AppBundle/Controller/MainController.php // ...class MainController extends Controller{
    /**
     * @Route("/")
     */
    public function homepageAction()
    {
        // ...
    }}

YAML:# app/config/routing.yml_welcome:
    path:      /
    defaults:  { _controller: AppBundle:Main:homepage }

XML:<!-- app/config/routing.xml --><?xml version="1.0" encoding="UTF-8" ?><routes xmlns="http://symfony.com/schema/routing"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/routing        http://symfony.com/schema/routing/routing-1.0.xsd">     <route id="_welcome" path="/">
        <default key="_controller">AppBundle:Main:homepage</default>
    </route> </routes>

PHP:// app/config/routing.phpuse Symfony\Component\Routing\RouteCollection;use Symfony\Component\Routing\Route; $collection = new RouteCollection();$collection->add('_welcome', new Route('/', array(
    '_controller' => 'AppBundle:Main:homepage',))); return $collection;

ルートはホームページと一致します ( /) を作成し、AppBundle:Main:homepage コントローラーにマッピングします。 _controller文字列は、Symfony によって実行のために PHP 関数に変換されます。美的プロセスについては、この章 (コントローラーの命名パターン) で簡単に説明します。

パラメータを使用したルーティング ¶

ルーティング システムは、ルートを記述するための多くの興味深い方法をサポートしています。多くのルートには、1 つ以上の「パラメーターまたはワイルドカード」プレースホルダーを含めることができます。

Annotations:// src/AppBundle/Controller/BlogController.php // ...class BlogController extends Controller{
    /**
     * @Route("/blog/{slug}")
     */
    public function showAction($slug)
    {
        // ...
    }}

YAML:# app/config/routing.ymlblog_show:
    path:      /blog/{slug}
    defaults:  { _controller: AppBundle:Blog:show }

XML:<!-- app/config/routing.xml --><?xml version="1.0" encoding="UTF-8" ?><routes xmlns="http://symfony.com/schema/routing"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/routing        http://symfony.com/schema/routing/routing-1.0.xsd">     <route id="blog_show" path="/blog/{slug}">
        <default key="_controller">AppBundle:Blog:show</default>
    </route></routes>

PHP:// app/config/routing.phpuse Symfony\Component\Routing\RouteCollection;use Symfony\Component\Routing\Route; $collection = new RouteCollection();$collection->add('blog_show', new Route('/blog/{slug}', array(
    '_controller' => 'AppBundle:Blog:show',))); return $collection;

きれいなパスは、任意の /blog/* URL に一致します。さらに良いのは、美しい {slug} プレースホルダーが自動的にコントローラーに一致することです。つまり、URL が /blog/hello-world の場合、コントローラーの $slug 変数の値は hello-world になります。これは、ブログ投稿タイトルの文字列を照合するために使用できます。

ただし、デフォルトではすべてのプレースホルダーが必要であるため、この方法でルーティングすると /blog のような URL とは一致しません。もちろん、プレースホルダー (パラメーター) 値を defaults 配列に追加することでこれを変更することもできます。

{ワイルドカード} 条件を追加します ¶

作成したルートをざっと見てみましょう:

Annotations:// src/AppBundle/Controller/BlogController.php // ...class BlogController extends Controller{
    /**
     * @Route("/blog/{page}", defaults={"page" = 1})
     */
    public function indexAction($page)
    {
        // ...
    }     /**
     * @Route("/blog/{slug}")
     */
    public function showAction($slug)
    {
        // ...
    }}

YAML:# app/config/routing.ymlblog:
    path:      /blog/{page}
    defaults:  { _controller: AppBundle:Blog:index, page: 1 }blog_show:
    path:      /blog/{slug}
    defaults:  { _controller: AppBundle:Blog:show }

XML:<!-- app/config/routing.xml --><?xml version="1.0" encoding="UTF-8" ?><routes xmlns="http://symfony.com/schema/routing"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/routing        http://symfony.com/schema/routing/routing-1.0.xsd">     <route id="blog" path="/blog/{page}">
        <default key="_controller">AppBundle:Blog:index</default>
        <default key="page">1</default>
    </route>     <route id="blog_show" path="/blog/{slug}">
        <default key="_controller">AppBundle:Blog:show</default>
    </route></routes>

PHP:// app/config/routing.phpuse Symfony\Component\Routing\RouteCollection;use Symfony\Component\Routing\Route; $collection = new RouteCollection();$collection->add('blog', new Route('/blog/{page}', array(
    '_controller' => 'AppBundle:Blog:index',
    'page'        => 1,))); $collection->add('blog_show', new Route('/blog/{show}', array(
    '_controller' => 'AppBundle:Blog:show',))); return $collection;

問題を見つけられますか? ?どちらのルートも /blog/* のような URL に一致します。 symfony ルーティングは常に、最初に一致する (ブログ) ルートを選択します。つまり、blog_show ルートは常に一致します。対照的に、/blog/my-blog-post のような URL は、最初の (blog) ルートと一致し、my-blog-post の値を返します。 {page} パラメータに与えられます。

URLルートパラメータ/blog/2blog_list$page##/blog/my-blog-post =

{wildcard} にデフォルト値を与える ¶

高度なルーティングの例 ¶

Symfony では、強力なルーティング構造を作成して次のことを実現できます。あなたが必要とするすべて。ルーティング システムがいかに柔軟であるかを示す例を次に示します。

Annotations:// src/AppBundle/Controller/ArticleController.php // ...class ArticleController extends Controller{
    /**
     * @Route(
     *     "/articles/{_locale}/{year}/{title}.{_format}",
     *     defaults={"_format": "html"},
     *     requirements={
     *         "_locale": "en|fr",
     *         "_format": "html|rss",
     *         "year": "\d+"
     *     }
     * )
     */
    public function showAction($_locale, $year, $title)
    {
    }}

YAML:# app/config/routing.ymlarticle_show:
  path:     /articles/{_locale}/{year}/{title}.{_format}
  defaults: { _controller: AppBundle:Article:show, _format: html }
  requirements:
      _locale:  en|fr
      _format:  html|rss
      year:     \d+

XML:<!-- app/config/routing.xml --><?xml version="1.0" encoding="UTF-8" ?><routes xmlns="http://symfony.com/schema/routing"    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"    xsi:schemaLocation="http://symfony.com/schema/routing        http://symfony.com/schema/routing/routing-1.0.xsd">     <route id="article_show"        path="/articles/{_locale}/{year}/{title}.{_format}">         <default key="_controller">AppBundle:Article:show</default>
        <default key="_format">html</default>
        <requirement key="_locale">en|fr</requirement>
        <requirement key="_format">html|rss</requirement>
        <requirement key="year">\d+</requirement>     </route></routes>

PHP:// app/config/routing.phpuse Symfony\Component\Routing\RouteCollection;use Symfony\Component\Routing\Route; $collection = new RouteCollection();$collection->add(
    'article_show',
    new Route('/articles/{_locale}/{year}/{title}.{_format}', array(
        '_controller' => 'AppBundle:Article:show',
        '_format'     => 'html',
    ), array(
        '_locale' => 'en|fr',
        '_format' => 'html|rss',
        'year'    => '\d+',
    ))); return $collection;

ご覧のとおり、美しいルーティングは、{_locale} を満たす URL の一部にのみ一致します。 en または fr) および {year} は数値です。このルートでは、ピリオドを使用して 2 つのプレースホルダーを区切ることができることも示します。上記のルートで一致する URL は次のとおりです:

• ##/articles/ja/2010/my-post

• /articles/fr/2010/my-post.rss

##/articles/en/2013/my-latest-post.html

#ルートの特定の部分を「グローバル構成」にしたい場合があります。 symfony はサービスコンテナパラメータを使用してこれを行うことができます。詳細については、「ルーティングでサービス コンテナ パラメータを使用する方法」を参照してください。

		= 2
blog_show	$スラッグ	私のブログ投稿

##Bundle##AppBundle

コントローラーは次のようになります:

// src/AppBundle/Controller/BlogController.phpnamespace AppBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller; class BlogController extends Controller{
    public function showAction($slug)
    {
        // ...
    }}

Symfony が Blog (Blog) にクラス名として文字列 Controller を追加したことに注意してください。 =>BlogController)、文字列 Action をメソッド名として追加します (show=>showAction)。

FQCN クラス名とメソッド AppBundle\Controller\BlogController::showAction を使用してこのクラスを指定することもできます。ただし、いくつかの単純な命名規則に従えば、論理名はよりシンプルかつ柔軟になります。

ルーティング パラメータとコントローラ パラメータ ¶

ルーティング パラメータ ({slug} など) はパラメータとして使用されるため、非常に重要です。コントローラー メソッドの場合:

public function showAction($slug){
  // ...}

実際には、defaults セットはパラメーター値をフォーム配列にマージします。配列内の各キーはコントローラーのパラメーターとして使用されます。

つまり、コントローラー メソッドのパラメーターごとに、Symfony2 はその名前に基づいてルート パラメーターを検索し、その値をパラメーターとしてコントローラーにポイントします。次の変数は (何らかの方法で) showAction() メソッドのパラメータとして使用されます:

• $_locale

• $year

• $title

• $_format

• $_controller

• $_route

プレースホルダーと defaults セットは、$_controller 変数であってもマージされます。詳細については、「コントローラーとして – ルート パラメーターをコントローラーに渡す」を参照してください。

ルートで追加情報を定義し、コントローラーでそれにアクセスすることもできます。詳細については、「ルートからコントローラーに追加情報を渡す方法」を参照してください。

URL の生成¶

ルーティング システムは、URL の生成にも使用されます。実際には、ルーティングは双方向のシステムです。URL をコントローラー パラメーターにマッピングし、ルート パラメーターを URL にマッピングし直します。 match() メソッドと generate() メソッドは、この双方向システムを構成します。前の blog_show の例を使用すると:

$params = $this->get('router')->match('/blog/my-blog-post');
// array(
//     'slug'        => 'my-blog-post',
//  '_controller' => 'AppBundle:Blog:show',
// ) 
$uri = $this->get('router')->generate('blog_show', array(
  'slug' => 'my-blog-post'));
// /blog/my-blog-post

URL を生成するには、ルートの名前 (blog_show など) とワイルドカード (たとえば、 スラッグ = 私のブログ投稿 )。この情報を使用すると、任意の URL を簡単に生成できます:

class MainController extends Controller{
    public function showAction($slug)
    {
        // ...         $url = $this->generateUrl(
            'blog_show',
            array('slug' => 'my-blog-post')
        );
    }}

コントローラーでは、symfony の親クラスであるコントローラーを継承しない場合、generateUrl()Shortcut を使用できません。メソッドですが、ルーターの generate()Service メソッドを使用することもできます:

$url = $this->container->get('router')->generate(
    'blog_show',
    array('slug' => 'my-blog-post'));

次のセクションでは、テンプレートで URL アドレスを生成する方法を学習します。

アプリケーション フロントエンドで Ajax リクエストを使用する場合は、ルーティング設定に基づいて JavaScript で URL を生成することができます。 FOSJsRoutingBundle を使用すると、次のことが可能になります。

var url = Routing.generate(
    'blog_show',
    {"slug": 'my-blog-post'});

詳細については、このバンドル ドキュメントをお読みください。

クエリ文字列を使用した URL の生成 ¶

この generate メソッドでは、ワイルドカード配列を使用して URL を生成します。ただし、追加のキーと値のペアが追加された場合は、新しい URL を生成するためのクエリ文字列として追加されます。

$this->get('router')->generate('blog', array(
    'page' => 2,
    'category' => 'Symfony'));// /blog/2?category=Symfony

Generate URL in template ¶

Whenアプリケーション ページ間を接続する場合、これを行う最も一般的な場所は、テンプレートから URL を生成することです。これを行うことは実際には前と同じですが、テンプレート ヘルパー関数を使用します。

Twig:<a href="{{ path('blog_show', {'slug': 'my-blog-post'}) }}">
  Read this blog post.
</a>

php:<a href="<?php echo $view['router']->path('blog_show', array(
    'slug' => 'my-blog-post',)) ?>">
    Read this blog post.
</a>

絶対 URL を生成する ¶

デフォルトでは、ルーターは相対 URL (たとえば、 /ブログとして)。コントローラーでは、generateUrl() メソッドの 3 番目のパラメーターを UrlGeneratorInterface::ABSOLUTE_URL に設定するのは非常に簡単です。

use Symfony\Component\Routing\Generator\UrlGeneratorInterface;
 $this->generateUrl('blog_show', array('slug' => 'my-blog-post'), UrlGeneratorInterface::ABSOLUTE_URL);
// http://www.example.com/blog/my-blog-post

テンプレート エンジン Twig では、path() 関数 (相対 URL を生成) の代わりに url() 関数 (絶対 URL を生成) を使用します。 . URL）。 php では、UrlGeneratorInterface::ABSOLUTE_URL:

Twig:<a href="{{ url('blog_show', {'slug': 'my-blog-post'}) }}">
  Read this blog post.
</a>

php:<a href="<?php echo $view['router']->url('blog_show', array(
    'slug' => 'my-blog-post',)) ?>">
    Read this blog post.
</a>

当生成一个绝对URL链接时，所使用的主机自动检测当前使用的Request对象。当生成从web环境外的绝对URL（例如一个控制台命令）这是行不通的。请参见 如何从控制台生成URL 来学习如何解决这个问题。

概要 ¶

ルーティングは、受信リクエストをリクエストの処理に使用される URL にマップする URL です。コントローラー関数のシステムです。 。これにより、美しい URL を指定し、アプリケーションの機能を URL から「切り離す」ことができます。ルーティングは双方向のメカニズムであるため、URL の生成にも使用できます。

続行! ¶

ルーティング、確認されました!さて、コントローラーの電源ブロックを解除してください。

Controller クラス	メソッド名
BlogController	showAction