第七章——在视图层

视图负责渲染输出关联到一个特定的行动。在syob娱乐下载mfony中,视图由几个部分组成,每个部分设计成可轻易修改通常使用它的人。

• 网页设计师通常工作模板(表示动作电流的数据)和布局(包含常见的所有页面)的代码。这些都写在HTML和PHP的小型嵌入式块,这主要是调用帮手。李< / ><李>可重用性,开发人员通常包模板代码片段泛音或组件。他们使用槽影响超过一个区域的布局。网页设计师可以工作在这些模板片段。李< / ><李>开发人员关注YAML视图配置文件(设置响应的属性和其他界面元素)并在响应对象。当处理变量的模板,跨站点脚本不能忽视的风险,和一个好的理解所需的输出逃逸技术安全记录用户数据。李< / >

但无论你的角色是什么,你会发现有用的工具来加速的枯燥工作行动的结果。本章涵盖了所有这些工具。

模板

清单7 - 1显示了一个典型的symfony模板。ob娱乐下载它包含一些HTML代码和一些基本的PHP代码,通常在行动(通过调用定义的变量$ this - > =“foo”名称;)和帮手。

清单7 - 1 - indexSuccess样本。php模板

<标题> < / h1 > < p >欢迎欢迎回来,< ? php回声美元的名字? >! < / p > < h2 >你想做李? < / h2 > < ul > < > < ? php回声link_to(“阅读过去的文章”,/读条的)李李? > < / > < > < ? php回声link_to(“开始编写一个新的”,文章/写的)李? > < / > < / ul >

作为第四章解释,选择PHP语法最好为模板让他们读non-PHP开发者。你应该在模板将PHP代码降到最低,因为这些文件是用来设计应用程序的GUI,并且有时会由另一个团队,创建和维护专业演讲而不是应用程序逻辑。保持行动也使得内部的逻辑有几个模板为单一行动,没有任何代码重复。

助手

助手是返回HTML代码的PHP函数,可用于模板。在清单7 - 1中,link_to ()函数是一个帮手。有时,助手只是省时便利,包装代码片段经常用于模板。例如,你可以很容易地想象的helper函数定义:

< ? php回声image_tag(“photo.jpg”)? >= > < img src =“遗产/图片/ photo.jpg”/ >

它应该类似于清单7 - 2。

清单7 - 2 -样品辅助定义

函数image_tag(美元的来源){返回' < img src = " /遗留/图片/ '。美元的来源。的" / >;}

事实上,image_tag ()内置函数symfony有点比这更复杂,因ob娱乐下载为它接受其他属性添加到第二个参数< img >标签。你可以检查它在网上完成语法和选项API文欧宝官网下载app档。

大多数时候,助手把情报和节省你的长和复杂的编码:

< ? php回声auto_link_text(请访问我们的网站www.example.com的)? >= > < a href =请访问我们的网站“http://www.example.com”> www.example.com < / >

帮助促进写作模板的过程和生产最好的HTML代码的性能和可访问性。你可以使用普通的HTML,但帮手通常更快的写。

宣布助手

symfob娱乐下载ony文件包含辅助定义并不自动装载(因为它们包含函数,而不是类)。助手分组的目的。例如,所有的辅助函数定义在一个文件被称为处理文本TextHelper.php,被称为文本辅助组。如果你需要使用一个辅助模板,你必须加载相关辅助组模板中早些时候宣布的use_helper ()函数。清单7显示了一个模板使用auto_link_text ()助手,这是部分的文本辅助组。

清单7 -声明一个辅助的使用

/ /这个模板使用特定的助手< ? phpuse_helper(“文本”)? >…<标题>描述< / h1 > < p > < ? php回声auto_link_text(美元的描述)? > < / p >

默认情况下几个助手可以在每个模板,不需要声明。下面这些是助手辅助组:

• 助手:助手包容(所需use_helper ()事实上,函数是一个辅助本身)李< / ><李>标签:基本标签辅助,使用的几乎每一个帮手李< / ><李>Url:链接和网址管理助手李< / ><李>资产:助手填充HTML<头>部分,并提供简单的链接外部资产(图像、JavaScript和样式表文件)李< / ><李>部分:助手允许包含模板片段李< / ><李>缓存:操纵缓存的代码片段李< / >

标准的助手列表,默认加载每一个模板,是可配置的settings.yml文件。如果你知道你不会使用的帮手缓存组,或者你会总是使用的文本集团的修改standard_helpers相应的设置。这将加快您的应用程序。您不能删除第一个四个助手组在前面的列表(助手,标签,Url,资产),因为他们是强制性的模板引擎的正常工作。因此,他们甚至没有出现在列表中标准的帮手。

常用的助手

您将了解一些帮手在以后章节中详细,他们帮助关系的特性。清单7 - 4的简要列表默认使用很多帮手,一起返回的HTML代码。

清单7 - 4——普遍默认的帮手

/ /辅助组< ? phpuse_helper(“HelperName”)? >< ? phpuse_helper(“HelperName1”,“HelperName2”,“HelperName3”)? >/ / Url集团< ? php回声link_to(点击我的,“mymodule里/ myaction”)? >= > < a href =“/线路/ / myaction”< / > >点击我/ /依赖于路由设置/ /资产组< ? php回声image_tag(“模板”,“alt = foo大小= 200 x100”)? >= > < img src =“遗产/图片/ myimage.png”alt =“foo”宽度=“200”身高=“100”/ >< ? php回声javascript_include_tag(“myscript”)? >= ><脚本语言=“JavaScript”类型=“text / javascript”src =“/ js / myscript.js”> < /脚本>< ? php回声stylesheet_tag(“风格”)? >href = = > <链接“样式表/ style.css”媒体=“屏幕”rel =“样式表”类型=“文本/ css”/ >

还有许多其他的助手在symfony,需要一个完整的书描述他们所有ob娱乐下载人。最好的帮手是参考网上的API文档(http:// www.symfony-project.org/a欧宝官网下载apppi/1_4/),所有的助手都被记录ob娱乐下载在案,语法,选择,和例子。

添加你自己的助手

ob娱乐下载Symfony附带很多帮手用于各种目的,但是如果你找不到你需要的API文档,您可能想创建一个新的帮手。欧宝官网下载app这很容易做到。

辅助函数(常规PHP函数返回HTML代码)应该保存在一个文件中FooBarHelper.php,在那里FooBar是辅助组的名称。存储的文件应用程序/前端/ lib /帮助/目录(或任何辅助/目录下创建一个lib /您的项目的文件夹)所以它可以自动发现的use_helper (“FooBar”)辅助列入。

页面布局

清单7 - 1中所示的模板并不是一个有效的XHTML文档。的文档类型定义和< html >和<身体>标签是失踪。这是因为他们在应用程序存储在其他地方,在一个文件中layout.php,其中包含页面布局。这个文件,也称为全球模板,商店是常见的所有页面的HTML代码的应用程序,以避免重复它在每一个模板。模板的内容集成到布局,或者,如果你改变的角度来看,“装饰”的布局模板。这是装饰设计模式的一个应用,如图7 - 1所示。

图7 - 1 -装修模板布局

清单7 - 5显示了默认的页面布局,位于应用程序模板/目录中。

清单7 - 5 -默认布局,myproject /应用程序/前端/模板/ layout.php

< !DOCTYPE html公共”——/ / W3C XHTML 1.0 / / DTD过渡/ / EN”“http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”> < html xmlns =“http://www.w3.org/1999/xhtml”xml: lang =“en”lang =“en”> <头>< ? phpinclude_javascripts()? >< ? phpinclude_stylesheets()? >< ? phpinclude_http_metas()? >< ? phpinclude_metas()? >< ? phpinclude_title()? >< link rel =“快捷方式图标”href =“/ ico”位于身体负责人/ > < / > < >< ? php回声sf_content美元? >< /身体> < / html >

的助手叫<头>部分获取信息从响应对象和视图配置。的<身体>标签模板的输出结果。这个布局,默认的配置和示例模板在清单7 - 1中,处理视图如清单7所示。

清单7,布局视图配置和模板组装

< !DOCTYPE html公共”——/ / W3C XHTML 1.0 / / DTD过渡/ / EN”“http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd”> < html xmlns =“http://www.w3.org/1999/xhtml”xml: lang =“en”lang =“en”> <头> < meta http-equiv =“内容类型”内容=“text / html;charset = utf - 8”/ > < meta name =“标题”内容=“ob娱乐下载symfony项目”/ > < meta name =“机器人”内容=“指数,遵循“/ > < meta name =“描述”内容=“ob娱乐下载symfony项目”/ > < meta name =“关键词”内容=“ob娱乐下载symfony项目”,/ > <标题> sob娱乐下载ymfony项目< /名称> < link rel =“样式表”类型=“文本/ css”href =“/ css / main.css”/ > < link rel =“快捷方式图标”href =“/ ico”位于> < /头> <身体> < h1 > < / h1 > < p >欢迎欢迎回来,< ? php回声美元的名字? >! < / p > < h2 >你想做李? < / h2 > < ul > < > < ? php回声link_to(“阅读过去的文章”,/读条的)李李? > < / > < > < ? php回声link_to(“开始编写一个新的”,文章/写的)李? > < / > < / ul > < /身体> < / html >

全球模板可以完全定制为每个应用程序。你需要添加在任何HTML代码。这种布局通常用于网站导航,标志,等等。你甚至可以有多个布局,并决定应该使用哪个布局为每个行动。不要担心JavaScript和样式表包含现在;在本章后面的“查看配置”一节展示了如何处理。

模板的快捷方式

在模板,一些symfony变量总是可用的ob娱乐下载。这些快捷键给访问最常需要的信息模板,通过核心symfony对象:ob娱乐下载

• sf_context美元:整个上下文对象(sfContext的实例)李< / ><李>sf_request美元:请求对象(sfRequest的实例)李< / ><李>sf_params美元:请求的参数对象李< / ><李>sf_user美元:当前用户会话对象(sfUser的实例)李< / >

前一章的详细有用的方法sfRequest和sfUser对象。你可以在模板通过调用这些方法sf_request美元和sf_user美元变量。例如,如果请求包含一个总参数,其值是可用的模板中使用以下:

/ /长版< ? php回声sf_request美元- >getParameter(“总”)? >/ /短版< ? php回声sf_params美元- >得到(“总”)? >/ /相当于以下操作代码回声美元的请求- >getParameter(“总”)

代码片段

您可能经常需要包含一些HTML或PHP代码在几个页面。为了避免重复代码,PHP包括()声明大部分时间就足够了。

例如,如果许多应用程序的模板需要使用相同的代码片段,将其保存在一个文件中myFragment.php在全球模板目录(/前端/模板/ myproject /应用程序),它包含在您的模板如下:

< ? php包括(sfConfig::得到(“sf_app_template_dir”)。' / myFragment.php ')? >

但这并不是一个非常干净的包一个片段,主要是因为可以有不同的变量名之间的片段和各种模板包括它。此外,symfony缓存系统(第1ob娱乐下载2章中描述)已经没有办法检测到一个包括,所以不能独立于模板缓存片段。ob娱乐下载Symfony提供了三个选择类型的智能代码片段来取代包括史:

• 如果逻辑是轻量级的,你只是想将包括一个模板文件获得一些数据传递给它。为此,您将使用一个部分。李< / ><李>如果重逻辑(例如,如果您需要访问的数据模型和/或修改内容根据会话),你会愿意把表示从逻辑分开。为此,您将使用一个组件。李< / ><李>如果片段是为了替换特定的布局的一部分,默认的内容可能已经存在,您将使用一个插槽。李< / >

将这些碎片是通过助手部分组。这些助手可从任何symfony模板,没有最初的声明。ob娱乐下载

分音

部分是一个可重用的模板代码块。例如,在出版应用程序中,使用模板代码显示一篇文章详细信息页面,并在列表中最好的文章和最新文章列表。这段代码是一个完美的候选人部分,如图7 - 2所示。

图7 - 2 -重用模板的泛音

就像模板,文件位于泛音模板/目录,它们包含HTML代码嵌入PHP。部分文件名总是始于一个下划线(_),这有助于区分泛音和模板,因为它们位于相同的模板/文件夹。

一个模板可以包括泛音是否在同一模块,在另一个模块,或在全球模板/目录中。包括部分使用include_partial ()助手,并指定模块和部分的名称作为一个参数(但忽略前导下划线和落后. php),如清单7所示。

清单7——包括一个部分的一个模板mymodule里模块

/ /包括前端/模块/ mymodule里/模板/ _mypartial1。php部分/ /模板和部分在同一个模块中,/ /模块名称可以省略< ? phpinclude_partial(“mypartial1”)? >/ /包括前端/模块/ foobar /模板/ _mypartial2。php部分/ /模块名称是强制性的< ? phpinclude_partial(“foobar / mypartial2”)? >/ / / _mypartial3包括前端/模板。php部分/ /它被认为是“全球”模块的一部分< ? phpinclude_partial(“全球/ mypartial3”)? >

泛音访问通常symfony助手和模板的捷径。ob娱乐下载但由于泛音可以从任何地方调用应用程序,他们没有自动访问操作调用模板中定义的变量,包括他们,除非明确作为参数传递。例如,如果你想要一个部分访问总美元变量,行动必须交给模板,然后模板辅助的第二个参数include_partial ()调用,如清单7 - 8所示,7 - 9、7 - 10。

清单7 - 8 -行动定义了一个变量,mymodule里/行动/ actions.class.php

类mymoduleActions扩展sfActions{公共函数executeIndex(){这个美元- >总=One hundred.;}}

清单7 - 9 -模板将变量传递到部分,mymodule里/模板/ indexSuccess.php

< p >你好,世界! < / p >< ? phpinclude_partial(“mypartial”,数组(“mytotal”= >总美元))? >

清单7 - 10 -部分现在可以使用变量,mymodule里/模板/ _mypartial.php

< p >总:< ? php回声mytotal美元? > < / p >

公共函数executeFoo(){/ /做事情这个美元- >喷火=1234年;这个美元- >酒吧=4567年;返回这个美元- >renderPartial方法(“mymodule里/ mypartial”);}

返回$ this - > renderPartial方法(mymodule里/ mypartial,数组(“foo”= > $ this - > foo));

组件

在第二章中,第一个示例脚本分为两部分分离的逻辑形式。就像MVC模式适用于行动和模板,您可能需要将部分分为逻辑部分和演示部分。在这种情况下,您应该使用一个组件。

这样的组件是一个动作,除非它要快得多。组件的逻辑是保存在一个类继承sfComponents位于一个行动/ components.class.php文件。其表现是保存在一个部分。的方法sfComponents类从单词开始执行,就像行动,他们可以通过变量来表示总统在同样的方式,动作可以通过变量。泛音作为组件命名表示的组件(没有领先执行,但用下划线代替)。表7 - 1比较了行为和组件的命名约定。

表7 - 1,行动和组件的命名约定

例如,假设您有一个边栏显示最新的新闻标题对于一个给定的主题,根据用户的配置文件,这是在几页中重用。欧宝平台是合法的吗必要的查询新闻标题过于复杂的出现在一个简单的部分,所以他们需要搬到欧宝平台是合法的吗一个行动,比如文件——一个组件。图7展示了这个例子。

对于这个示例,清单7 - 11和7 - 12所示,该组件将被保存在自己的模块(称为欧宝平台是合法的吗),但是您可以混合组件和动作在单个模块如果从功能的角度看是有道理的。

图7 -在模板中使用组件

清单7 - 11 -组件类,模块/新闻/行动欧宝平台是合法的吗/ components.class.php

< ? php类欧宝平台是合法的吗newsComponents扩展sfComponents{公共函数executeHeadlines(){/ /推动$ c=新标准();$ c- >addDescendingOrderByColumn(欧宝平台是合法的吗NewsPeer::PUBLISHED_AT);$ c- >setLimit(5);这个美元- >欧宝平台是合法的吗= 欧宝平台是合法的吗NewsPeer::doSelect($ c);/ /学说美元的查询=学说::可以获得的(“欧宝平台是合法的吗新闻”)- >createQuery()- >orderBy(“published_at DESC”)- >限制(5);这个美元- >欧宝平台是合法的吗=美元的查询- >执行();}}

清单7 - 12——部分模块/新闻/模板欧宝平台是合法的吗/ _headlines.php

< div > < h1 > < 欧宝平台是合法的吗/ h1 > < ul >最新消息< ? phpforeach(美欧宝平台是合法的吗元的新闻作为美元的标题):? ><李>< ? php回声美元的标题- >getPublishedAt()? >< ? php回声link_to(美元的标题- >getTitle(),“欧宝平台是合法的吗新闻/节目? id =”。美元的标题- >getId())? >李< / >< ? phpendforeach? >< / ul > < / div >

现在,每一次你需要的组件在一个模板,就叫这个:

< ? phpinclude_component(“欧宝平台是合法的吗新闻”,“标题”)? >

就像泛音,组件接受额外的参数在一个关联数组的形状。可用的参数部分下他们的名字,并在组件通过这个美元对象。清单7给出了一个例子。

清单7 - 13 -传递参数到一个组件和它的模板

/ /调用组件< ? phpinclude_component(“欧宝平台是合法的吗新闻”,“标题”,数组(“foo”= >“酒吧”))? >/ /组件本身回声这个美元- >喷火;= >“酒吧”/ / _headlines。php部分回声$ foo;= >“酒吧”

您可以包括组件组件,或者在全球布局,在任何常规的模板。喜欢行动,组件的执行方法可以通过变量相关部分和访问相同的快捷方式。但有一点是不同的。一个组件不处理安全或验证,不能被称为从互联网上(仅从应用程序本身),和没有回报的可能性。这就是为什么一个组件比一个动作更快的执行。

槽

部件和组件的可重用性。但是在许多情况下,代码片段需要填补一个布局与多个动态区。例如,假设您想要添加一些自定义标记<头>部分的布局,根据动作的内容。或者,假设布局有一个主要的动态区域,由行动的结果,加上很多其他的小的,有一个默认内容中定义的布局,但可以在模板覆盖水平。

在这些情况下,解决方案是一个插槽。基本上,槽是一个占位符,您可以在任何视图的元素(在一个模板布局,或部分)。填充此占位符就像设置一个变量。填充代码存储在全球响应,所以你可以在任何地方定义(在一个模板布局,或部分)。包括之前一定要定义一个槽,并且记住,布局模板后执行(这是装饰的过程),执行和泛音当他们被称为模板。它听起来太抽象吗?让我们看看一个例子。

想象一个有一个区域的布局模板和两个槽:一个侧边栏,另一个用于页脚。在模板中定义的位置值。在装修过程中,布局代码封装模板代码,和槽充满了前面定义的值,如图7 - 4所示。侧边栏和页脚可以上下文的主要行动。这就像有一个布局与不止一个“洞”。

图7 - 4 -布局插槽中定义一个模板

看到一些代码将进一步澄清的事情。包括一个槽,使用include_slot ()帮手。的has_slot ()帮助的回报真正的如果已经定义了槽,提供一个回退机制作为奖金。例如,定义一个占位符“侧边栏”布局和默认的内容如清单7 - 14所示。

清单7 - 14——包括一个“侧边栏”槽的布局

< div id =“侧边栏”>< ? php如果(has_slot(“侧边栏”)):? >< ? phpinclude_slot(“侧边栏”)? >< ? php其他的:? >< !默认的侧边栏代码- - > < h1 >上下文区< / h1 > < p >该区域包含链接和信息相对于页面的主要内容。< / p >< ? phpendif;? >< / div >

很常见的显示一些默认的内容如果没有定义一个槽,include_slot辅助返回一个布尔值表示如果槽被定义。清单7 - 15显示了如何考虑这个返回值来简化代码。

清单7 - 15——包括一个“侧边栏”槽的布局

< div id =“侧边栏”>< ? php如果(include_slot !(“侧边栏”)):? >< !默认的侧边栏代码- - > < h1 >上下文区< / h1 > < p >该区域包含链接和信息相对于页面的主要内容。< / p >< ? phpendif;? >< / div >

每个模板可以定义一个槽的内容(实际上,甚至泛音能做到)。作为插槽是HTML代码,symfony提供了一个方便的方式来定义:只写槽之间ob娱乐下载的调用代码槽()和end_slot ()帮手,如清单7 - 16所示。

清单7 - 16 -覆盖“侧边栏”槽一个模板中的内容

/ /……< ? php槽(“侧边栏”)? >< !custom sidebar code为的当前的模板- - > < h1 >用户详细信息< / h1 > < p >名称:< ? php回声$ user- >getName()? > < / p > < p >电子邮件:< ? php回声$ user- >getEmail()? > < / p >< ? phpend_slot()? >

槽之间的代码助手的上下文中执行模板,所以它可以访问所有的变量,这些变量被定义的行动。ob娱乐下载Symfony会自动把这段代码在响应对象的结果。它不会显示在模板,但对未来可用include_slot ()电话,就像清单7 - 14所示。

槽是非常有用的定义区显示相关内容。他们也可以用来添加HTML代码布局仅供特定的行为。例如,模板的列表显示的最新消息可能想添加一个RSS提要的链接欧宝平台是合法的吗<头>布局的一部分。只需添加一个来完成这个任务“喂”槽的布局和覆盖它的模板列表。

如果槽的内容很短,因为这是在定义一个标题槽为例,您可以简单地通过的内容作为第二个参数槽()方法7 - 17见清单。

7 - 17清单——使用槽()定义一个短暂的价值

< ? php槽(“标题”,“标题值”)? >

myproject /应用程序/ application1 /模板/ #布局应用1模块/ module1 /模板/模块1 #模板和泛音module2 /模板/ #模板和模块2的泛音module3 /模板/ #模板和模块3的泛音

查看配置

在syob娱乐下载mfony中,视图包含两个不同的部分:

• 的HTML表示动作的结果(存储在模板,在布局和模板片段)李< / ><李>

  所有的其余部分,包括以下几点:

  • 元声明:关键字、描述或缓存时间。李< / ><李>页面标题:它不仅帮助用户与多个浏览器窗口打开,找到你的,但它也是非常重要的搜索网站的索引。李< / ><李>文件包含:JavaScript和样式表文件。李< / ><李>布局:一些操作需要一个自定义布局(弹出窗口,广告,等等)或任何布局(如Ajax行为)。李< / >

在视图中,所有这不是HTML被称为视图配置,和symfony提供了两种方法来操纵它。ob娱乐下载通常的方法是通过view.yml配置文件。它可以用来当的值不依赖于上下文或数据库查询。当您需要设置动态值,另一种方法是通过设置视图配置sfResponse对象属性直接行动。

的view.yml文件

每个模块可以有一个view.yml文件定义设置的视图。这允许您定义视图设置整个模块和每个视图在单个文件中。第一级的键view.yml文件是模块视图名称。清单7 - 18显示了一个示例的配置。

清单7 - 18 -示例模块级view.yml

editSuccess:搜索:标题:编辑你的个人资料editError:搜索:标题:错误的概要文件版本:样式表:[my_style]搜索:标题:我的网站

模块的默认设置下定义全部:的关键模块view.yml。默认设置为所有应用程序视图中定义应用程序view.yml。再一次,你认识级联配置原则:

• 在应用程序/前端/模块/ mymodule里/ config / view.yml,阅览定义仅适用于一个视图和覆盖模块级定义。李< / ><李>在应用程序/前端/模块/ mymodule里/ config / view.yml,全部:定义适用于所有模块和覆盖应用程序级的行动定义。李< / ><李>在应用程序/前端/ config / view.yml,默认值:定义适用于所有模块和应用程序的所有操作。李< / >

在看到默认的模板在清单7 - 5和清单7中最终响应的一个例子,你可能想知道头值来自哪里。事实上,他们默认视图设置,应用程序中定义view.yml和清单7-19所示。

清单7-19 -默认应用程序级视图配置应用程序/前端/ config / view.yml

默认值:http_metas: - type: text / html搜索:#标题:# symfony项目描述:symfob娱乐下载ony项目#关键词:symfony,项目#语言:en #机器人:指数遵循样式表:[主要]javascripts: [] has_layout:真正的布局:布局

这些设置将详细描述“查看配置设置”一节。

响应对象

尽管视图层的一部分,响应对象往往是修改的行动。行动可以访问symfony的响应对象,调用ob娱乐下载sfResponse通过getResponse ()方法。清单7-20列出了一些的sfResponse常用在一个动作方法。

清单7-20 -行动访问sfResponse对象方法

类mymoduleActions扩展sfActions{公共函数executeIndex(){美元的反应=这个美元- >getResponse();/ / HTTP标头美元的反应- >setContentType(“text / xml”);美元的反应- >setHttpHeader(“内容语言”,“en”);美元的反应- >setStatusCode(403年);美元的反应- >addVaryHttpHeader(“接收语言”);美元的反应- >addCacheControlHttpHeader(“no - cache”);/ /饼干美元的反应- >setCookie(美元的名字,美元的内容,美元到期,美元的路径,美元的域);/ /搜索和页眉美元的反应- >addMeta(“机器人”,“没有”);美元的反应- >addMeta(“关键词”,“foo酒吧”);美元的反应- >setTitle(“我的FooBar页面”);美元的反应- >addStyleSheet(“custom_style”);美元的反应- >addJavaScript(“custom_behavior”);}}

除了setter方法所示,sfResponse类的getter方法,返回响应属性的当前值。

symfony的头setter是非常强大的。ob娱乐下载头都尽可能晚(发送sfRenderingFilter),所以你可以改变它们,直到你想要的。他们还提供了非常有用的快捷键。例如,如果您不指定字符集当你调用setContentType ()中定ob娱乐下载义,symfony自动添加默认字符集settings.yml文件。

美元的反应- >setContentType(“text / xml”);回声美元的反应- >getContentType();= >text / xml;charset = utf - 8 '

响应状态码的symfony符合HTTP规范。ob娱乐下载500年异常返回一个状态,页面没有找到404年返回一个状态,正常返回一个状态200页,页面不修改可以被简化为一个简单的标题和状态码304(有关详细信息,请参阅第12章),等等。但是你可以覆盖这些缺省值设置自己的状态码的行动setStatusCode ()响应的方法。您可以指定一个自定义代码和一个自定义消息,或者只是一个自定义代码,在这种情况下,symfony将为这段代码添加最常见的消息。ob娱乐下载

美元的反应- >setStatusCode(404年,“这个页面不存在”);

视图配置设置

您可能已经注意到,有两种视图配置设置:

• 那些有一个唯一的值(该值是一个字符串view.yml使用一个文件和响应集方法对那些)李< / ><李>的多个值(view.yml使用数组和响应使用一个添加方法)李< / >

记住,配置级联擦除的独特价值设置但堆积多个值设置。这将变得更加明显当你通过这一章的进展。

Meta标签配置

写的信息< meta >标签的响应是不显示在浏览器但对机器人和搜索引擎是非常有用的。它还控制每个页面的缓存设置。定义这些标签下http_metas:和搜索:钥匙在view.yml,如清单7-21,或addHttpMeta ()和addMeta ()响应行动中的方法,如清单7-22所示。

清单7-21——元定义键:值对view.yml

http_metas: cache - control:公共搜索:描述:在法国财政关键词:金融、法国

清单7-22——元定义响应设置在操作

这个美元- >getResponse()- >addHttpMeta(“cache - control”,“公共”);这个美元- >getResponse()- >addMeta(“描述”,“在法国金融”);这个美元- >getResponse()- >addMeta(“关键词”,金融、法国的);

添加一个现有的关键将取代当前的默认内容。对于HTTP meta标签,您可以添加一个第三个参数并设置它假有addHttpMeta ()方法(以及setHttpHeader ())值附加到现有的一个,而不是取代它。

这个美元- >getResponse()- >addHttpMeta(“接收语言”,“en”);这个美元- >getResponse()- >addHttpMeta(“接收语言”,“fr”,假);回声这个美元- >getResponse()- >getHttpHeader(“接收语言”);= >“恩,fr”

为了这些元标记出现在最终的文档include_http_metas ()和include_metas ()必须在助手<头>部分(这是默认布局的情况;参见清单7 - 5)。ob娱乐下载Symfony会自动聚集所有的设置view.yml文件(包括默认显示在清单7 - 18)和属性输出适当的响应< meta >标签。清单7-21中的示例见清单7日结束。

清单7日- - - - - - -元标记输出在最后一页

< meta http-equiv =“内容类型”内容=“text / html;charset = utf - 8”/ > < meta http-equiv =“cache - control”内容=“公共”/ > < meta name =“机器人”内容=“指数,遵循“/ > < meta name =“描述”内容=在法国“金融”/ > < meta name =“关键词”内容=“金融、法国”/ >

作为奖励,响应的HTTP头也受到影响http-metas:定义,即使你没有include_http_metas ()助手的布局,或者如果你没有布局。例如,如果您需要发送一个页面作为纯文本,定义如下view.yml:

http_metas:内容类型:文本/纯has_layout:假的

标题的配置

页面标题是搜索引擎索引的关键部分。也是非常有用的现代浏览器提供标签浏览。在HTML中,标题是一个标签和页面的元信息,所以view.yml文件看到了标题:关键的孩子搜索:关键。清单7-24显示了标题的定义view.yml,清单7-25显示了定义在行动。

清单7-24 -标题定义view.yml

indexSuccess:搜索:标题:三只小猪

清单7-25——行动——允许动态标题定义标题

这个美元- >getResponse()- >setTitle(sprintf(“% d小猪”,美元的数量));

在<头>部分的最后文件,标题定义设置< meta name = "标题" >标签,如果include_metas ()助手存在,<标题>标签,如果include_title ()助手。如果两个都包括(如清单7 - 5)的默认布局,标题出现两次文档中(请参见清单7)来源,这是无害的。

文件包含配置

特定样式表或JavaScript文件添加到一个视图很容易,如清单7-26所示。

文件包含清单7-26 -资产

/ /视图中。yml indexSuccess:样式表:[mystyle1, mystyle2] javascripts: [myscript]

/ /在行动这个美元- >getResponse()- >addStylesheet(“mystyle1”);这个美元- >getResponse()- >addStylesheet(“mystyle2”);这个美元- >getResponse()- >addJavascript(“myscript”);/ /模板中< ? phpuse_stylesheet(“mystyle1”)? >< ? phpuse_stylesheet(“mystyle2”)? >< ? phpuse_javascript(“myscript”)? >

在每种情况下,参数是一个文件名。如果文件有一个逻辑扩展(. css样式表. js对于一个JavaScript文件),您可以忽略它。如果文件有一个合乎逻辑的位置(/ css /样式表/ js /对于一个JavaScript文件),您可以忽略它。ob娱乐下载Symfony是足够聪明来找出正确的扩展或位置。

像元和标题定义文件包含定义需要的用法include_javascripts ()和include_stylesheets ()助手在模板或布局包括在内。这意味着之前的设置将输出清单7-27的HTML代码。

清单7-27——文件包含的结果

< >头…< link rel =“样式表”类型=“文本/ css”媒体=“屏幕”href =“/ css / mystyle1.css”/ > < link rel =“样式表”类型=“文本/ css”媒体=“屏幕”href =“/ css / mystyle2.css”/ ><脚本语言=“javascript”类型=“text / javascript”src =“/ js / myscript.js”>> < /脚本< / >头

记住,配置级联原则适用,所以任何文件包含应用程序中定义view.yml让它出现在应用程序的每一页。上市7-28,第七至第二十九页和7-30演示这一原则。

清单7-28 -示例应用程序view.yml

默认值:样式表(主要):

清单第七至第二十九页——示例模块view.yml

indexSuccess:样式表(特殊)::样式表:[其他]

清单7-30 -结果indexSuccess视图

< link rel =“样式表”类型=“文本/ css”媒体=“屏幕”href =“/ css / main.css”/ > < link rel =“样式表”类型=“文本/ css”媒体=“屏幕”href =“/ css / additional.css”/ > < link rel =“样式表”类型=“文本/ css”媒体=“屏幕”href =“/ css / special.css”/ >

如果您需要删除一个文件定义在更高的层面,只是添加一个减号(- - - - - -)在文件名前的低级别定义,如清单7-31所示。

清单7-31——示例模块view.yml删除一个文件定义在应用程序级别

indexSuccess:样式表(小镇、特殊)::样式表:[其他]

删除所有样式表或JavaScript文件,使用- *作为文件名,清单7-32所示。

清单7-32——示例模块view.yml删除所有文件定义在应用程序级别

indexSuccess:样式表:[- *]的javascript: [- *]

你可以更准确,定义一个额外参数,迫使包括文件的位置(第一个或最后一个位置),见清单7-33。这是样式表和JavaScript文件。

清单7-33 -定义包括资产的位置

/ /视图中。yml indexSuccess:样式表:[特殊:{位置:第一}]

/ /在行动这个美元- >getResponse()- >addStylesheet(“特殊”,“第一”);/ /模板中< ? phpuse_stylesheet(“特殊”,“第一”)? >

您也可以决定绕过资产转换文件名,这样产生的<链接>或<脚本>标签是指指定的确切位置,显示在清单7-34。

清单7-34 -样式表包含与原始的名字

/ /视图中。yml indexSuccess:样式表:(主要论文:{raw_name:真}]

/ /在行动这个美元- >getResponse()- >addStylesheet(“主要”,”,数组(“raw_name”= >真正的));/ /模板中< ? phpuse_stylesheet(“主要”,”,数组(“raw_name”= >真正的))? >/ /生成的视图< link rel =“样式表”类型=“文本/ css”href =“主要”/ >

样式表包含指定媒体,您可以更改默认的样式表标签选项,见清单编。

清单编-样式表包含与媒体

/ /视图中。yml indexSuccess:样式表:(主要论文:{媒体:印刷}]

/ /在行动这个美元- >getResponse()- >addStylesheet(“纸”,”,数组(“媒体”= >“打印”));/ /模板中< ? phpuse_stylesheet(“纸”,”,数组(“媒体”= >“打印”))? >/ /生成的视图< link rel =“样式表”类型=“文本/ css”媒体=“打印”href =“/ css / paper.css”/ >

布局配置

根据你网站的图形特许,你可能有一些布局。经典的网站至少有两个:默认布局和弹出式布局。

你已经看到默认的布局myproject /应用程序/前端/模板/ layout.php。额外的布局必须添加在同一个全球模板/目录中。如果你想使用一个视图前端/模板/ my_layout.php文件,使用清单7-36所示的语法。

清单7-36 -布局的定义

/ /视图。yml indexSuccess:布局:my_layout

/ /在行动这个美元- >setLayout(“my_layout”);/ /模板中< ? phpdecorate_with(“my_layout”)? >

一些观点不需要任何布局(例如,纯文本页面或RSS feed)。在这种情况下,集has_layout来假,见清单7-37。

删除清单7-37 -布局

/ /在“视图中。yml indexSuccess: has_layout:假的

/ /在行动这个美元- >setLayout(假);/ /模板中< ? phpdecorate_with(假)? >

输出逃离

当你插入动态数据模板,你必须确定数据的完整性。例如,如果数据来自由匿名用户填写表格,有一个风险,它可能包含恶意脚本启动跨站点脚本(XSS)攻击。你必须能够逃脱的输出数据,所以它包含任何HTML标记变得无害。

作为一个例子,假设一个用户填充一个输入字段用以下值:

<脚本>警报(。)> < /脚本

如果你呼应这个值没有谨慎,JavaScript将执行在每个浏览器和允许更危险的攻击只是显示一个警告。这就是为什么你必须摆脱值显示之前,所以它变成了这样:

& lt; script>警觉(。)</script>

你可以逃脱你的手动输出封闭在调用每一个确定值htmlspecialchars函数(),但这种方法很重复,容易出错。相反,symfonob娱乐下载y提供了一个特殊的系统,称为输出逃离,自动转义每在一个模板变量输出。在应用程序中默认激活settings.yml。

激活输出逃离

输出逃离全球应用程序的配置settings.yml文件。两个参数控制输出的方式逃避工作原理:战略决定了可用的变量是由视图,和方法是默认转义函数应用到数据。

基本上,所有您需要做的激活转义输出设置escaping_strategy参数真正的(默认),见清单7-38。

清单7-38 -激活输出逃离,前端/ config / settings.yml

:.settings: escaping_strategy:真正的escaping_method: ESC_SPECIALCHARS

这将增加htmlspecialchars函数()默认情况下所有变量输出。例如,假设您定义一个测试变量的操作如下:

这个美元- >测试=' <脚本>警报(。)< /脚本> ';

与输出逃离,呼应这个变量的模板将输出逃出来的数据:

回声美元的测试;= > <script>alert(。)</script>

此外,每个模板都有访问sf_data美元变量,这是一个容器对象引用的所有变量。所以你也可以输出的测试变量如下:

回声sf_data美元- >得到(“测试”);= > <script>alert(。)</script>

sf_data美元也给你访问保有的,或原始数据。这是非常有用的,当一个变量存储HTML代码是由浏览器解释,只要你信任这个变量。调用getRaw ()当你需要原始数据输出方法。

回声sf_data美元- >getRaw(“测试”);= > <脚本>警报(。)> < /脚本

你需要访问原始数据每次你需要变量包含HTML真正解读为HTML。

当escaping_strategy是假,sf_data美元仍然可用,但是它总是返回原始数据。

逃离助手

逃离助手函数返回一个逃脱了版本的输入。它们可以作为一个默认提供escaping_method在settings.yml文件或指定一个转义视图中的一个特定值的方法。以下逃离助手可以:

• ESC_RAW:不逃避价值。李< / ><李>ESC_SPECIALCHARS:适用于PHP函数htmlspecialchars函数()的输入。李< / ><李>ESC_ENTITIES:适用于PHP函数htmlentities ()输入的ENT_QUOTES引用样式。李< / ><李>ESC_JS:逃值放入一个JavaScript字符串将被用作HTML。这是用于逃避事情,HTML是使用JavaScript动态改变。李< / ><李>ESC_JS_NO_ENTITIES:逃值放入一个JavaScript字符串但不添加实体。这是非常有用的,如果显示的值是使用(例如,一个对话框myString中使用的变量javascript:警报(myString);)。李< / >

逃离数组和对象

输出逃离不仅适用于字符串,而且对数组和对象。任何对象或数组的值都将他们的逃跑状态传递给他们的孩子。假设你的策略设置真正的,清单7-39演示了逃离级联。

清单7-39 -逃避也适用于数组和对象

/ /类定义类myClass{公共函数testSpecialChars(美元的价值=”){返回“<”。美元的价值。“>”;}}/ /在行动这个美元- >test_array=数组(“&”,“<”,“>”);这个美元- >test_array_of_arrays=数组(数组(“&”));这个美元- >test_object=新myClass();/ /模板中< ? phpforeach(test_array美元作为美元的价值):? >< ? php回声美元的价值? >< ? phpendforeach;? >= > & < >< ? php回声test_array_of_arrays美元(0](0]? >= > &< ? php回声test_object美元- >testSpecialChars(“&”)? >= > & lt;,在

事实上,模板中的变量并不是你期望的类型。输出逃逸系统“装饰”并将其转化为特殊的对象:

< ? php回声get_class(test_array美元)? >= > sfOutputEscaperArrayDecorator< ? php回声get_class(test_object美元)? >= > sfOutputEscaperObjectDecorator

这就解释了为什么一些PHP函数(如array_shift (),print_r ()等)不再工作逃数组。但他们仍然可以访问使用[],被遍历使用foreach,并返回正确的结果count ()。在模板,数据应该是只读的,所以大部分通过方法访问将做的工作。

你仍然有办法获取原始数据通过sf_data美元对象。此外,逃脱了对象的方法是改变接受一个额外的参数:一种逃避的方法。所以你可以选择一个替代方法每次显示一个变量中逃出来的一个模板,或者选择ESC_RAW助手禁用逃跑。请参见清单7-40为例。

清单7-40 -逃对象的方法接受一个额外的参数

< ? php回声test_object美元- >testSpecialChars(“&”)? >= > & lt;,在/ /三线后返回相同的值< ? php回声test_object美元- >testSpecialChars(“&”,ESC_RAW)? >< ? php回声sf_data美元- >getRaw(“test_object”)- >testSpecialChars(“&”)? >< ? php回声sf_data美元- >得到(“test_object”,ESC_RAW)- >testSpecialChars(“&”)? >= > <和>

如果你处理对象模板,您将使用额外的参数方法很多,因为它是最快的方式方法调用原始数据。

总结

各种各样的工具可用于操纵表示层。模板是建立在几秒钟内,多亏了帮手。泛音,布局和组件的模块化和可重用性。视图配置利用YAML的速度来处理(大部分)页面标题。配置级联免除您从定义每一个设置为每个视图。每修改取决于动态数据的表示,行动已经进入sfResponse对象。和视图从XSS攻击是安全的,由于逃逸系统的输出。