基本 API 使用

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

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 实例时,你可以传递一个选项数组作为构造函数的第二个参数。以下是可用选项的列表:

  • debug( 布尔值,默认 false

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

  • charset( 字符串,默认 utf-8

模板使用的字符集。

  • base_template_class( 字符串,默认 Twig_Template

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

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

存储已编译模板的绝对路径,或 false 以禁用缓存(这是默认值)。

  • auto_reload( boolean ,默认继承自 debug

使用 Twig 进行开发时,每当源代码更改时重新编译模板都很有用。如果没有为 auto_reload 选项提供值,则将根据调试值自动确定该值。

  • strict_variables( 布尔值,默认 false

如果设置为 false,Twig 将默默地忽略无效变量(变量和/或不存在的属性/方法),并用空值替换它们。设置为 true 时,Twig 会抛出异常。

  • autoescape( string 或 boolean ,defaulttrue

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

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

从 Twig 1.9 开始,你可以设置要使用的转义策略(css,url,html_attr 或带有模板 filename 的 PHP 回调,并且必须返回要使用的转义策略 - 回调不能是要避免的函数名称与内置逃逸策略的碰撞)。

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

  • 优化( 整数,默认 -1

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

官方 Twig 安装指南

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