TwigBundle配置(“twig”)

编辑本页

警告:您正在浏览的文档欧宝官网下载appob娱乐下载Symfony 3.0,现已不再维护。

本页的更新版本用于Syob娱乐下载mfony 6.2(当前稳定版本)。

TwigBundle配置(“twig”)

  • YAML
  • XML
  • PHP
12 34 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 32 33 34 35 36 37 38 39 40 41 42 43 44 45
枝:exception_controller:twig.controller.exception: showActionform_themes:#默认值:-form_div_layout.html.twig#引导:-bootstrap_3_layout.html.twig-bootstrap_3_horizontal_layout.html.twig#基础-foundation_5_layout.html.twig#的例子:-MyBundle: form.html.twig全局变量:#的例子:foo:“@bar”pi:3.14#示例选项,但最简单的用法是如上所示some_variable_name:#应该是值的服务idid:#设置为服务或留空类型:值:autoescape:#见http://twig.sensiolabs.org/doc/recipes.html#using-the-template-name-to-set-the-default-escaping-strategyautoescape_service:#示例:'@my_service'autoescape_service_method:#与autoescape_service选项结合使用base_template_class:#示例:Twig_Template缓存:“% kernel.cache_dir % /枝”字符集:“% kernel.charset %”调试:“% kernel.debug %”strict_variables:auto_reload:优化:道路:' % kernel.root_dir % / . . /供应商/ acme / foo bar /模板”foo_bar

谨慎

twig.form<树枝:形式/ >Tag for xml)配置键已弃用,将在3.0中移除。相反,使用twig.form_themes选择。

配置

auto_reload

类型布尔默认的“% kernel.debug %”

如果真正的,每当一个模板被呈现时,Symfony首先检查它的源代码在编译后是否发ob娱乐下载生了变化。如果模板已经更改,将自动重新编译模板。

autoescape

类型布尔字符串默认的“文件名”

如果设置为,自动转义被禁用(您仍然可以在模板中单独转义每个内容)。

谨慎

将此选项设置为是危险的,它会使你的应用程序容易受到XSS攻击,因为大多数第三方捆绑包假定自动转义是启用的,它们自己不转义内容。

如果设置为字符串,则使用具有该名称的策略转义模板内容。允许的值为超文本标记语言jscssurlhtml_attr而且文件名.默认值为文件名.该策略根据文件扩展名(例如,它使用超文本标记语言* .html.twig模板和js* .js.html模板)。

提示

看到autoescape_service而且autoescape_service_method定义你自己的逃跑策略。

autoescape_service

类型字符串默认的

从Twig 1.17开始,默认情况下应用到模板的转义策略是在编译期间根据模板的文件名确定的。这意味着,例如,a的内容* .html.twig的内容进行转义* .js.twig为JavaScript转义。

此选项允许定义Symfony服务,该服务将用于确定应用于模板的默认ob娱乐下载转义。

autoescape_service_method

类型字符串默认的

如果autoescape_service选项,然后此选项定义被调用的方法,以确定应用于模板的默认转义。

base_template_class

类型字符串默认的“Twig_Template”

枝模板在使用它们呈现内容之前被编译成PHP类。此选项定义所有模板类都从其扩展的基类。不建议使用自定义基础模板,因为这会使应用程序更难维护。

缓存

类型字符串默认的“% kernel.cache_dir % /枝”

在使用Twig模板呈现某些内容之前,它们被编译成常规PHP代码。编译是一个代价高昂的过程,因此结果被缓存在这个配置选项定义的目录中。

将此选项设置为禁用Twig模板编译。但是,不建议这样做;甚至不是在dev环境,因为auto_reload选项确保重新编译已更改的缓存模板。

字符集

类型字符串默认的“% kernel.charset %”

模板文件使用的字符集。在Symfonob娱乐下载y标准版中,默认为utf - 8字符集。

调试

类型布尔默认的“% kernel.debug %”

如果真正的,编译后的模板包括__toString ()方法,该方法可用于显示其节点。

exception_controller

类型字符串默认的twig.controller.exception: showAction

这是在应用程序中的任何位置抛出异常后激活的控制器。默认控制器(ExceptionController)负责在不同的错误条件下呈现特定的模板(参见如何自定义错误页面).修改此选项是高级操作。如果您需要定制一个错误页面,您应该使用前面的链接。类的侦听器中,如果需要对异常执行某些行为,则应该添加侦听器kernel.exception事件(见依赖注入标签).

优化

类型int默认的-1

Twig包含一个名为优化器在Symfony应用程序中默认启用。ob娱乐下载这个扩展分析模板,以在编译时优化它们。例如,如果您的模板不使用特殊循环变量。标记,此扩展删除未使用变量的初始化。

默认情况下,该选项为-1,这意味着所有优化都已打开。设置为0禁用所有优化。您甚至可以有选择地启用或禁用这些优化,正如Twig文档中所解释的那样欧宝官网下载app优化器扩展

路径

类型数组默认的

该选项定义了Symfony在默认位置之外查找Twig模板的目录(ob娱乐下载应用程序/资源/视图/还有这些包裹资源/视图/目录)。这对于集成应用程序使用的某些库或包中包含的模板非常有用。

的值路径选项定义为键:值在哪里?价值部分可以是.例如:

  • YAML
  • XML
  • PHP
1 2 3 4 5
# app / config / config.yml枝:#……道路:' % kernel.root_dir % / . . /供应商/ acme / foo bar /模板”

类中定义的目录路径选项具有比Symfony定义的默认目录更高的优先级。ob娱乐下载在上述示例中,如果模板存在于/ acme / foo bar /模板目录供应商/, Symfony将使用它。ob娱乐下载

如果你为任何路径提供了一个值,Symfony会认为它是该目录的Twig命名ob娱乐下载空间:

  • YAML
  • XML
  • PHP
1 2 3 4 5
# app / config / config.yml枝:#……道路:' % kernel.root_dir % / . . /供应商/ acme / foo bar /模板”“foo_bar”

此选项有助于避免混淆Symfony定义的默认模板目录。ob娱乐下载此外,它简化了你如何引用这些模板:

1
@foo_bar / template_name.html.twig

strict_variables

类型布尔默认的“% kernel.debug %”

如果设置为真正的,当ob娱乐下载Twig变量、属性或方法不存在时,Symfony就会显示异常。如果设置为这些错误将被忽略,不存在的值将被

此工作,包括代码示例,是根据创作共用BY-SA 3.0许可证。