谨慎:你正在浏览的遗产ob娱乐下载symfony 1.倍这个网站的一部分。

第九章——链接和路由系统

语言

链接和网址值得特殊治疗在一个web应用程序框架。这是因为应用程序的唯一入口点(前端控制器)和在模板中使用助手允许一个完整的url的工作方式之间的分离和外表。这被称为路由。小玩意,路由是一个有用的工具,使web应用程序更加用户友好的和安全的。本章将告诉你所有你需要知道的处理url在symfony应用程序:ob娱乐下载

路由系统是什么和它是如何工作的
如何使用链接模板启用路由的助手即将离任的url
如何配置路由规则来改变url的出现呢

你还会发现一些技巧掌握路由性能和添加收尾工作。

URL重写

之前入更深的路由系统,一个需要澄清的问题。在前一节中给出的示例中,没有提到前端控制器(index . php或frontend_dev.php)内部uri。前端控制器,而不是应用程序的元素,决定了环境。所有的链接必须是独立于环境,和前端控制器名称不能出现在内部的uri。

没有脚本名生成的url的例子。这是因为生成的url不包含任何脚本的名字默认在生产环境中。的no_script_name参数的settings.yml文件精确控制前端控制器的出现在生成的url。将其设置为假如清单9 - 5所示,url链接输出的助手将在每一个环节提前端控制器脚本的名字。

清单9 - 5 -显示在url,前端控制器的名字应用程序/前端/ config / settings.yml

刺激:.settings no_script_name:假的

现在,生成的url将是这样的:

http://www.example.com/index.php/articles/finance/2010/activity-breakdown.html

在所有环境中除了生产,no_script_name参数设置为假默认情况下。所以当你浏览您的应用程序在开发环境中,例如,前端控制器的名字总是出现在url。

http://www.example.com/frontend_dev.php/articles/finance/2010/activity-breakdown.html

在生产中,no_script_name被设置为真正的,所以只显示url路由信息和更友好。没有出现技术信息。

http://www.example.com/articles/finance/2010/activity-breakdown.html

但应用程序如何知道前端控制器脚本调用哪一个?这就是URL重写。web服务器可以配置为给定的脚本调用时没有在URL中。

在Apache中,这是可能的,一旦你有了mod_rewrite扩展激活。每一个symob娱乐下载fony项目有一个. htaccess文件,它增加了mod_rewrite设置您的服务器配置web /目录中。这个文件的默认内容见清单因。

Apache清单因违约重写规则,myproject / web / . htaccess

< IfModule mod_rewrite。c > RewriteEngine #取消注释以下行,如果你是很难得到no_script_name # # RewriteBase / #我们跳过所有文件,# RewriteCond % {REQUEST_URI} \ . .+ $ # RewriteCond % {REQUEST_URI} ! \。html $ # RewriteRule。* - [L] #我们这里检查html版本(缓存)RewriteRule ^美元指数。html (QSA) RewriteRule ^ ([^] +) $ $ 1。html (QSA) RewriteCond % {REQUEST_FILENAME} ! - f #不,我们重定向到前面web控制器RewriteRule ^(. *)美元指数。php (QSA L) < / IfModule >

web服务器检查接收到的url的形状。如果URL不包含后缀(默认注释掉了),如果没有缓存版本可用的页面(第十二章涵盖了缓存),然后将请求提交index . php。

然而,web /目录的一个symfony项目之ob娱乐下载间共享的所有应用程序和环境项目。这意味着通常有不止一个前端控制器在web目录。例如,一个项目有一个前端和一个后端应用程序,dev和刺激在环境中,包含四个前端控制器脚本web /目录:

index . php// frontend in prod frontend_dev.php // frontend in dev backend.php // backend in prod backend_dev.php // backend in dev

的mod_rewrite设置只能指定一个默认的脚本名称。如果你设置no_script_name来真正的所有的应用程序和环境中,所有url将被解释为要求前端应用程序的刺激环境。这就是为什么你可以只有一个应用程序和一个环境利用URL重写的对于一个给定的项目。

提示

有一种方法可以有多个应用程序,没有脚本名称。创建子目录的web根,前端控制器里面移动。改变的路径ProjectConfiguration相应的文件,并创建. htaccessURL重写配置,您需要为每个应用程序。

链接助手

由于路由系统,您应该使用链接帮手,而不是常规<一>在你的模板标签。不要看这是一个麻烦,而是为契机,保持应用程序清洁且易于维护。此外,链接帮手提供一些非常有用的快捷键,你不想错过。

超链接、按钮和形式

你已经知道link_to ()帮手。它输出一个xhtml链接,预计两个参数:元素,可以点击和内部的URI的资源点。而不是一个超链接,如果你想要一个按钮,使用button_to ()帮手。形式也有辅助管理的价值行动属性。你会了解更多关于形式在下一章。清单9-7显示了一些示例的链接帮手。

清单9-7 -链接帮手<一>,<输入>,<形式>标签

/ /链接在一个字符串< ? php回声link_to(“我的文章”,“= Finance_in_France文章/读?”)? >= > < a href =“/路由/ url / / Finance_in_France”>我的文章< / >/ /对图像超链接< ? php回声link_to(image_tag(“read.gif”),“= Finance_in_France文章/读?”)? >= > < a href =“/路由/ url / / Finance_in_France”> < img src =“遗产/图片/ read.gif”/ > < / >/ /按钮标签< ? php回声button_to(“我的文章”,“= Finance_in_France文章/读?”)? >= > <输入值=“我的文章”类型=“按钮”onclick =“document.location.href = /路由/ url / / Finance_in_France”;“/ >/ /表单标签< ? php回声form_tag(“= Finance_in_France文章/读?”)? >= = > <形式方法“职位”action =“/路由/ url / / Finance_in_France”/ >

链接助手可以接受内部uri以及绝对url(开始http://,跳过路由系统)和锚。注意,在真实的应用程序中,内部uri是建立与动态参数。清单9显示了所有这些案件的例子。

清单9 - url链接助手所接受

/ /内部URI< ? php回声link_to(“我的文章”,“= Finance_in_France文章/读?”)? >= > < a href =“/路由/ url / / Finance_in_France”>我的文章< / >/ /内部URI与动态参数< ? php回声link_to(“我的文章”,“= /读条吗?”。美元的文章- >getTitle())? >/ /内部与锚URI< ? php回声link_to(“我的文章”,/读条?标题= Finance_in_France # foo ')? >= > < a href =“/ / url路由到/ Finance_in_France # foo”>我的文章< / >/ /绝对URL< ? php回声link_to(“我的文章”,“http://www.example.com/foobar.html”)? >= > < a href =“http://www.example.com/foobar.html”>我的文章< / >

假的GET和POST方法

有时web开发人员使用GET请求做一篇。例如,考虑下面的网址:

http://www.example.com/index.php/shopping_cart/add/id/100

这个请求会改变应用程序中包含的数据,通过将一个条目添加到购物车对象,存储在会话或在数据库中。这个URL可以书签、缓存和索引的搜索引擎。想象所有的事情可能发生在数据库或一个网站使用这种技术的指标。事实上,这个请求应该被认为是一篇文章,因为搜索引擎机器人不做索引的POST请求。

ob娱乐下载Symfony提供了一种方法将调用link_to ()或button_to ()助手到一个实际的职位。只是添加一个帖子= true选项,如清单9 - 11所示。

清单9 - 11 -链接调用一个POST请求

< ? php回声link_to(“去购物车”,“shoppingCart /添加? id = 100”,数组(“职位”= >真正的))? >= > < onclick =“f = document.createElement(形式);document.body.appendChild (f);f。方法=“POST”;f。action = this.href;f.submit(),返回false;”href =“/ shoppingCart /添加html / id / 100.”>去购物车< / >

这<一>标签有一个href属性,浏览器不支持JavaScript,如搜索引擎机器人会做的链接默认。所以你也必须限制你的行动作出回应POST方法,通过添加类似以下的动作:

这个美元- >forward404Unless(这个美元- >getRequest()- >isMethod(“职位”));

只要确保你不链接位于表单上使用这个选项,因为它自己生成<形式>标签。

这是一个好习惯标签发布链接,发布数据。

迫使请求参数作为变量

根据你的路由规则,变量作为参数传递link_to ()转换为模式。如果没有匹配的规则的内部URIrouting.yml文件,默认规则转换模块/行动?键=值成/模块/行动/键/值如清单9 - 12所示。

清单9 - 12 -默认路由规则

< ? php回声link_to(“我的文章”,“= Finance_in_France文章/读?”)? >= > < a href =/ /读/标题/ Finance_in_France条”>我的文章< / >

如果你真的需要得到语法,有请求参数传递下?键=值形式——你应该把外面的变量需要迫使URL参数,query_string选择。这将冲突也与锚在URL中,你必须把它进入锚选择而不是将它内部的URI。所有的链接帮助接受这些选项,如清单卖地所示。

与清单卖地,迫使变量query_string选项

< ? php回声link_to(“我的文章”,/读条的,数组(“query_string”= >“标题= Finance_in_France”,“锚”= >“foo”))? >= > < a href =“标题/文章/读? = Finance_in_France # foo”>我的文章< / >

一个URL请求参数出现的变量可以被一个脚本在客户端,和$ _GET和$ _REQUEST变量在服务器端。

侧边栏

资产助手

第7章介绍了资产的帮手image_tag (),stylesheet_tag (),javascript_include_标记(),这允许您将包括一个图像,一个样式表,或者响应的JavaScript文件。这些资产的路径不是由路由系统处理,因为它们链接到资源实际上是位于公共web目录下。

你不需要提及一个资产的文件扩展名。ob娱乐下载Symfony自动添加. png,. js,或. css到一个图像、JavaScript或样式表助手的电话。同时,symob娱乐下载fony会自动寻找这些资产/图片/ web /遗产,web / js /,web / css /目录。当然,如果你想要包含一个特定的文件格式或一个文件从一个特定的位置,只使用完整的文件名或完整的文件路径作为参数。

修复一个图像的大小,使用大小属性。预计像素的宽度和高度,由一个分隔x。

< ? php回声image_tag(“测试”,“大小= 100 x20”))? >= > < img href =“遗产/图片/ test.png”宽度=“100”身高=“20”/ >

如果你想资产包含的<头>节(JavaScript文件和样式表),你应该使用use_stylesheet ()和use_javascript ()助手在你的模板,而不是_tag ()版本的布局。他们将资产添加到响应,这些资产包括前< / >头标签被发送到浏览器。

使用绝对路径

链接和资产助手默认生成相对路径。强制输出绝对路径,设置绝对选项真正的,见清单9-14。这对于夹杂物技术是有用的链接在电子邮件、RSS提要,或者API的回应。

清单9-14 -绝对url,而不是相对url

< ? php回声url_for(“= Finance_in_France文章/读?”)? >= >' / / url / / Finance_in_France路由的< ? php回声url_for(“= Finance_in_France文章/读?”,真正的)? >= >“http://www.example.com/routed/url/to/Finance_in_France”< ? php回声link_to(“金融”,“= Finance_in_France文章/读?”)? >= > < a href =“/路由/ url / / Finance_in_France”< / > >金融< ? php回声link_to(“金融”,“= Finance_in_France文章/读?”,“绝对= true”)? >= > < a href =“http://www.example.com/routed/url/to/Finance_in_France”< / > >金融/ /资产也是一样的帮手< ? php回声image_tag(“测试”,“绝对= true”)? >< ? php回声javascript_include_tag(“myscript”,“绝对= true”)? >

侧边栏

邮件助手

如今,e-mail-harvesting机器人绕行网络,和你不能显示电子邮件地址在网站上没有几天内成为垃圾邮件受害者。这就是为什么symfonob娱乐下载y提供了mail_to ()帮手。

的mail_to ()助手接受两个参数:实际的电子邮件地址和应该显示的字符串。附加选项接受编码参数在HTML输出非常不可读,理解的浏览器而不是由机器人。

< ? php回声mail_to(“myaddress@mydomain.com”,“接触”)? >= > < a href =“mailto: myaddress@mydomain.com联系> < / > < ?php echo mail_to (“myaddress@mydomain.com”、“接触”,“编码= true”) ? > = > < a href = "&#109;a... om">ct... ess

编码的电子邮件是由随机十进制和十六进制字符转换的实体编码器。这个技巧停止大部分的address-harvesting垃圾邮件,但请注意,收获技术发展迅速。

路由配置

路由系统做两件事:

它解释外部传入的请求的URL转换成内部URI,确定模块/行动和请求参数。
它内部uri格式用于链接到外部url(如果你使用助手的联系)。

转换是基于一组路由规则。这些规则存储在一个routing.yml配置文件位于应用程序配置/目录中。清单15显示了默认的路由规则,与每一个symfony项目捆绑在一起。ob娱乐下载

清单9 - 15 -默认的路由规则,前端/ config / routing.yml

#默认规则主页:url: /参数:{模块:默认情况下,行动:指数}#通用规则#请删除它们通过添加更具体的规则default_index: url: /:模块参数:{行动:指数}默认值:url: /: / *模块/动作

规则和模式

路由规则是双射的外部URL和内部之间的关联的URI。一个典型的由以下规则:

一个独特的标签,易读性和速度,可以通过链接的帮手
匹配模式(url键)
请求参数值(数组参数键)

模式可以包含通配符(由星号表示,*)和命名的通配符(从一个冒号开始,:)。一个名叫通配符匹配成为一个请求参数的值。例如,默认的清单15中定义的规则将匹配任何URL/ foo / bar,并设置模块参数喷火和行动参数酒吧。

请注意

名叫通配符可以被削减或分离点,所以你可以写一个模式:

my_rule: url: / foo /:酒吧。:format param: { module: mymodule, action: myaction }

这样,外部URL像‘foo / 12。xml将匹配my_rule和执行mymodule里/ myaction有两个参数:酒吧= 12美元和$ format = xml。您可以添加更多的分隔符通过改变segment_separators中的参数值sfPatternRouting工厂配置(见19章)。

路由系统解析routing.yml文件从上到下,停在第一场比赛。这就是为什么你必须添加自己的规则的默认的。例如,URL/ foo / 123比赛的规则定义在清单9到16,但symfony第一次测试ob娱乐下载my_rule:,该规则匹配,它甚至没有测试默认值:一个。请求的处理mymodule里/ myaction行动与酒吧设置为123年(而不是的foo / 123行动)。

清单9到16 -规则解析从上到下

my_rule: url: / foo /:酒吧参数:{模块:mymodule里,行动:myaction} #默认规则默认值:url: /: / *模块/动作

请注意

当创建一个新的行动,它并不意味着您必须创建一个路由规则。如果默认模块/行动模式适合你,然后忘记routing.yml文件。然而,如果你想自定义操作的外部URL,添加一个新规则高于默认的一个。

清单上行线显示的过程改变外部URL格式/读一篇文章行动。

清单上行线-改变的外部URL格式/读条行动

< ? php回声url_for(的文章/读? id = 123)? >= > /文章/读/ id /123年/ /默认格式/ /改变/文章/ 123,添加一个新规则/ /你的routing.ymlarticle_by_id: url: / /条id参数:{模块:文章中,行动:阅读}

问题是article_by_id清单上行线打破规则的默认路由的所有其他操作文章模块。事实上,一个URL文章/删除这将匹配规则而不是吗默认的并调用读行动与id设置为删除而不是删除行动。为了解决这个困难,您必须添加一个约束,这样的模式article_by_id规则匹配只有url的地方id通配符是一个整数。

模式的约束

当一个URL可以匹配一个以上的规则,你必须细化规则通过添加约束,或需求的模式。要求必须是一组正则表达式匹配规则的通配符来匹配。

例如,修改article_by_id规则,这样它只匹配的urlid参数是一个整数,规则添加一行,如清单9到18所示。

清单9到18 -添加路由规则要求

article_by_id: url: / /条id参数:{模块:文章中,行动:阅读}要求:{id: \ d +}

现在一个文章/删除URL不能匹配article_by_id规则了,因为“删除”字符串不满足要求。因此,路由系统将继续寻找一个匹配在以下规则,最后找到了默认的规则。

侧边栏

永久链接

一个好的安全路由指南是隐藏主键,代之以尽可能多的重要的字符串。如果您想给访问文章的标题,而不是从他们的ID吗?它将使外部url看起来像这样:

http://www.example.com/article/Finance_in_France

程度上,您需要创建一个新的永久链接行动,我们将使用一个鼻涕虫参数不是一个id1,添加一个新规则:

article_by_id: url: / /条id参数:{模块:文章中,行动:阅读}要求:{id: \ d +} article_by_slug: url: / /条蛞蝓参数:{模块:文章中,行动:永久链接}

的永久链接行动需要确定请求的文章的标题,所以您的模型必须提供一个适当的方法。

公共函数executePermalink(美元的请求){美元的文章= ArticlePeer::retrieveBySlug(美元的请求- >getParameter(“鼻涕虫”);这个美元- >forward404Unless(美元的文章);/ /显示404如果没有匹配的文章蛞蝓这个美元- >文章=美元的文章;/ /将对象传递给模板}

你还需要更换链接读行动与链接在你的模板永久链接使内部uri的正确格式。

/ /替换< ? php回声link_to(“我的文章”,“文章/读? id =”。美元的文章- >getId())? >/ /< ? php回声link_to(“我的文章”,的文章/永久链接?蛞蝓= '。美元的文章- >getSlug())? >

多亏了需求线,外部URL/文章/ Finance_in_France匹配article_by_slug规则,即使article_by_id规则先出现。

注意,文章将被检索的蛞蝓,你应该添加一个索引鼻涕虫列文章优化数据库性能的模型描述。

设置默认值

你可以给叫通配符默认值规则工作,即使没有定义的参数。设置的默认值参数:数组中。

例如,article_by_id如果不匹配规则id参数没有设置。你可以强迫它,如清单9-19所示。

清单9-19 -设置一个默认值为一个通配符

article_by_id: url: / /条id参数:{模块:文章中,行动:阅读,id: 1}

默认的参数不需要通配符的模式。在清单9-20中,显示参数的值真正的,即使它不是出现在URL。

清单9-20 -设置请求参数的默认值

article_by_id: url: / /条id参数:{模块:文章中,行动:阅读,id: 1,显示:真正的}

如果你仔细观察,你可以看到文章和读也是默认值吗模块和行动变量中没有模式。

提示

您可以定义一个默认参数的所有路由规则通过调用sfRouting: setDefaultParameter ()方法。例如,如果您希望所有的规则主题参数设置为默认的默认情况下,添加$ this - >内容- > getRouting () - > setDefaultParameter(“主题”、“违约”);你的一个全球过滤器。

加快路由使用规则名称

助手的联系接受规则标签而不是模块/行动对之前如果规则标签是一个“在”符号(@),如清单9所示。

清单9 -使用规则标签而不是模块/行动

< ? php回声link_to(“我的文章”,“文章/读? id =”。美元的文章- >getId())? >/ /也可以写成< ? php回声link_to(“我的文章”,“@article_by_id id = ?”。美元的文章- >getId())? >/ /或最快的一个(不需要额外的解析):< ? php回声link_to(“我的文章”,“article_by_id”,数组(“id”= >美元的文章- >getId()))? >

这个技巧有优点和缺点。优点如下:

内部uri的格式完成得更快,因为symfony不必浏览所有规则来查找匹配的一个链接。ob娱乐下载在大量发送超链接的页面,将明显提高如果你使用规则/行动对标签而不是模块。
使用规则标签有助于抽象一个行动背后的逻辑。如果你决定改变一个动作的名字但保持URL,一个简单的改变routing.yml文件就足够了。所有的link_to ()电话仍然没有进一步的变化。
更明显的逻辑调用规则名称。即使你的模块和行为有明确的名字,最好是电话@display_article_by_slug比文章/显示。
你知道哪些行为是通过阅读路由。yml文件

另一方面,缺点是添加新链接变得更少的不证自明的,因为你总是需要参考routing.yml文件来找出哪些标签是用于一个动作。在一个大项目,你最终一定会得到很多路由规则,有点难以维护。在这种情况下,您应该在几个插件应用程序包,每一个定义一组有限的功能。

然而,经验表明使用路由规则从长远来看是最好的选择。

提示

(在你的测试dev环境),如果你想检查的规则匹配给定请求在浏览器中,开发网络的“日志”部分调试工具栏和寻找一行指定“匹配路线XXX”。你会发现更多的信息在16章web调试模式。

创建规则没有`routing.yml`

大部分的配置文件是真实的,routing.yml是一个解决方案定义路由规则,但不是唯一的一个。您可以在PHP定义规则,但在调用之前调度(),因为这个方法决定了行动,根据目前的路由规则执行。在PHP中定义规则授权您创建动态规则,根据配置或其他参数。

处理路由规则的对象是sfPatternRouting工厂。它可以从每个代码要求的一部分sfContext: getInstance () - > getRouting ()。它的prependRoute ()方法添加一个新规则中定义的现有的routing.yml。预计两个参数:一个名称和一个路线sfRoute对象。例如,routing.yml规则定义清单9到18所示相当于PHP代码清单9-22所示。

清单9-22 -定义一个规则在PHP

sfContext::getInstance()- >getRouting()- >prependRoute(“article_by_id”,/ /路线名称新sfRoute(' / /条id”,数组(“模块”= >“文章”,“行动”= >“读”),数组(“id”= >”\ d+ ')),/ /路由对象);

的sfRoute类构造函数接受三个参数:一个模式,一个关联数组的默认值,和另一个关联数组要求。

的sfPatternRouting手工类有其他有用的方法来处理路线:clearRoutes (),hasRoutes ()等等。指的是< a href ="http://www.symfony-project.org/api/1_4/">API文欧宝官网下载app档要学习更多的知识。

提示

一旦你开始完全理解这本书中提出的概念,你可以增加你的理解框架通过浏览网上的API文档,或者更好的是,symfony的来源。欧宝官网下载appob娱乐下载不是所有的symfony的调整和参数可以在这本书中进行描述。ob娱乐下载然而,在线文档是无限的欧宝官网下载app。

请注意

路由类是可配置的factories.yml配置文件(改变缺省路由类,见第17章)。本章谈到了sfPatternRouting类,它是配置默认路由类。

处理在行动路线

如果您需要检索有关当前路线的信息——例如,准备未来的“xxx回到页面”链接,您应该使用的方法sfPatternRouting对象。返回的urigetCurrentInternalUri ()可用于调用一个方法link_to ()助手,见清单合唱。

清单合唱——使用sfRouting当前的路由信息

/ /如果您需要一个URLhttp:/ /myapp.example.com/article/21美元的路由=这个美元- >getContext()- >getRouting();/ / /读条使用下面的行动美元的uri=美元的路由- >getCurrentInternalUri();= = >文章/读? id21美元的uri=美元的路由- >getCurrentInternalUri(真正的);= = > @article_by_id ? id21美元的统治=美元的路由- >getCurrentRouteName();= > article_by_id/ /如果你只需要当前模块/行动的名字,/ /记住他们是实际的请求参数美元的模块=美元的请求- >getParameter(“模块”);美元的行动=美元的请求- >getParameter(“行动”);

如果您需要将内部URI转换为外部URL——就像在一个行动url_for ()在一个模板,使用吗genUrl ()sfController对象的方法,见清单9-24。

清单9-24——使用sfController将一个内部的URI

美元的uri=的文章/读? id = 21;$ url=这个美元- >getController()- >genUrl(美元的uri);= > / /条21$ url=这个美元- >getController()- >genUrl(美元的uri,真正的);= > http:/ /myapp.example.com/article/21

总结

路由是一种双向机制旨在允许外部url的格式以便他们更友好。URL重写需要允许前端控制器名称的遗漏的一个应用程序的URL的每个项目。必须使用链接助手每次你需要在模板如果你想输出一个URL路由系统两方面工作。的routing.yml文件配置路由系统的规则和使用时的优先顺序和规则的要求。的settings.yml文件包含附加的设置有关的前端控制器名称和可能的外部url后缀。

这项工作是GFDL许可执照。

第九章——链接和路由系统

路由是什么?

url作为服务器指令

url作为接口的一部分

它是如何工作的

URL重写

链接助手

超链接、按钮和形式

链接帮助选项

假的GET和POST方法

迫使请求参数作为变量

使用绝对路径

路由配置

规则和模式

模式的约束

设置默认值

加快路由使用规则名称

创建规则没有`routing.yml`

处理在行动路线

总结

0b足球

学习Symfob娱乐下载ony

截屏

欧宝体育平台怎么样

博客

服务

部署在