routage

De belles URL sont un must absolu pour toute application Web sérieuse. Cela signifie que les URL laides comme index.php?article_id=57 seront remplacées par /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

• #🎜🎜# Créer des itinéraires complexes qui seront mappés aux contrôleurs #🎜🎜#
• #🎜🎜 # Générer des URL dans les modèles et les contrôleurs#🎜🎜#
• #🎜🎜#Charger les ressources de routage à partir du Bundle (peut également provenir d'autres endroits)#🎜🎜#
• #🎜 🎜#Débogage routage#🎜🎜#

Exemple de routage ¶#🎜🎜# Une route fait référence au mappage d'un chemin URL (chemin) vers un contrôleur (contrôleur). Par exemple, vous souhaitez faire correspondre certaines URL : /blog/my-post et /blog/all-about-symfony, et envoyer une route vers un "can query and rendre ce billet de blog" sur le contrôleur. Le routage est très simple : #🎜🎜#

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

#🎜🎜#Définissez le modèle de routage blog_show, utilisé pour faire correspondre les URL comme /blog/*, et utilisez les paramètres pertinents ou les caractères génériques < code>slug représente et est transmis. Pour une URL telle que /blog/my-blog-post, la variable slug obtient la valeur de my-blog-post et la fournit à utilisation de votre contrôleur. Beautiful blog_show est un nom interne. Il n'a aucune signification pratique et n'est qu'un identifiant unique. Plus tard, vous pourrez l'utiliser pour générer des URL. #🎜🎜##🎜🎜#Si vous ne souhaitez pas utiliser d'annotations parce que vous ne les aimez pas, ou parce que vous ne voulez pas dépendre de SensioFrameworkExtraBundle, vous pouvez également utiliser YAML, XML ou PHP. Dans ces formats, le paramètre _controller est une clé spéciale qui indique à symfony quel contrôleur doit être exécuté pour l'URL spécifiée par la route. La chaîne _controller est appelée le nom logique. Il suit les règles et pointe vers une classe et une méthode PHP spécifiques, la méthode AppBundleControllerBlogController::showAction. #🎜🎜##🎜🎜#Félicitations ! Vous venez de créer un itinéraire et de le connecter au contrôleur. Désormais, lorsque vous visiterez /blog/my-post, le contrôleur showAction sera exécuté et la variable $slug sera égale à mon-poste. #🎜🎜##🎜🎜#Le but du routage Symfony : Mapper l'URL demandée au contrôleur. En suivant cet objectif, vous apprendrez diverses techniques qui simplifient le mappage des URL, même les plus complexes. #🎜🎜#

Routage : A y regarder de plus près ¶

Lorsqu'une requête est envoyée à votre application, elle contient l'adresse "ressource" exacte de la demande du client. Cette adresse est appelée URL (ou URI), et elle peut être /contact, /blog/read-me ou toute autre chose. Voici un exemple de requête 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 }