编译缓存

所有模板加载器都可以在文件系统上缓存已编译的模板，以便将来重用。它大大提高了Twig的速度，因为模板只编译一次。

内置的加载器

下面是内置加载器的列表:

1

＄加载程序＝新\树枝\装载机\ FilesystemLoader (＄templateDir）;

1

＄加载程序＝新\树枝\装载机\ FilesystemLoader ([＄templateDir1，＄templateDir2]);

1 2

＄加载程序->目录＄templateDir3）;＄加载程序->prependPath (＄templateDir4）;

1

＄加载程序->目录＄templateDir，“管理”）;

1

＄嫩枝->呈现(“@admin / index . html”[]);

1

＄加载程序＝新\树枝\装载机\ FilesystemLoader (“模板”, getcwd()。“/ . .”）;

1 2 3 4 5 6

＄加载程序＝新\树枝\装载机\ ArrayLoader ([“index . html”= >“你好{{name}}!”]);＄嫩枝＝新\树枝\环境(＄加载程序）;回声＄嫩枝->呈现(“index . html”, (“名字”= >“法”]);

1 2 3 4 5 6 7 8 9 10 11

＄loader1＝新\树枝\装载机\ ArrayLoader ([“base.html”= >'{% block内容%}{% endblock %}']);＄loader2＝新\树枝\装载机\ ArrayLoader ([“index . html”= >'{%扩展"base.html" %}{% block内容%}Hello {{name}}{% endblock %}'，“base.html”= >“永远不会载入”]);＄加载程序＝新\树枝\装载机\ ChainLoader ([＄loader1，＄loader2]);＄嫩枝＝新\树枝\环境(＄加载程序）;

创建自己的Loader

所有加载器都实现\树枝\装载机\ LoaderInterface：

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

接口＼嫩枝＼加载程序＼LoaderInterface｛/** *返回给定模板逻辑名的源上下文。* *@paramstring $name模板逻辑名* *@return\树枝\来源* *@throws当$name没有找到时\Twig\Error\LoaderError公共函数getSourceContext（＄的名字）；/** *获取要用于给定模板名称的缓存的缓存键。* *@paramstring $name要加载的模板名称* *@returnstring缓存键* *@throws当$name没有找到时\Twig\Error\LoaderError公共函数getCacheKey（＄的名字）；/** *如果模板仍然是新的，则返回true。* *@param* . string $name模板名称@paramtimestamp $time缓存的模板最后一次修改时间* *@return如果模板是新的，Bool为true，否则为false@throws当$name没有找到时\Twig\Error\LoaderError公共函数isFresh（＄的名字，＄时间）；/** *检查我们是否有一个模板的源代码，给出它的名字。* *@param用于检查是否可以加载* *的模板名称@return是否由该加载器处理模板源代码*/公共函数存在（＄的名字）；｝

的isFresh ()方法必须返回真正的如果当前缓存的模板仍然是新鲜的，给定最后的修改时间，或者假否则。

的getSourceContext ()方法的实例\树枝\源．

核心扩展

的核心扩展定义了Twig的所有核心功能:

• 标签；
• 过滤器；
• 功能；
• 测试．

排放器扩展

的逃脱者扩展添加自动输出转义到树枝。它定义了一个标签，autoescape，和一个过滤器，生．

当创建escaper扩展时，你可以打开或关闭全局输出转义策略:

1 2

＄逃脱者＝新\ \树枝\扩展EscaperExtension (“html”）;＄嫩枝->addExtension (＄逃脱者）;

如果设置为超文本标记语言时，模板中的所有变量都将转义(使用超文本标记语言逃跑策略)，除了那些使用生过滤器:

1

{{article.to_html |生}}

属性也可以在本地更改转义模式autoescape标签:

1 2 3 4 5

{%autoescape“html”%}{{var}}{{var |生}}{# var不转义#}{{var |逃避}}{# var不会被双转义#}{%endautoescape%}

转义规则实现如下:

• 在模板中直接作为变量或过滤器参数使用的字面量(整数，布尔值，数组，…)永远不会自动转义:

  1 2 3 4

  {{"Twig
  "}}{#不会被转义#}{%集text = "树枝
  " %}{{text}}{#将转义#}

• 结果为字面量或标记为safe的变量的表达式永远不会自动转义:

  1 2 3 4 5 6 7 8

  {{foo ?"Twig
  ": "
  Twig"}}{#不会被转义#}{%集text = "树枝
  " %}{{真的吗?text: "
  Twig"}}{#将转义#}{{false ?text: "
  Twig"}}{#不会被转义#}{%集text = "树枝
  " %}{{foo ?文本|生: "
  Twig"}}{#不会被转义#}

• 对象具有__toString方法被转换为字符串并转义。你可以标记一些类和/或接口为安全的某些策略通过EscaperExtension: addSafeClass ()：

  1 2 3 4 5 6 7 8 9 10 11

  //标记类Foo对象为安全的HTML策略$escaper->addSafeClass('Foo'， [' HTML ']);//标记接口Foo对象为安全的HTML策略$escaper->addSafeClass('FooInterface'， [' HTML ']);//标记类Foo对象为安全的HTML和JS策略$escaper->addSafeClass('Foo'， [' HTML '， ' JS ']);$escaper->addSafeClass('Foo'， ['all']);

• 转义应用在打印之前，任何其他过滤器应用之后:

  1

  {{var |上}}{#等价于{{var|upper|escape}} #}

• ' raw '过滤器应该只在过滤器链的末端使用:

  1 2 3

  {{var |生|上}}{#将转义#}{{var |上|生}}{#不会被转义#}

• 如果链中的最后一个过滤器对于当前上下文被标记为安全，则不会应用自动转义。超文本标记语言或js)．逃避而且逃避(html)标记为HTML安全，逃避(js)对JavaScript来说是安全的，生标志着一切安全。

  1 2 3 4 5

  {%autoescapejs的%}{{var |逃避(html)}}{#将转义HTML和JavaScript #}{{var}}{#将转义为JavaScript #}{{var |逃避(js)}}{#不会被双转义#}{%endautoescape%}

沙箱扩展

的沙盒扩展可用于计算不受信任的代码。禁止访问不安全的属性和方法。沙箱安全性由策略实例管理。默认情况下，Twig带有一个策略类:\树枝\沙箱\ SecurityPolicy．这个类允许你列出一些标签、过滤器、属性和方法:

1 2 3 4 5 6 7 8 9 10

＄标签= (“如果”]；＄过滤器= (“上”]；＄方法= (“文章”= > [“getTitle”，“getBody”]];＄属性= (“文章”= > [“标题”，“身体”]];＄功能= (“范围”]；＄政策＝新\树枝\沙箱\ SecurityPolicy (＄标签，＄过滤器，＄方法，＄属性，＄功能）;

的配置，安全策略将只允许使用如果标签，而上过滤器。而且，模板将只能调用getTitle ()而且getBody ()上的方法文章对象，以及标题而且身体公共属性。其他的都不允许并且会生成\树枝\沙箱\ SecurityError例外。

策略对象是沙盒构造函数的第一个参数:

1 2

＄沙盒＝新\ \树枝\扩展SandboxExtension (＄政策）;＄嫩枝->addExtension (＄沙盒）;

默认情况下，沙盒模式是禁用的，当使用沙盒标签:

1 2 3

{%沙盒%}{%包括“user.html”%}{%endsandbox%}

你可以通过传递来沙盒所有模板真正的作为扩展构造函数的第二个参数:

1

＄沙盒＝新\ \树枝\扩展SandboxExtension (＄政策，真正的）;

分析器扩展

的分析器扩展可以为Twig模板提供分析器;它应该只在你的开发机器上使用，因为它会增加一些开销:

1 2 3 4 5

＄配置文件＝新\树枝\分析器\概要();＄嫩枝->addExtension (新\ \树枝\扩展ProfilerExtension (＄配置文件));＄自动倾卸车＝新\树枝\分析器\翻车机\ TextDumper ();回声＄自动倾卸车->转储(＄配置文件）;

概要文件包含关于模板、块和宏执行的时间和内存消耗的信息。

类型中转储数据Blackfire.io兼容的格式:

1 2

＄自动倾卸车＝新\树枝\分析器\翻车机\ BlackfireDumper ();写入“/道路/ / profile.prof”，＄自动倾卸车->转储(＄配置文件));

上传概要文件以可视化它(创建一个免费帐户第一个):

1

Blackfire——slot=7 upload /path/to/profile.prof

优化器扩展

的优化器扩展在编译前优化节点树:

1

＄嫩枝->addExtension (新\ \树枝\扩展OptimizerExtension ());

默认情况下，所有优化都是打开的。你可以通过将它们传递给构造函数来选择你想要启用的:

1 2 3

＄优化器＝新\ \树枝\扩展OptimizerExtension(\树枝\ NodeVisitor \ OptimizerNodeVisitor：：OPTIMIZE_FOR);＄嫩枝->addExtension (＄优化器）;

Twig支持以下优化:

• \树枝\ NodeVisitor \ OptimizerNodeVisitor:: OPTIMIZE_ALL，启用所有优化(这是默认值)。
• \树枝\ NodeVisitor \ OptimizerNodeVisitor:: OPTIMIZE_NONE，禁用所有优化。这减少了编译时间，但会增加执行时间和消耗的内存。
• \树枝\ NodeVisitor \ OptimizerNodeVisitor:: OPTIMIZE_FOR，优化为标记，删除循环尽可能地创建变量。
• \树枝\ NodeVisitor \ OptimizerNodeVisitor:: OPTIMIZE_RAW_FILTER，删除生尽可能进行筛选。
• \树枝\ NodeVisitor \ OptimizerNodeVisitor:: OPTIMIZE_VAR_ACCESS，尽可能简化编译模板中变量的创建和访问。