搜索<一个target="_blank" href="https://algolia.com/?utm_source=symfony&utm_medium=link&utm_campaign=symfony_documentation">Algolia< /div>

路由

 编辑该页面

警告:你浏览的文档欧宝体育电话<一个href=”//www.oldmanjams.com/releases/2.2">欧宝娱乐app下载地址Symfony 2.2,不再维护。

读<一个href=”//www.oldmanjams.com/doc/current/routing.html">这个页面的更新版本Symf欧宝娱乐app下载地址ony 6.2(当前的稳定版本)。

index . php ? article_id = 57赞成这样/读/ intro-to-sy欧宝娱乐app下载地址mfony。

灵活性是更重要的。如果您需要更改一个页面的URL/博客来/欧宝app在哪里找新闻吗?你需要多少链接应该追捕和更新做出改变吗?如果你使用Symfony的路由器欧宝娱乐app下载地址,改变很简单。

Symf欧宝娱乐app下载地址ony2路由器允许您定义创造性的url映射到应用程序的不同区域。在本章结束时,您将能够:

  • 创建复杂的路由映射到控制器
  • 内部生成的url模板和控制器
  • 加载路由资源包(或其他地方)
  • 调试你的路线

/博客/我的帖子或/博客/ all-about-s欧宝娱乐app下载地址ymfony并将其发送到控制器,可以查找和渲染,博客条目。路线很简单:

  • YAML
  • XML
  • PHP
1 2 3 4
# app / config / routing.ymlblog_show:路径:/博客/{蛞蝓}默认值:{_controller:AcmeBlogBundle:博客:显示}

2.2

的路径选择在Symfony2.2是新的,欧宝娱乐app下载地址模式用于旧版本。

定义的路径blog_show路线就像/博客/ *通配符在哪里的名字吗鼻涕虫。的网址/博客/我的博客帖子,鼻涕虫变量的值我的博客帖子可供你使用的控制器(继续阅读)。

的_controller参数是一个特殊的关键告诉Symfony控制器时应该执行的URL匹配这条路。欧宝娱乐app下载地址的_controller字符串被称为<一个href=”//www.oldmanjams.com/doc/2.2/book/routing.html" class="reference internal">逻辑名。它遵循一个模式,点到一个特定的PHP类和方法:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17
/ / src / Acme / BlogBundle /控制器/ BlogController.php名称空间Acme\BlogBundle\控制器;使用欧宝娱乐app下载地址\包\FrameworkBundle\控制器\控制器;类BlogController扩展控制器{公共函数showAction(美元鼻涕虫){/ /使用$蛞蝓变量来查询数据库美元博客=……;返回美元这- >呈现(“AcmeBlogBundle:博客:show.html.twig”,数组(“博客”= >美元博客));}}

恭喜你!您刚刚创建了自己的第一个路线和连接到控制器。现在,当你访问/博客/我的帖子,showAction控制器将和执行美元蛞蝓变量就等于我的帖子。

这是Symfony2路由器的目标:请求的URL映欧宝娱乐app下载地址射到一个控制器。在这个过程中,您将了解各种各样的技巧,让即使是最复杂的url映射简单。

/联系,/博客/缺点或者做其他任何事情。采取以下HTTP请求的例子:

1
获得/博客/我的博客帖子

Symfony2路由系统的目的是欧宝娱乐app下载地址来解析这个URL并确定哪些控制器应该执行。整个过程是这样的:

  1. 请求是由Symfony2前端控制器(如。欧宝娱乐app下载地址app.php);
  2. Symf欧宝娱乐app下载地址ony2核心(即内核)要求路由器检查请求;
  3. 路由器匹配传入的URL到一个特定的路线,并返回路线信息,包括控制器,应该执行;
  4. Symf欧宝娱乐app下载地址ony2内核执行控制器,最终返回响应对象。
欧宝娱乐app下载地址Symfony2请求流”><figcaption> <p>路由层是一个工具,将传入的URL转换为一个特定的控制器执行。</p> </figcaption> </figure> </div> <div class=

应用程序/配置/ routing.yml,但可以配置为任何东西(包括XML或PHP文件)通过应用程序配置文件:

  • YAML
  • XML
  • PHP
1 2 3 4
# app / config / config.yml框架:#……路由器:{资源:“% kernel.root_dir % / config / routing.yml”}

提示

尽管所有线路都从单个文件加载,这是常见的做法包括额外的路由资源。这样做,只是主要的路由配置文件中指出哪些外部文件应该包括在内。看到<一个href=”//www.oldmanjams.com/doc/2.2/book/routing.html" class="reference internal">路由节以获取更多信息。

路径匹配和违约数组:

  • YAML
  • XML
1 2 3
_welcome:路径:/默认值:{_controller:AcmeDemoBundle:主要:主页}

这条路线匹配的主页(/),地图AcmeDemoBundle:主要:主页控制器。的_controller字符串是由Symfony2翻译成一个实际的PHP欧宝娱乐app下载地址函数并执行。这一过程将在不久解释道<一个href=”//www.oldmanjams.com/doc/2.2/book/routing.html" class="reference internal">路由部分。

  • YAML
  • XML
  • PHP
1 2 3
blog_show:路径:/博客/{蛞蝓}默认值:{_controller:AcmeBlogBundle:博客:显示}

路径将匹配任何样子/博客/ *。更好的是,相匹配的值{蛞蝓}占位符可以在你的控制器。换句话说,如果URL/博客/ hello world,一个美元蛞蝓变量的值hello world将控制器中可用。这可以被使用,例如,加载博客匹配的字符串。

将路径不然而,简单地比赛/博客。这是因为,默认情况下,所有需要占位符。这可以通过添加一个占位符值被改变违约数组中。

  • YAML
  • XML
  • PHP
1 2 3
博客:路径:/博客默认值:{_controller:AcmeBlogBundle:博客:索引}

到目前为止,这条路线是尽可能简单——它不包含占位符,只会匹配的URL/博客。但是,如果你需要这条路线来支持分页,在哪里/博客/ 2博客条目显示第二页?有一个新的更新途径{页面}占位符:

  • YAML
  • XML
  • PHP
1 2 3
博客:路径:页面/博客/ {}默认值:{_controller:AcmeBlogBundle:博客:索引}

就像{蛞蝓}占位符之前的值匹配{页面}可以在你的控制器。它的值可以用来确定哪些的博客显示给定的页面。

但坚持!因为占位符需要在默认情况下,这条路线将不再匹配简单/博客。相反,看到博客的第一页,您需要使用URL/博客/ 1!既然没有办法丰富的web应用程序的行为,使修改路线{页面}可选参数。这是通过包括它违约集合:

  • YAML
  • XML
  • PHP
1 2 3
博客:路径:页面/博客/ {}默认值:{_controller:AcmeBlogBundle:博客:指数,页面:1}

通过添加页面到违约的关键,{页面}占位符不再是必需的。URL/博客将匹配这条路线的价值页面参数将被设置为1。URL/博客/ 2也会匹配,给吗页面参数的值2。完美的。

URL 路线 参数
/博客 博客 {页面}= 1
/博客/ 1 博客 {页面}= 1
/博客/ 2 博客 {页面}= 2

提示

路线和可选参数时不会使用斜杠匹配请求(即。/博客/不匹配,/博客将匹配)。

  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7
博客:路径:页面/博客/ {}默认值:{_controller:AcmeBlogBundle:博客:指数,页面:1}blog_show:路径:/博客/{蛞蝓}默认值:{_controller:AcmeBlogBundle:博客:显示}

你能发现这个问题吗?注意,这两个航线模式相匹配的URL的样子/博客/ *。Symf欧宝娱乐app下载地址ony路由器总是选择第一个找到匹配的路线。换句话说,blog_show路线从来没有是匹配的。相反,一个URL/博客/我的博客帖子将匹配第一个路线(博客),返回一个没有意义的价值我的博客帖子到{页面}参数。

URL 路线 参数
/博客/ 2 博客 {页面}= 2
/博客/我的博客帖子 博客 {页面}=我的博客帖子

这个问题的答案是添加路线需求。本例中的路线将工作完美的如果页面/博客/ {}路径只有匹配的url的地方{页面}部分是一个整数。幸运的是,可以很轻松地添加正则表达式要求为每个参数。例如:

  • YAML
  • XML
  • PHP
1 2 3 4 5
博客:路径:页面/博客/ {}默认值:{_controller:AcmeBlogBundle:博客:指数,页面:1}要求:页面:\ d +

的\ d +要求是一个正则表达式表示的值{页面}参数必须是一个数字(即数量)。的博客路线仍将匹配一个URL/博客/ 2(因为2是一个数字),但它将不再匹配一个URL/博客/我的博客帖子(因为我的博客帖子是不一个数字)。

因此,一个URL/博客/我的博客帖子现在将正确地匹配blog_show路线。

URL 路线 参数
/博客/ 2 博客 {页面}= 2
/博客/我的博客帖子 blog_show {蛞蝓}=我的博客帖子

早些时候路线总是赢

这一切意味着什么路线的顺序是非常重要的。如果blog_show路线之上博客路线,URL/博客/ 2将匹配blog_show而不是博客自{蛞蝓}参数的blog_show没有要求。通过使用适当的命令和聪明的要求,你可以完成任何事情。

自正则表达式参数要求,每个需求的复杂性和灵活性是完全取决于你。假设您的应用程序的主页上有两种不同的语言,基于URL:

  • YAML
  • XML
  • PHP
1 2 3 4 5
主页:路径:/{文化}默认值:{_controller:AcmeDemoBundle:主要:主页,文化:在}要求:文化:在| fr

为传入请求{文化}部分的URL匹配正则表达式(en | fr)。

/ {文化}= en
/ en {文化}= en
/ fr {文化}= fr
/ es 这条路不匹配

  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7 8 9
联系人:路径:/联系默认值:{_controller:AcmeDemoBundle:主要:接触}方法:(获得)contact_process:路径:/联系默认值:{_controller:AcmeDemoBundle:主要:contactProcess}方法:(职位)

2.2

的方法选择是在Symfony2.2补充道。欧宝娱乐app下载地址使用_method在旧版本的要求。

尽管这两个航线有相同的路径(/联系),第一个将匹配只能请求路由和第二只匹配POST请求。这意味着您可以通过相同的显示形式和提交表单的URL,而使用不同的控制器的两个动作。

请注意

如果没有方法指定的路线将匹配所有方法。

2.2

2.2主机匹配支持添加Symfony欧宝娱乐app下载地址

你也可以匹配HTTP主机传入的请求。有关更多信息,请参见<一个href=”//www.oldmanjams.com/doc/2.2/components/routing/hostname_pattern.html" class="reference internal">如何匹配基于主机的路由在路由组件文档。欧宝体育电话

  • YAML
  • XML
  • PHP
1 2 3 4 5 6 7
article_show:路径:/文章/{文化}/{一}/{标题}{_format}。默认值:{_controller:AcmeDemoBundle:文章:显示,_format:html}要求:文化:在| fr_format:html | rss年:\ d +

正如您所看到的,这条路如果只会匹配{文化}URL的一部分在或fr如果{一}是一个数字。这条路还展示了如何使用占位符之间的一个点,而不是削减。的url匹配这条路线的样子:

  • /文章/ en / 2010 /我的帖子
  • / / fr / 2010 / my-post.rss文章
  • / / en / 2013 / my-latest-post.html文章

特殊的_format路由参数

这个例子还强调了特殊_format路由参数。使用这个参数时,匹配的值变成了“请求格式”请求对象。最终,请求格式设置等用于这样的事情内容类型的响应(如json请求格式转化为内容类型的application / json)。它也可以用于控制器来呈现不同的模板的每个值_format。的_format参数是一个非常强大的方式来呈现相同的内容在不同的格式。

请注意

有时你想让你的某些部分全球航线可配置的。欧宝娱乐app下载地址Symfony2.1为你提供了一个方法通过利用服务容器参数。阅读更多关于这个的”<一个href=”//www.oldmanjams.com/doc/2.2/cookbook/routing/service_container_parameters.html" class="reference internal">如何使用服务容器参数在你的路线吗。

_controller:如您所见,这个参数是用来确定哪些时控制器执行的路线相匹配;
  • _format:用于设置请求格式(<一个href=”//www.oldmanjams.com/doc/2.2/book/routing.html" class="reference internal">阅读更多);< /li>
  • _locale:用于设置语言环境的请求(<一个href=”//www.oldmanjams.com/doc/2.2/book/translation.html" class="reference internal">阅读更多);< /li>

    提示

    如果你使用_locale的路线,参数值也将存储在会话中,以便后续请求保持同样的语言环境。

    • _controller控制器参数,后者决定时应该执行这条路线相匹配。这个参数使用一个简单的字符串模式称为逻辑控制器名称PHP, Sym欧宝娱乐app下载地址fony映射到一个特定的方法和类。该模式有三个部分,每个冒号隔开:

    包:控制器:行动

    例如,一个_controller的价值AcmeBlogBundle:博客:显示意思是:

    包 控制器类 方法名称
    AcmeBlogBundle BlogController showAction

    控制器可能会看起来像这样:

    1 2 3 4 5 6 7 8 9 10 11 12
    / / src / Acme / BlogBundle /控制器/ BlogController.php名称空间Acme\BlogBundle\控制器;使用欧宝娱乐app下载地址\包\FrameworkBundle\控制器\控制器;类BlogController扩展控制器{公共函数showAction(美元鼻涕虫){/ /……}}

    请注意,Symfony添欧宝娱乐app下载地址加字符串控制器类名(博客= >BlogController),行动方法名(显示= >showAction)。

    你也可以参考这个控制器使用完全限定类名和方法:Acme \ BlogBundle \控制器\ BlogController: showAction。但如果你遵循一些简单的规则,逻辑名称更简洁,并允许更大的灵活性。

    请注意

    除了使用逻辑名或完全限定类名,Symfony支持第三种方法指的是一个控制器。欧宝娱乐app下载地址这个方法使用一个冒号分隔符(如。service_name: indexAction),是指控制器作为服务(见<一个href=”//www.oldmanjams.com/doc/2.2/cookbook/controller/service.html" class="reference internal">如何定义控制器作为服务吗)。

    {蛞蝓})尤其重要,因为每个可用作为控制器参数的方法:

    1 2 3 4
    公共函数showAction(美元鼻涕虫){/ /……}

    事实上,整个违约收集合并形成一个单一的参数值数组。每个键的数组作为参数的控制器是可用的。

    换句话说,对于每个参数的控制器方法,Symfony查找线路参数的名称和分配其价值这一观点。欧宝娱乐app下载地址在上面的先进的例子中,任意组合(以任意顺序)下面的变量可以作为参数showAction ()方法:

    • 美元的文化
    • 美元一年
    • 美元的标题
    • _format美元
    • _controller美元

    因为占位符和违约收集合并在一起,甚至_controller美元变量是可用的。更详细的讨论,请参阅<一个href=”//www.oldmanjams.com/doc/2.2/book/controller.html" class="reference internal">控制器。

    提示

    您还可以使用一个特殊的_route美元变量设置为路由的名称匹配。

    应用程序/配置/ routing.yml(见<一个href=”//www.oldmanjams.com/doc/2.2/book/routing.html" class="reference internal">创建路线如上图所示)。通常,然而,你要从其他地方加载路线,像一个路由文件,住在一个包。这可以通过“进口”文件:

    • YAML
    • XML
    • PHP
    1 2 3
    # app / config / routing.ymlacme_hello:资源:“@AcmeHelloBundle /资源/ config / routing.yml”

    请注意

    当从YAML进口资源,(如的关键。acme_hello)是毫无意义的。确保它的独特所以没有其他线路覆盖它。

    的资源关键负荷给定的路由资源。在这个例子中,资源是一个文件的完整路径,其中@AcmeHelloBundle快捷语法解析包的路径。导入的文件可能看起来像这样:

    • YAML
    • XML
    • PHP
    1 2 3 4
    # src / Acme / HelloBundle /资源/ config / routing.ymlacme_hello:路径:/ hello /{名称}默认值:{_controller:AcmeHelloBundle:你好:索引}

    这个文件被解析和加载的路线以同样的方式作为主要的路由文件。

    acme_hello路线的最终路径/管理/ hello /{名称}而不是简单地/ hello /{名称}:

    • YAML
    • XML
    • PHP
    1 2 3 4
    # app / config / routing.ymlacme_hello:资源:“@AcmeHelloBundle /资源/ config / routing.yml”前缀:/管理

    的字符串/管理现在将返回的路径路由从新的路由资源加载。

    提示

    您还可以定义路线使用注释。看到看到FrameworkExtraBundle文档。欧宝体育电话

    2.2

    2.2主机匹配支持添加Symfony欧宝娱乐app下载地址

    你可以设置主机正则表达式对进口路线。有关更多信息,请参见<一个href=”//www.oldmanjams.com/doc/2.2/components/routing/hostname_pattern.html" class="reference internal">如何匹配基于主机的路由。

    路由器:调试控制台命令。执行命令的运行以下项目的根源。

    1
    美元的php应用程序/控制台路由器:调试

    这个命令将打印了一些有用的所有在应用程序中配置的路线:

    1 2 3 4 5 6
    首页/接触GET /接触contact_process POST /接触article_show任何/文章/{文化}/{一}/{标题}。{_format}博客任何/博客/{页面}blog_show /博客/{蛞蝓}

    你也可以在一个非常具体的信息途径,包括路线名称后,命令:

    1
    美元的php应用程序/控制台路由器:调试article_show

    同样地,如果你想要测试一个URL是否匹配给定的路线,你可以使用路由器:匹配控制台命令:

    1
    php应用程序/控制台路由器:美元/博客/最新的文章

    这个命令将打印路线匹配的URL。

    1
    路线“blog_show”比赛

    匹配()和<一个href=”https://github.com/symfony/symfony/blob/2.2/src/Symfony/Component/Routing/Router.php" class="reference external" title="生成()”rel="external noopener noreferrer" target="_blank">生成()方法形成这种双向系统。取blog_show路线从先前的例子:

    1 2 3 4 5 6 7 8
    美元参数个数=美元这- >get (“路由器”)- >匹配(/博客/我的博客帖子的);/ /数组(/ /“鼻涕虫”= >“我的博客帖子”,/ /“_controller”= >“AcmeBlogBundle:博客:显示”,/ /)美元uri=美元这- >get (“路由器”)- >生成(“blog_show”,数组(“鼻涕虫”= >“我的博客帖子”));/ / /博客/我的博客帖子

    生成一个URL,您需要指定路线的名称(如。blog_show)和任何通配符(如。蛞蝓=我的博客帖子)用于路由的路径。根据这些信息,任何URL可以很容易地生成:

    1 2 3 4 5 6 7 8 9 10 11 12
    类MainController扩展控制器{公共函数showAction(美元鼻涕虫){/ /……美元url=美元这- >generateUrl (“blog_show”,数组(“鼻涕虫”= >“我的博客帖子”));}}

    请注意

    在控制器扩展Symfony的基地欧宝娱乐app下载地址<一个href=”https://github.com/symfony/symfony/blob/2.2/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php" class="reference external" title="控制器”rel="external noopener noreferrer" target="_blank">控制器,你可以使用<一个href=”https://github.com/symfony/symfony/blob/2.2/src/Symfony/Bundle/FrameworkBundle/Controller/Controller.php" class="reference external" title="generateUrl ()”rel="external noopener noreferrer" target="_blank">generateUrl ()方法,该方法调用的服务的路由器<一个href=”https://github.com/symfony/symfony/blob/2.2/src/Symfony/Component/Routing/Router.php" class="reference external" title="生成()”rel="external noopener noreferrer" target="_blank">生成()方法。

    在即将到来的一节中,您将了解如何从内部生成的url模板。

    提示

    如果您的应用程序的前端使用Ajax请求,您可能希望能够生成url在JavaScript中根据你的路由配置。通过使用<一个href=”https://github.com/FriendsOfSymfony/FOSJsRoutingBundle" class="reference external" rel="external noopener noreferrer" target="_blank">FOSJsRoutingBundle,你也可以这样做:

    1 2 3 4
    varurl = Routing.generate (“blog_show”,{“鼻涕虫”:“我的博客帖子”});

    有关更多信息,请参见文档包。欧宝体育电话

    /博客)。要生成一个绝对URL,只需通过真正的的第三个参数生成()方法:

    1 2
    美元这- >get (“路由器”)- >生成(“blog_show”,数组(“鼻涕虫”= >“我的博客帖子”),真正的);/ / http://www.example.com/blog/my-blog-post

    请注意

    时使用的主机产生一个绝对URL是当前的主机请求对象。这是检测自动基于PHP提供的服务器信息。当生成绝对url从命令行运行的脚本,您将需要手动设置所需的主机上RequestContext对象:

    1
    美元这- >get (“路由器”)- >getContext ()- >setHost (“www.example.com”);

    生成方法使用通配符的数组值生成URI。但是如果你通过额外的,他们将被添加到URI查询字符串:

    1 2
    美元这- >get (“路由器”)- >生成(“博客”,数组(“页面”= >2,“类别”= >S欧宝娱乐app下载地址ymfony的));/ / /博客/ 2 ?类别= Symf欧宝娱乐app下载地址ony

    • 嫩枝
    • PHP
    1 2 3
    <一个href=”{{路径(blog_show,{“鼻涕虫”:“我的博客帖子”})}}”>读这篇文章。< /一个>

    绝对url也可以生成。

    • 嫩枝
    • PHP
    1 2 3
    <一个href=”{{url (blog_show,{“鼻涕虫”:“我的博客帖子”})}}”>读这篇文章。< /一个>

    如何迫使路线总是使用HTTPS或HTTP吗< /li>

    这项工作,包括代码示例,许可下<一个rel="license" href="https://creativecommons.org/licenses/by-sa/3.0/">Creative Commons冲锋队3.0许可证。
    欧宝娱乐app下载地址Symfony代码性能”>< /一个><p class=欧宝娱乐app下载地址Symfony代码性能< /p>
    代码消耗服务器资源。黑焰告诉你”>< /一个><p class=代码消耗服务器资源。黑焰告诉你< /p>
    被训练SensioLabs专家(2到6天会议——法语或英语)。”>< /一个><p class=被训练SensioLabs专家(2到6天会议——法语或英语)。< /p>