TwigBundle配置参考
编辑本页警告:您正在浏览的文档欧宝体育电话欧宝娱乐app下载地址Symfony 4.4，现已不再维护。
读本页的更新版本用于Sy欧宝娱乐app下载地址mfony 6.2(当前稳定版本)。
TwigBundle配置参考
TwigBundle集成了Symfony应用程序中的Twig库欧宝娱乐app下载地址渲染模板．方法下配置所有这些选项嫩枝输入应用程序配置。
1 2 3 4 5
#显示Symfony定义的默认配置值欧宝娱乐app下载地址＄PHP bin/console配置:dump-reference#显示应用程序使用的实际配置值＄PHP bin/控制台调试:config twig请注意
使用XML时，必须使用http://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/twig命名空间和相关的XSD模式可在:https://欧宝娱乐app下载地址www.oldmanjams.com/schema/dic/twig/twig-1.0.xsd
配置
auto_reload
类型：布尔默认的：% kernel.debug %
如果真正的，每当一个模板被呈现时，Symfony首先检查它的源代码在编译后是否发欧宝娱乐app下载地址生了变化。如果模板已经更改，将自动重新编译模板。
autoescape
类型：布尔或字符串默认的：“名字”
如果设置为假，自动转义被禁用(您仍然可以在模板中单独转义每个内容)。
谨慎
将此选项设置为假是危险的，它将使您的应用程序容易受到攻击XSS攻击因为大多数第三方捆绑包假定自动转义是启用的，它们自己不转义内容。
如果设置为字符串，则使用具有该名称的策略转义模板内容。允许的值为超文本标记语言，js，css，url，html_attr而且的名字．默认值为的名字．该策略根据模板名扩展名转义内容(例如它使用超文本标记语言为* .html.twig模板和js为* .js.twig模板)。
提示
看到autoescape_service而且autoescape_service_method定义你自己的逃跑策略。
autoescape_service
类型：字符串默认的：零
从Twig 1.17开始，默认情况下应用到模板的转义策略是在编译期间根据模板的文件名确定的。这意味着，例如，a的内容* .html.twig的内容进行转义* .js.twig为JavaScript转义。
此选项允许定义Symfony服务，该服务将用于确定应用于模板的默认欧宝娱乐app下载地址转义。
base_template_class
类型：字符串默认的：“树枝\模板”
枝模板在使用它们呈现内容之前被编译成PHP类。此选项定义所有模板类都从其扩展的基类。不建议使用自定义基础模板，因为这会使应用程序更难维护。
缓存
类型：字符串|假默认的：“% kernel.cache_dir % /枝”
在使用Twig模板呈现某些内容之前，它们被编译成常规PHP代码。编译是一个代价高昂的过程，因此结果被缓存在这个配置选项定义的目录中。
将此选项设置为假禁用Twig模板编译。但是，不建议这样做;甚至不是在dev环境，因为auto_reload选项确保重新编译已更改的缓存模板。
字符集
类型：字符串默认的：“% kernel.charset %”
模板文件使用的字符集。的值在默认情况下相同内核。字符集容器参数，即utf - 8在Symfony应用程序中默欧宝娱乐app下载地址认。
日期
属性使用的默认值日期筛选器格式化日期和时间值。它们有助于避免将相同的论点传递给每个人日期过滤器调用。
default_path
类型：字符串默认的：“% kernel.project_dir % /模板”
Symfony将在默认情况下查找应用程序Twig模板的目录的路径欧宝娱乐app下载地址。如果将模板存储在多个目录中，请使用路径选项。
exception_controller
类型：字符串默认的：twig.controller.exception: showAction
4.4
的exception_controller配置选项在Symfony 4.4中已弃用。欧宝娱乐app下载地址设置为零并使用新的error_controller选择下框架配置。
这是在应用程序中的任何位置抛出异常后激活的控制器。默认控制器(ExceptionController)负责在不同的错误条件下呈现特定的模板(参见如何自定义错误页面)．修改此选项是高级操作。如果您需要定制一个错误页面，您应该使用前面的链接。如果需要对异常执行某些行为，则应该添加事件监听器到内核。异常事件．
form_themes
类型：数组的字符串默认的：(“form_div_layout.html.twig”)
定义一个或多个形式的主题其中应用于所有形式的应用程序:
- YAML
- XML
- PHP
1 2 3 4
#配置/包/ twig.yaml枝:form_themes:[' bootstrap_4_layout.html.twig ',“形式/ my_theme.html.twig”］#……定义主题的顺序很重要，因为每个主题都会覆盖前一个主题。当呈现表单主题中未定义块的表单字段时，Symfony将退回到前面的主题，直到第一个主题。欧宝娱乐app下载地址
这些全局主题应用于所有表单，甚至那些使用form_theme树枝标签，但你可以禁用特定表单的全局主题．
number_format
属性使用的默认值number_format筛选器格式化数值。它们有助于避免将相同的论点传递给每个人number_format过滤器调用。
优化
类型：整数默认的：－1
Twig包含一个名为优化器在Symfony应用程序中默认启用。欧宝娱乐app下载地址这个扩展分析模板，以在编译时优化它们。例如，如果您的模板不使用特殊循环变量。为标记，此扩展删除未使用变量的初始化。
默认情况下，该选项为－1，这意味着所有优化都已打开。设置为0禁用所有优化。您甚至可以有选择地启用或禁用这些优化，正如Twig文档中所解释的那样欧宝体育电话优化器扩展．
路径
类型：数组默认的：零
属性中定义的目录之外，定义存储应用程序模板的目录default_path选项：
- YAML
- XML
- PHP
1 2 3 4 5 6
#配置/包/ twig.yaml枝:#……道路:“电子邮件/默认模板”:～“后端/模板”:“管理”阅读更多模板目录和命名空间．
strict_variables
类型：布尔默认的：假
如果设置为真正的，当欧宝娱乐app下载地址Twig变量、属性或方法不存在时，Symfony就会显示异常。如果设置为假这些错误将被忽略，不存在的值将被零．
