*这一系列文章来源于Fabien Potencier，基于Symfony1.4编写的Jobeet Tutirual。
URLs
如果你在Jobeet的首页中点击任意一条Job信息，你就会发现这些URL看起来会像是这样的：/job/1/show。如果你曾经使用过PHP来进行网站的话，那你可能更加熟悉这样的URL：/job.php?id=1。那么Symfony是怎么样把URL转换成前一种形式的呢？Symfony是如何根据URL来决定调用哪个Controller和Action的呢？为什么showAction($id)中的$id的值就是需要检索出的Job信息的id呢？这些问题我们会在今天的内容中一一解答。我们可以在src/Ibw/JobeetBundle/Resources/views/Job/index.html.twig模板中看到如下代码：
|
1 |
{{ path('ibw_job_show', { 'id': entity.id }) }} |
上面的代码中使用了视图助手函数（template helper function）path()生成带有id值为1的Job URL。ibw_job_show是路由使用的名称（具名路由），我们可以在下面的内容中看到它们的定义。
路由配置
在Symfony2中，路由通常是在app/config/routing.yml文件中进行配置的。文件中导入（import）了指定包（bundle）中的路由配置。在我们的Jobeet项目中，文件src/Ibw/JobeetBundle/Resources/config/routing.yml就被导入其中：
|
1 2 3 4 |
# app/config/routing.yml ibw_jobeet: resource: "@IbwJobeetBundle/Resources/config/routing.yml" prefix: / |
现在，如果我们打开JobeetBundle中的routing.yml文件的话，我们可以看到routing.yml文件中又导入了另外一个路由文件src/Ibw/JobeetBundle/Resources/config/routing/job.yml。在routing.yml中定义了两个路由，一个是URL样式为/hello/{name}的ibw_jobeet_homepage路由，另外一个则是定义给JobController的路由：
|
1 2 3 4 5 6 7 8 |
# src/Ibw/JobeetBundle/Resources/config/routing.yml IbwJobeetBundle_job: resource: "@IbwJobeetBundle/Resources/config/routing/job.yml" prefix: /job ibw_jobeet_homepage: pattern: /hello/{name} defaults: { _controller: IbwJobeetBundle:Default:index } |
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 |
# src/Ibw/JobeetBundle/Resources/config/routing/job.yml ibw_job: pattern: / defaults: { _controller: "IbwJobeetBundle:Job:index" } ibw_job_show: pattern: /{id}/show defaults: { _controller: "IbwJobeetBundle:Job:show" } ibw_job_new: pattern: /new defaults: { _controller: "IbwJobeetBundle:Job:new" } ibw_job_create: pattern: /create defaults: { _controller: "IbwJobeetBundle:Job:create" } requirements: { _method: post } ibw_job_edit: pattern: /{id}/edit defaults: { _controller: "IbwJobeetBundle:Job:edit" } ibw_job_update: pattern: /{id}/update defaults: { _controller: "IbwJobeetBundle:Job:update" } requirements: { _method: post|put } ibw_job_delete: pattern: /{id}/delete defaults: { _controller: "IbwJobeetBundle:Job:delete" } requirements: { _method: post|delete } |
我们来仔细看看上面代码中的ibw_job_show路由。ibw_job_show路由定义的模式可以匹配/*/show的URL，这里的通配符*代表的是id。在URL /1/show中，id变量的值为1，我们可以在控制器中获取并使用id变量的值。_controller是一个特殊的键（key），它告诉Symfony当URL匹配成功的时候系统要调用哪个Controller和Action，在这里的例子中应该调用的是IbwJobeetBundle中的JobController里的showAction()。
路由中的参数（比如{id}）是十分重要的，因为它们可以被action方法作为参数使用。
在开发（development）环境下的路由
在开发环境下加载的路由文件是app/config/routing_dev.yml，这个文件包含了Web Debug Toolbar中需要用到的路由，而且在文件的末尾我们还可以看到_main中的路由是routing.yml。
自定义路由
现在当我们在浏览器中访问 / URL的时候，我们会被重定向到一个404页面，那是因为 / 并没有匹配到任何已定义的路由。ibw_jobeet_homepage路由匹配/hello/jobeet URL，然后调用DefaultController的indexAction()。我们来改变它来匹配/ URL，然后调用JobController的indexAction()。修改的代码如下：
|
1 2 3 4 5 |
# src/Ibw/JobeetBundle/Resources/config/routing.yml # ... ibw_jobeet_homepage: pattern: / defaults: { _controller: IbwJobeetBundle:Job:index } |
现在我们先去清除缓存（cache），然后我们就能在浏览器中通过http://jobeet.local访问Jobee t首页了。现在我们可以把Jobeet布局（layout）中logo的链接改成ibw_jobeet_homepage路由了：
|
1 2 3 4 5 6 |
<!-- src/Ibw/JobeetBundle/Resources/views/layout.html.twig --> <!-- ... --> <h1><a href="{{ path('ibw_jobeet_homepage') }}"> <img alt="Jobeet Job Board" src="{{ asset('bundles/ibwjobeet/images/logo.jpg') }}" /> </a></h1> <!-- ... --> |
为了让用户能够更加快速地访问到需要的Job信息，我们来把Job页面的URL变得更加容易理解一些，就像下面那样：
|
1 |
/job/sensio-labs/paris-france/1/web-developer |
即使用户不知道Jobeet是干什么用的，也从没浏览过这个网站，但用户可以通过这个URL就可以了解到Sensio Labs正在Paris, France寻在一位Web developer。
下面的模式串可以匹配上面的URL：
|
1 |
/job/{company}/{location}/{id}/{position} |
编辑job.yml文件中的ibw_job_show路由：
|
1 2 3 4 5 6 |
# src/Ibw/JobeetBundle/Resources/config/routing/job.yml # ... ibw_job_show: pattern: /{company}/{location}/{id}/{position} defaults: { _controller: "IbwJobeetBundle:Job:show" } |
现在我们需要传参数到路由中让它能够工作：
|
1 2 3 4 5 6 |
<!-- src/Ibw/JobeetBundle/Resources/views/Job/index.html.twig --> <!-- ... --> <a href="{{ path('ibw_job_show', { 'id': entity.id, 'company': entity.company, 'location': entity.location, 'position': entity.position }) }}"> {{ entity.position }} </a> <!-- ... --> |
我们可以看看生成的URL，它们就像我们期望的那样：
|
1 |
http://jobeet.local/app_dev.php/job/Sensio Labs/Paris,France/1/Web Developer |
我们需要把URL中的所有非ASCII列值转化成一个-。打开Job.php文件，在Job实体类中添加下面的方法：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 |
// src/Ibw/JobeetBundle/Entity/Job.php // ... use Ibw\JobeetBundle\Utils\Jobeet as Jobeet; class Job { // ... public function getCompanySlug() { return Jobeet::slugify($this->getCompany()); } public function getPositionSlug() { return Jobeet::slugify($this->getPosition()); } public function getLocationSlug() { return Jobeet::slugify($this->getLocation()); } } |
我们必须把use语句（你可以查看PHP中怎么使用命名空间）放在类定义之前。
然后我们创建src/Ibw/JobeetBundle/Utils/Jobeet.php文件，并添加一个slugify()方法：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
// src/Ibw/JobeetBundle/Utils/Jobeet.php namespace Ibw\JobeetBundle\Utils; class Jobeet { static public function slugify($text) { // replace all non letters or digits by - $text = preg_replace('/\W+/', '-', $text); // trim and lowercase $text = strtolower(trim($text, '-')); return $text; } } |
我们已经定义了三个“虚拟的（virtual）”访问接口：getCompanySlug()，getPositionSlug()和getLocationSlug()，它们使用slugify()方法返回合适的列值。现在我们来替换在之前模板中使用的方法：
|
1 2 3 4 5 6 |
<!-- src/Ibw/JobeetBundle/Resources/views/Job/index.html.twig --> <!-- ... --> <a href="{{ path('ibw_job_show', { 'id': entity.id, 'company': entity.companyslug, 'location': entity.locationslug, 'position': entity.positionslug}) }}"> {{ entity.position }} </a> <!-- ... --> |
路由Requirements
路由系统内建了参数验证功能。在每个路由中，可以使用requirements来定义正则表达式强制规定路由中参数取值：
|
1 2 3 4 5 6 7 8 9 |
# src/Ibw/JobeetBundle/Resources/config/routing/job.yml # ... ibw_job_show: pattern: /{company}/{location}/{id}/{position} defaults: { _controller: "IbwJobeetBundle:Job:show" } requirements: id: \d+ # ... |
上面的requirements强制id的值只能为数字，如果不是数字，那么路由则不能匹配成功。
调试路由
当我们添加一个自定义的路由之后，如果我们能通过可视化的方式来得到更多关于自定义路由的信息，那么这一定会对我们很有帮助的。一个能够查看应用中的所有路由的好办法是使用route:debug命令。在我们的项目下运行下面的命令：
|
1 |
php app/console router:debug |
这个命令会显示出应用中所有的路由配置。当然，我们也可以只显示一个指定的路由信息：
|
1 |
php app/console router:debug ibw_job_show |
最后的感言
今天我们就先讲这些啦！你完全可以从书中学习更多关于Symfony2路由的知识。
原文链接：http://www.intelligentbee.com/blog/2013/08/11/symfony2-jobeet-day-5-the-routing/
One comment