penghalaan

URL yang kelihatan baik adalah satu kemestian mutlak untuk sebarang aplikasi web yang serius. Ini bermakna URL hodoh seperti index.php?article_id=57 akan digantikan dengan /read/intro-to-symfony. index.php?article_id=57这类丑陋的URL要被/read/intro-to-symfony取代。

拥有灵活性是更加重要的。你将页面的URL从/blog改为/news时需要做些什么？你需要跟踪和更新多少链接以做出改变？如果你使用Symfony的路由，这就很容易了。

Symfony路由器允许你定义创造性的url，映射到应用程序的不同区域。在本章结束时，你将可以做到：

• 创建复杂的路由，它们将映射到控制器

• 在模板和控制器中生成URL

• 从Bundle中（也可以从其它地方）加载路由资源

• 对路由除错

路由样例 ¶

一个路由，是指一个URL路径（path)到一个控制器(controller）的映射。例如，你想匹配一些URL：/blog/my-post 和 /blog/all-about-symfony，并且发送路由到一个“能够查询和渲染那一篇博文”的控制器上。路由简单的很：

Annotations:// src/AppBundle/Controller/BlogController.phpnamespace AppBundle\Controller; use Symfony\Bundle\FrameworkBundle\Controller\Controller;use Sensio\Bundle\FrameworkExtraBundle\Configuration\Route; class BlogController extends Controller{
    /**
     * @Route("/blog/{slug}", name="blog_show")
     */
    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_show路由模式，用于匹配像/blog/*的URL，把相关参数或通配符用slug表示并传入。对于/blog/my-blog-post这样的URL，slug变量得到my-blog-post的值，并供你控制器使用。美观blog_show是一个内部名称，他没什么实际的意义就是一个唯一的标识。以后，你可用他来生成一些URL。

如果你不想去使用注释方式，因为你不喜欢他们，或者因为你不希望依赖于SensioFrameworkExtraBundle，你也可以使用YAML，XML或者PHP。在这些格式中，_controller参数是一个特殊的键，它告诉symfony路由指定的URL应该执行哪个控制器。_controller字符串称为逻辑名。它遵循规则指向一个特定的php类和方法，AppBundleControllerBlogController::showAction方法。

恭喜！你刚刚创建了一个路由并把它连接到控制器。现在，当你访问/blog/my-post，showAction控制器将被执行并且$slug变量就等于my-post

Mempunyai fleksibiliti adalah lebih penting. Apakah yang perlu anda lakukan untuk menukar URL halaman daripada /blog kepada /news? Berapa banyak pautan yang anda perlukan untuk menjejaki dan mengemas kini untuk membuat perubahan? Ini mudah jika anda menggunakan penghalaan Symfony.

Penghala Symfony membolehkan anda mentakrifkan URL kreatif yang memetakan ke kawasan berbeza aplikasi anda. Pada penghujung bab ini, anda akan dapat: 🎜

• 🎜Membuat laluan kompleks yang akan dipetakan kepada pengawal🎜
• 🎜Menghasilkan URL dalam templat dan pengawal🎜< li>🎜Muatkan sumber penghalaan daripada Bundle (atau dari tempat lain)🎜
• 🎜Nyahpepijat penghalaan🎜

Contoh penghalaan ¶

🎜Satu laluan merujuk kepada laluan URL (laluan) ke pemetaan pengawal (pengawal). Sebagai contoh, anda ingin memadankan beberapa URL: /blog/my-post dan /blog/all-about-symfony dan menghantar laluan ke "can query and memberikan catatan blog itu" pada pengawal. Penghalaan adalah sangat mudah: 🎜

GET /blog/my-blog-post

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',    ),));

🎜 Tentukan corak penghalaan blog_show, yang digunakan untuk memadankan URL seperti /blog/* dan gunakan slug untuk parameter yang berkaitan atau kod bebas> mewakili dan dihantar masuk. Untuk URL seperti /blog/my-blog-post, pembolehubah slug mendapat nilai my-blog-post dan memberikannya kepada penggunaan pengawal anda. blog_show ialah nama dalaman Ia tidak mempunyai makna praktikal dan hanya pengecam unik. Kemudian, anda boleh menggunakannya untuk menjana beberapa URL. 🎜🎜Jika anda tidak mahu menggunakan anotasi kerana anda tidak menyukainya, atau kerana anda tidak mahu bergantung pada SensioFrameworkExtraBundle, anda juga boleh menggunakan YAML, XML atau PHP. Dalam format ini, parameter _controller ialah kunci khas yang memberitahu symfony pengawal yang harus dilaksanakan untuk URL yang ditentukan oleh laluan. Rentetan _controller dipanggil nama logik. Ia mengikut peraturan dan menunjuk kepada kelas dan kaedah PHP tertentu, kaedah AppBundleControllerBlogController::showAction. 🎜🎜Tahniah! Anda baru sahaja mencipta laluan dan menyambungkannya kepada pengawal. Sekarang, apabila anda melawati /blog/my-post, pengawal showAction akan dilaksanakan dan pembolehubah $slug akan sama dengan saya- pos. 🎜🎜Matlamat penghalaan Symfony: Petakan URL yang diminta kepada pengawal. Mengikuti matlamat ini, anda akan mempelajari pelbagai teknik yang menjadikan pemetaan walaupun URL yang paling kompleks mudah. 🎜

Penghalaan: Pandangan lebih dekat ¶

Apabila permintaan dihantar ke aplikasi anda, ia mengandungi alamat "sumber" yang tepat bagi permintaan pelanggan. Alamat ini dipanggil URL (atau URI), dan ia boleh menjadi /contact, /blog/read-me atau apa-apa sahaja. Berikut ialah contoh permintaan HTTP: /contact、/blog/read-me或其它任何东西。下面是一个HTTP请求的例子：

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

symfony路由系统的目的是解析url，并确定调用哪个控制器。整个过程是这样的：

1. 由Symfony的前端控制器（如app.php）来处理请求。

2. symfony的核心（Kernel内核）要求路由器来检查请求。

3. 路由将输入的URL匹配到一个特定的路由,并返回路由信息，其中包括要执行的控制器信息。

4. Symfony内核执行控制器并最终返回Response对象。

路由是将一个输入URL转换成特定的工具来执行控制器。

创建路由 ¶

Symfony从一个单一的路由配置文件中加载所有的路由到你的应用程序。美观路由配置文件通常是app/config/routing.yml

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

Tujuan sistem penghalaan symfony adalah untuk menghuraikan URL dan menentukan pengawal yang hendak dipanggil. Keseluruhan prosesnya adalah seperti ini: Laluan itu sepadan dengan URL input ke laluan tertentu dan mengembalikan maklumat laluan, termasuk maklumat pengawal yang akan dilaksanakan.

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;

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;

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;

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;

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

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

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

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>

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:<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 来学习如何解决这个问题。

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

$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

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

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