twig 基本API用法

示例

也可以通过下载源代码并将其放置在项目的目录中来进行安装。但是,使用作曲家有很多好处。

require '/path/to/lib/Twig/Autoloader.php';
Twig_Autoloader::register();

$loader = new Twig_Loader_Filesystem('/path/to/templates');

$options = array(
    'strict_variables' => false,
    'debug' => false,
    'cache'=> false
);

$twig = new Twig_Environment($loader, $options);

创建新Twig_Environment实例时,可以传递选项数组作为构造函数的第二个参数。以下是可用选项的列表:

  • 调试(布尔值,默认false)

设置为true时,生成的模板具有__toString()可用于显示生成的节点的方法。

  • 字符集(字符串,默认utf-8)

模板使用的字符集。

  • base_template_class(字符串,默认Twig_Template)

用于生成的模板的基本模板类。

  • 缓存(字符串或false,默认false)

用于存储已编译模板的绝对路径,或者为false以禁用缓存(默认设置)。

  • auto_reload(布尔值,默认继承自debug

使用Twig开发时,只要源代码发生更改,重新编译模板就很有用。如果您没有为auto_reload选项提供值,则会根据调试值自动确定该值。

  • strict_variables(boolean,default false)

如果设置为false,Twig将静默忽略无效变量(变量和/或不存在的属性/方法),并将其替换为空值。设置为true时,Twig引发异常。

  • 自动转义(字符串或布尔值,默认true)

如果设置为true,则默认情况下将为所有模板启用HTML自动转义。

从Twig 1.8开始,您可以设置转义策略以使用(html,js,false禁用)。

从Twig 1.9开始,您可以设置转义策略以使用(css,url,html_attr或采用模板“文件名”并且必须返回转义策略才能使用的PHP回调)–回调不能是避免使用的函数名与内置的转义策略发生冲突)。

从Twig 1.17开始,文件名转义策略根据模板文件名扩展名确定用于模板的转义策略(此策略在运行时不会产生任何开销,因为编译时会自动进行转义。)

  • 优化(整数,默认-1)

一个标志,指示要应用的优化:
set to -1 to enabled all optimalizations
set o 0 to disable all optimalitazations

Twig官方安装指南

Twig PHP扩展(用C编写)也可以编译和安装,PHP软件包将自动利用该扩展来优化一些常用例程。