基本 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 ,default
true
)
如果设置为 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 PHP 扩展(用 C 编写),PHP 包将自动利用它来优化一些常见例程。