《PHP实战：Symfony2学习笔记之系统路由详解》要点：
本文介绍了PHP实战：Symfony2学习笔记之系统路由详解，希望对您有用。如果有疑问，可以联系我们。
PHP实战本文详细讲述了Symfony2的系统路由.分享给大家供大家参考,具体如下：
PHP实战漂亮的URL绝对是一个严肃的web应用程序必须做到的,这种方式使index.php?article_id=57这类的丑陋URL被暗藏,由更受欢迎的像 /read/intro-to-symfony 来替代.
PHP实战拥有灵活性更为重要,如果你要改变一个页面的URL,比如从/blog 到 /new 怎么办?
PHP实战有多少链接需要你找出来并更新呢? 如果你使用Symfony的router,这种改变将变得很简单.
PHP实战Symfony2 router让你定义更具创造力的URL,你可以map你的应用程序的不同区域.
PHP实战创建复杂的路由并map到controllers并可以在模板和controllers内部生成URLs
PHP实战从bundles(或者其他任何地方)加载路由资源
PHP实战调试你的路由
PHP实战路由活动
PHP实战一个路径是一个从URL 模式到一个controller的绑定.
PHP实战比如假设你想匹配任何像 /blog/my-post 或者 /blog/all-about-symfony的路径并把它们发送到一个controller在那里可以查找并渲染blog实体.
PHP实战该路径很简单：
PHP实战YAML格式：
PHP实战
# app/config/routing.yml
blog_show:
pattern: /blog/{slug}
defaults: {_controller: AcmeBlogBundle:Blog:show }
PHP实战XML格式：
PHP实战
<!-- 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" pattern="/blog/{slug}">
<default key="_controller">AcmeBlogBundle:Blog:show</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
// app/config/routing.php
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('blog_show', new Route('/blog/{slug}', array(
'_controller' => 'AcmeBlogBundle:Blog:show',
)));
PHP实战blog_show路径定义了一个URL模式,它像/blog/* 这里的通配符被命名为slug.对于URL/blog/my-blog-post,slug变量会得到值 my-blog-post.
_controller参数是一个特定的键,它告诉Symfogy当一个URL匹配这个路径时哪个controller将要被执行.
_controller字符串被称为逻辑名.它的值会依照特定的模式来指定具体的PHP类和方法.
PHP实战
// src/Acme/BlogBundle/Controller/BlogController.php
namespace Acme\BlogBundle\Controller;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
class BlogController extends Controller
{
public function showAction($slug)
{
$blog = // use the $slug variable to query the database
return $this->render('AcmeBlogBundle:Blog:show.html.twig', array(
'blog' => $blog,
));
}
}
PHP实战现在当你再拜访/blog/my-post 时,showAction controller将被执行并且$slug变量的值为my-post
PHP实战Symfogy2 的路由器目标：映射一个哀求的URL到controller.
PHP实战路由：内部的秘密
PHP实战当一个哀求发送到应用程序时,它包含一个客户端想要获取资源的地址.这个地址叫做URL或者URI.可能是/contact,/blog/read-me或者其它样式.
PHP实战GET /blog/my-blog-post
PHP实战Symfony2 路由系统的目标是解析这些URL并决定哪个controller应该被执行来回复该哀求.
PHP实战整个路由过程可以分为：
PHP实战1.哀求被Symfony2的前端控制器(app.php)处理.
2.Symfony2核心(kernel)要求路由器检查哀求.
3.路由器匹配接收到的URL到一个特定的路径并返回有关信息,包括应该被执行的controller.
4.Symfony2核心执行该controller,该controller最终会返回一个Response对象.
PHP实战路由器层就是一个把接收到的URL转换为要执行的特定controller的工具.
PHP实战创建路由
PHP实战Symfony会从一个单独的路由配置文件中加载你应用程序的所有路由.该文件通常为 app/config/routing.yml. 它可以被配置成包括XML或者PHP文件等文件.
PHP实战YAML格式：
PHP实战
# app/config/config.yml
framework:
# ...
router: { resource: "%kernel.root_dir%/config/routing.yml" }
PHP实战XML格式：
PHP实战
<!-- app/config/config.xml -->
<framework:config ...>
<!-- ... -->
<framework:router resource="%kernel.root_dir%/config/routing.xml" />
</framework:config>
PHP实战PHP代码格式：
PHP实战
// app/config/config.php
$container->loadFromExtension('framework', array(
// ...
'router' => array('resource' => '%kernel.root_dir%/config/routing.php'),
));
PHP实战基础路由配置
PHP实战定义一个路由很简单,通常一个应用程序拥有很多路由.一个基础路由是由两部分组成：pattern部分和defaults数组部分.
比如：
PHP实战YAML格式：
PHP实战
_welcome:
pattern: /
defaults: { _controller: AcmeDemoBundle:Main:homepage }
PHP实战XML格式：
PHP实战
<?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" pattern="/">
<default key="_controller">AcmeDemoBundle:Main:homepage</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('_welcome', new Route('/', array(
'_controller' => 'AcmeDemoBundle:Main:homepage',
)));
return $collection;
PHP实战该路由匹配首页(/)并映射到AcmeDemoBundle:Main:homepage controller._controller字符串被Symfony2翻译成一个相应的PHP函数并被执行.
PHP实战带占位符路由
PHP实战当然,路由系统支持更多有趣的路由.许多路由会包含一个或者多个被命名的通配符占位符.
PHP实战YAML格式：
PHP实战
blog_show:
pattern: /blog/{slug}
defaults: { _controller: AcmeBlogBundle:Blog:show }
PHP实战XML格式：
PHP实战
<?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" pattern="/blog/{slug}">
<default key="_controller">AcmeBlogBundle:Blog:show</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('blog_show', new Route('/blog/{slug}', array(
'_controller' => 'AcmeBlogBundle:Blog:show',
)));
return $collection;
PHP实战该模式将匹配任何类似/blog/*形式的URL.匹配占位符{slug}的值将会在controller中被使用.换句话说,如果URL是/blog/hello-world,则$slug变量值是hello-world, 该值将能在controller中被使用.该模式不会匹配像/blog, 因为默认情况下所有的占位符都是必须的. 当然可以通过在defaults数组中给这些占位符赋来改变它.
PHP实战必需和可选占位符
PHP实战我们来添加一个新的路由,显示所有可用的blog列表.
PHP实战YAML格式：
PHP实战
blog:
pattern: /blog
defaults: { _controller: AcmeBlogBundle:Blog:index }
PHP实战XML格式：
PHP实战
<?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" pattern="/blog">
<default key="_controller">AcmeBlogBundle:Blog:index</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('blog', new Route('/blog', array(
'_controller' => 'AcmeBlogBundle:Blog:index',
)));
return $collection;
PHP实战到目前为止,我们的路由都是非常简单的路由模式.它们包含的非占位符将会被精确匹配.
PHP实战如果你想该路由能够支持分页,比如让/blog/2 显示第二页的blog,那就需要为之前的路由添加一个新的{page}占位符.
PHP实战YAML格式：
PHP实战
blog:
pattern: /blog/{page}
defaults: { _controller: AcmeBlogBundle:Blog:index }
PHP实战XML格式：
PHP实战
<?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" pattern="/blog/{page}">
<default key="_controller">AcmeBlogBundle:Blog:index</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('blog', new Route('/blog/{page}', array(
'_controller' => 'AcmeBlogBundle:Blog:index',
)));
return $collection;
PHP实战跟之前的{slug}占位符一样{page}占位符将会在你的controller内部可用,它的值可以用于表示要显示的blog值的页码.但是要清楚,因为占位符默认情况下都是必需的,该路由也将不再匹配之前的/blog URL,这时候你如果还像看第一页的话,就必须通过/blog/1 URL来拜访了.要解决该问题,可以在该路由的defaults数组中指定{page}的默认值.
PHP实战YAML格式：
PHP实战
blog:
pattern: /blog/{page}
defaults: { _controller: AcmeBlogBundle:Blog:index, page: 1 }
PHP实战XML格式：
PHP实战
<?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" pattern="/blog/{page}">
<default key="_controller">AcmeBlogBundle:Blog:index</default>
<default key="page">1</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('blog', new Route('/blog/{page}', array(
'_controller' => 'AcmeBlogBundle:Blog:index',
'page' => 1,
)));
return $collection;
PHP实战通过添加page到defaults键, {page}占位符就不再是必需的.这时候 /blog将会被匹配并且page参数被设置为1,URL /blog/2 也会被匹配.
PHP实战添加要求约束
PHP实战看看下面这些路由：
PHP实战YAML格式：
PHP实战
blog:
pattern: /blog/{page}
defaults: { _controller: AcmeBlogBundle:Blog:index, page: 1 }
blog_show:
pattern: /blog/{slug}
defaults: { _controller: AcmeBlogBundle:Blog:show }
PHP实战XML格式：
PHP实战
<?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" pattern="/blog/{page}">
<default key="_controller">AcmeBlogBundle:Blog:index</default>
<default key="page">1</default>
</route>
<route id="blog_show" pattern="/blog/{slug}">
<default key="_controller">AcmeBlogBundle:Blog:show</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('blog', new Route('/blog/{page}', array(
'_controller' => 'AcmeBlogBundle:Blog:index',
'page' => 1,
)));
$collection->add('blog_show', new Route('/blog/{show}', array(
'_controller' => 'AcmeBlogBundle:Blog:show',
)));
return $collection;
PHP实战你发现问题了吗?注意这两个路由都能匹配像/blog/* 类型的URL.Symfony只会选择第一个与之匹配的路由.
PHP实战换句话说,blog_show将永远不会被像/blog/* 类型的URL匹配.而像 /blog/my-blog-post这样的URL也会被blog路由匹配,并且page变量会获得my-blog-post这样的值.
PHP实战这肯定不可以,那么怎么办呢?答案是给路由添加约束要求requirements.
PHP实战在blog路由中占位符{page}理想状态下只匹配整数值.幸运的是正则表达可以很容易的满足这一要求.
PHP实战YAML格式：
PHP实战
blog:
pattern: /blog/{page}
defaults: { _controller: AcmeBlogBundle:Blog:index, page: 1 }
requirements:
page: \d+
PHP实战XML格式：
PHP实战
<?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" pattern="/blog/{page}">
<default key="_controller">AcmeBlogBundle:Blog:index</default>
<default key="page">1</default>
<requirement key="page">\d+</requirement>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('blog', new Route('/blog/{page}', array(
'_controller' => 'AcmeBlogBundle:Blog:index',
'page' => 1,
), array(
'page' => '\d+',
)));
return $collection;
PHP实战这里 \d+ 约束是一个正则表达式,它指定了{page}只接受整数.这样像/blog/my-blog-post就不再被匹配了.这时候,它才会被blog_show路由匹配.因为参数的约束都是正则表达式,所以其复杂程度和灵活性都有你来决定了.
假设home页使用两种语言则可以这样配置路由：
PHP实战YAML格式：
PHP实战
homepage:
pattern: /{culture}
defaults: { _controller: AcmeDemoBundle:Main:homepage, culture: en }
requirements:
culture: en|fr
PHP实战XML格式：
PHP实战
<?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="homepage" pattern="/{culture}">
<default key="_controller">AcmeDemoBundle:Main:homepage</default>
<default key="culture">en</default>
<requirement key="culture">en|fr</requirement>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('homepage', new Route('/{culture}', array(
'_controller' => 'AcmeDemoBundle:Main:homepage',
'culture' => 'en',
), array(
'culture' => 'en|fr',
)));
return $collection;
PHP实战添加HTTP 办法约束
PHP实战除了URL,你还可以匹配哀求的方法(GET,HEAD,POST,PUT,DELETE等).假设你有一个联系表单有两个controller,一个用于显示表单(使用GET哀求)一个用于处理提交的表单(POST哀求).它的配置如下：
PHP实战YAML格式：
PHP实战
contact:
pattern: /contact
defaults: { _controller: AcmeDemoBundle:Main:contact }
requirements:
_method: GET
contact_process:
pattern: /contact
defaults: { _controller: AcmeDemoBundle:Main:contactProcess }
requirements:
_method: POST
PHP实战XML格式：
PHP实战
<?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="contact" pattern="/contact">
<default key="_controller">AcmeDemoBundle:Main:contact</default>
<requirement key="_method">GET</requirement>
</route>
<route id="contact_process" pattern="/contact">
<default key="_controller">AcmeDemoBundle:Main:contactProcess</default>
<requirement key="_method">POST</requirement>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('contact', new Route('/contact', array(
'_controller' => 'AcmeDemoBundle:Main:contact',
), array(
'_method' => 'GET',
)));
$collection->add('contact_process', new Route('/contact', array(
'_controller' => 'AcmeDemoBundle:Main:contactProcess',
), array(
'_method' => 'POST',
)));
return $collection;
PHP实战尽管这两个路由拥有同一个URL模式定义(/contact),但是第一个路由只会匹配GET哀求,而第二个只会匹配POST哀求.这就意味着你可以通过同一个URL来显示表单并提交表单,而用不同的controller对他们进行处理.如果没有指定_method约束,那么该路由会匹配所有哀求方法.跟其它约束一样,_method约束也接受正则表达式,如果只想匹配GET或者POST那么你可以用GET|POST
PHP实战高级路由例子：
PHP实战Symfony2中具备一切让你创建任何形式路由的条件.
PHP实战YAML格式：
PHP实战
article_show:
pattern: /articles/{culture}/{year}/{title}.{_format}
defaults: { _controller: AcmeDemoBundle:Article:show, _format: html }
requirements:
culture: en|fr
_format: html|rss
year: \d+
PHP实战XML格式：
PHP实战
<?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" pattern="/articles/{culture}/{year}/{title}.{_format}">
<default key="_controller">AcmeDemoBundle:Article:show</default>
<default key="_format">html</default>
<requirement key="culture">en|fr</requirement>
<requirement key="_format">html|rss</requirement>
<requirement key="year">\d+</requirement>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('homepage', new Route('/articles/{culture}/{year}/{title}.{_format}', array(
'_controller' => 'AcmeDemoBundle:Article:show',
'_format' => 'html',
), array(
'culture' => 'en|fr',
'_format' => 'html|rss',
'year' => '\d+',
)));
return $collection;
PHP实战上面的路由,在匹配时只会匹配{culture}部分值为en或者fr并且{year}的值为数字的URL.该路由还告诉我们,可以用在占位符之间使用区间代替斜线.
PHP实战它能够匹配如下URL：
PHP实战/articles/en/2010/my-post
/articles/fr/2010/my-post.rss
PHP实战这其中有个特殊的路由参数 _format,在使用该参数时,其值变为哀求格式.这种哀求格式相当于Respose对象的Content-Type,比如json哀求格式会翻译成一个Content-Type为application/json.该参数可以用于在controller中为每个_format渲染一个不同的模板.它是一个很强的方式来渲染同一个内容到不同的格式.
PHP实战特殊的路由参数：
PHP实战正如你所看到的,每一个路由参数或者默认值最终都是作为一个controller办法输入参数被使用.另外,有三个参数比较特别,它们每一个都在你的应用程序中增加一个唯一功能.
PHP实战_controller: 这个参数决定了当路由匹配时,哪个controller被执行.
_format: 用于设置哀求格式.
_locale: 用于在session上设置本地化.
PHP实战Controller的命名模式：
PHP实战每一个路由必须有一个_controller参数,它决定了当路由匹配时哪个controller应该被执行.该参数使用单一的字符串模式,被称为logical controller name.
PHP实战通过它Symfony可以映射到一个特定的PHP办法和类.该模式有三部分,每一部分用冒号分割开：
PHP实战
bundle:controller:action
PHP实战比如_controller 的值为 AcmeBlogBundle:Blog:show 意思是AcmeBlogBundle bundle中BlogController类里面的showAction办法.
PHP实战
// src/Acme/BlogBundle/Controller/BlogController.php
namespace Acme\BlogBundle\Controller;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
class BlogController extends Controller
{
public function showAction($slug)
{
// ...
}
}
PHP实战Symfony会自动把它们的添加相应的后缀,Blog=>BlogController, show => showAction.
PHP实战你也可以使用它的完全限定名和办法来给_controller赋值,Acme\BlogBundle\Controller\BlogController::showAction 但一般为了简洁灵活而是用逻辑名称.另外除了上面两种形式外,Symfony还支持第三种方式只有一个冒号分割符,如service_name:indexAction来为_controller赋一个作为服务使用的controller.
PHP实战路由参数和控制器参数
PHP实战路由参数非常重要,因为每一个路由参数都会转变成一个控制器参数被在办法中使用.
PHP实战
public function showAction($slug)
{
// ...
}
PHP实战事实上,全部的defaults集合和表单的参数值合并到一个单独的数组中.这个数组中的每个键都会成为controller办法的参数.换句话说,你的controller办法的每一个参数,Symfony都会从路由参数中查找并把找到的值赋给给参数.上面例子中的变量 $culture, $year,$title,$_format,$_controller 都会作为showAction()办法的参数.因为占位符和defaults集合被合并到一起,即使$_controller变量也是一样.你也可以使用一个特殊的变量$_route 来指定路由的名称.
PHP实战包括外部路由资源
PHP实战所有的路由资源的都是通过一个单一的配置文件导入的.通常是app/config/routing.yml.当然你可能想从别处导入路由资源,比如你定义的bundle中的路由资源,你可以这样导入：
PHP实战YAML格式：
PHP实战
# app/config/routing.yml
acme_hello:
resource: "@AcmeHelloBundle/Resources/config/routing.yml"
PHP实战XML格式：
PHP实战
<!-- 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">
<import resource="@AcmeHelloBundle/Resources/config/routing.xml" />
</routes>
PHP实战PHP代码格式：
PHP实战
// app/config/routing.php
use Symfony\Component\Routing\RouteCollection;
$collection = new RouteCollection();
$collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"));
return $collection;
PHP实战在使用YAML导入资源时,键(比如acme_hello)是没有意义的,只是用来保证该资源唯一不被其它行覆盖.使用resources key加载给定的路由资源.在这个示例中资源是一个全路径文件,@AcmeHelloBundle是简写语法,它会被指向bundle路径.被导入的文件内容如下：
PHP实战YAML格式：
PHP实战
# src/Acme/HelloBundle/Resources/config/routing.yml
acme_hello:
pattern: /hello/{name}
defaults: { _controller: AcmeHelloBundle:Hello:index }
PHP实战XML格式：
PHP实战
<!-- src/Acme/HelloBundle/Resources/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="acme_hello" pattern="/hello/{name}">
<default key="_controller">AcmeHelloBundle:Hello:index</default>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
// src/Acme/HelloBundle/Resources/config/routing.php
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('acme_hello', new Route('/hello/{name}', array(
'_controller' => 'AcmeHelloBundle:Hello:index',
)));
return $collection;
PHP实战这个文件中的路由会被解析并跟主要的路由文件内容一起被加载.
PHP实战给导入的路由资源添加前缀
PHP实战你可以为导入的路由资源选择一个前缀,比如说假设你想acme_hello路由有一个这样的 匹配模式：/admin/hello/{name} 而不是直接的 /hello/{name}
PHP实战那么你在导入它的时候可以为其指定prefix.
PHP实战YAML格式：
PHP实战
# app/config/routing.yml
acme_hello:
resource: "@AcmeHelloBundle/Resources/config/routing.yml"
prefix: /admin
PHP实战XML格式：
PHP实战
<!-- 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">
<import resource="@AcmeHelloBundle/Resources/config/routing.xml" prefix="/admin" />
</routes>
PHP实战PHP代码格式：
PHP实战
// app/config/routing.php
use Symfony\Component\Routing\RouteCollection;
$collection = new RouteCollection();
$collection->addCollection($loader->import("@AcmeHelloBundle/Resources/config/routing.php"), '/admin');
return $collection;
PHP实战当该外部路由资源加载的时候字符串 /admin 将被插入到匹配模式的前面.
PHP实战可视化并调试路由
PHP实战当你添加和个性化路由时,能够看到它并能获取一些细节信息将是非常有用的.一个好的查看你应用程序的路由的办法是通过router:debug 命令行工具.
PHP实战在你项目目录下执行如下命令：
PHP实战
$ php app/console router:debug
PHP实战将会输出你应用程序的所有路由.你也可以在该命令后面添加某个路由的名字来获取单个路由信息
PHP实战
$ php app/console router:debug article_show
PHP实战生成URL
PHP实战一个路由系统应该也能用来生成URL.事实上,路由系统是一个双向的系统,映射URL到controller+parameters 和 回对应到 一个URL.可以使用match()和generate()办法来操作.比如：
PHP实战
$params = $router->match('/blog/my-blog-post');
// array('slug' => 'my-blog-post', '_controller' => 'AcmeBlogBundle:Blog:show')
$uri = $router->generate('blog_show', array('slug' => 'my-blog-post'));
// /blog/my-blog-post
PHP实战要生成一个URL,你需要指定路由的名称(比如 blog_show)和任意的通配符(比如：slug=my-blog-post)作为参数.通过这些信息,可以生成任意的URL.
PHP实战
class MainController extends Controller
{
public function showAction($slug)
{
// ...
$url = $this->get('router')->generate('blog_show', array('slug' => 'my-blog-post'));
}
}
PHP实战那么如何从模板内部来生成URL呢?如果你的应用程序前端使用了AJAX哀求,你也许想能够基于你的路由配置在javascript中生成URL,通过使用
PHP实战FOSJsRoutingBundle(https://github.com/FriendsOfSymfony/FOSJsRoutingBundle) 你可以做到：
PHP实战
var url = Routing.generate('blog_show', { "slug": 'my-blog-post'});
PHP实战生成绝对路径的URL
PHP实战默认的情况下,路由器生成相对路径的URL(比如 /blog).要生成一个绝对路径的URL,只需要传入一个true到generate办法作为第三个参数值即可.
PHP实战
$router->generate('blog_show', array('slug' => 'my-blog-post'), true);
// http://www.example.com/blog/my-blog-post
PHP实战当生成一个绝对路径URL时主机是当前哀求对象的主机,这个是基于PHP提供的服务器信息自动决定的.当你需要为运行子命令行的脚本生成一个绝对URL时,你需要在Request对象上手动设置期望的主机头.
PHP实战
$request->headers->set('HOST', 'www.example.com');
PHP实战生成带有查询字符串的URL
PHP实战generate()带有一个数组通配符值来生成URI. 但是如果你传入额外的值,它将被添加到URI作为查询字符串：
PHP实战
$router->generate('blog', array('page' => 2, 'category' => 'Symfony'));
// /blog/2?category=Symfony
PHP实战从模板中生成URL
PHP实战最常用到生成URL的地方是从模板中链接两个页面时,这来需要使用一个模板赞助函数：
PHP实战Twig格式：
PHP实战
<a href="{{ path('blog_show', { 'slug': 'my-blog-post' }) }}">
Read this blog post.
</a>
PHP实战PHP格式：
PHP实战
<a href="<?php echo $view['router']->generate('blog_show', array('slug' => 'my-blog-post')) ?>">
Read this blog post.
</a>
PHP实战也可以生成绝对路径：
PHP实战Twig格式：
PHP实战
<a href="{{ url('blog_show', { 'slug': 'my-blog-post' }) }}">
Read this blog post.
</a>
PHP实战PHP格式：
PHP实战
<a href="<?php echo $view['router']->generate('blog_show', array('slug' => 'my-blog-post'), true) ?>">
Read this blog post.
</a>
PHP实战强制路由使用HTTPS或者HTTP
PHP实战有时候为了平安起见,你需要你的站点必须使用HTTPS协议访问.这时候路由组件可以通过_scheme 约束来强迫URI方案.比如：
PHP实战YAML格式：
PHP实战
secure:
pattern: /secure
defaults: { _controller: AcmeDemoBundle:Main:secure }
requirements:
_scheme: https
PHP实战XML格式：
PHP实战
<?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="secure" pattern="/secure">
<default key="_controller">AcmeDemoBundle:Main:secure</default>
<requirement key="_scheme">https</requirement>
</route>
</routes>
PHP实战PHP代码格式：
PHP实战
use Symfony\Component\Routing\RouteCollection;
use Symfony\Component\Routing\Route;
$collection = new RouteCollection();
$collection->add('secure', new Route('/secure', array(
'_controller' => 'AcmeDemoBundle:Main:secure',
), array(
'_scheme' => 'https',
)));
return $collection;
PHP实战上面的路由定义就是强迫secure路由使用HTTPS协议拜访.
PHP实战反之,当生成secure 的URL的时候,路由系统会根据当前的拜访协议方案生成相应的拜访协议.比如当前是HTTP,则会自动生成HTTPS拜访；如果是HTTPS拜访,那么就也会相应的生成HTTPS拜访.
PHP实战
# 如果方案是 HTTPS
{{ path('secure') }}
# 生成 /secure
# 如果方案是 HTTP
{{ path('secure') }}
# 生成 https://example.com/secure
PHP实战当然你也可以通过设置_scheme为HTTP,来强制使用HTTP拜访协议.除了上面说的强迫使用HTTPS协议拜访的设置方法外,还有一种用于站点区域设置
PHP实战使用requires_channel 比如你想让你站点中/admin 下面的所有路由都必须使用HTTPS协议访问,或者你的平安路由定义在第三方bundle时使用.
PHP实战总结：
PHP实战路由系统是一个为将接收的哀求URL映射到被调用来处理该哀求的controller函数的系统.它既能够让你生成漂亮的URL同时又能保持你的应用程序功能跟这些URL解耦.路由系统是双向机制的,也就是说它们也可以用来生成URL.
PHP实战希望本文所述对大家基于Symfony框架的PHP程序设计有所赞助.
维易PHP培训学院每天发布《PHP实战：Symfony2学习笔记之系统路由详解》等实战技能，PHP、MYSQL、LINUX、APP、JS,CSS全面培养人才。
转载请注明本页网址：
http://www.vephp.com/jiaocheng/7333.html
