上集重点介绍了twig模板的使用,供模板设计者阅读,下集供php开发者阅读,讲解如何调用和扩展twig,这一篇安装和采用版本将衔接上集内容。
Twig_Environment:
该类的实例是twig模板系统的中心枢纽,也叫环境对象,用于保存配置、twig扩展、加载模板等,在她内部调度twig系统的各个类,可以说她是系统的对外使用接口,代表整个twig系统,因此通常用$twig变量名来表示她(在本文中凡使用该变量名,均指环境对象),初始化时接收两个参数:
加载器:负责从不同的源加载模板的内容,比如文件系统、数据库等等,不同的源用不同的加载器
选项数组:在上集中已经讲述过各选项的含义,本篇仅介绍缓存选项相关的缓存对象,见后。
加载器:
twig提供了一些默认加载器,如有特殊需求需要自己实现,默认加载器如下:
Twig_Loader_Filesystem:
用于从文件系统加载模板文件,用法如下:
$loader = new Twig_Loader_Filesystem($templateDir , $rootPath);
参数$templateDir是模板目录的绝对路径,或者是相对路径(相对于第二个参数),也可以是由她们构成的数组,此时数组中的相对路径全部是相对于第二个参数的,可以通过第二个构造参数$rootPath指定相对的根目录,如果没有提供,那么将采用执行脚本的工作目录,也就是getcwd()函数的值,如下;
$loader = new Twig_Loader_Filesystem(array($templateDir1, $templateDir2));
此时将依次查找模板文件,直到找到一个为止,实例化后也可以添加路径:
$loader->addPath($templateDir3); //追加路径
$loader->prependPath($templateDir4); //添加路径到已添加路径的前面,以便首先查找
通过以上两方法添加路径时,也可以指定名字空间,这将不同模板分到不同的组中,如:
$loader->addPath($templateDir, 'admin');
当没有指定名字空间时,默认为“main”,名字空间相当于为其下的所有目录提供了别名,可以这样加载模板:
@namespace_name/template_path
如:
$twig->render('@admin/index.html', array());
这将在名字空间“admin”下的所有目录查找“index.html”模板,名字空间在分前台模板和后台管理模板时很有用
Twig_Loader_Array:
用于从数组加载模板,使用如下:
$loader = new Twig_Loader_Array(array(
'index.html' => 'Hello {
{ name }}!',
));
键名是模板名,键值是模板内容,这通常用于单元测试,或者在一些将所有模板存放在php文件中的小项目中
Twig_Loader_Chain:
加载器链,用于将多个加载器整合到一起,当加载模板时,依次调用这些加载器,一旦找到模板即停止查找,使用方法如下:
$loader1 = new Twig_Loader_Array(array(
'base.html' => '{% block content %}{% endblock %}',
));
$loader2 = new Twig_Loader_Array(array(
'index.html' => '{% extends "base.html" %}{% block content %}Hello {
{ name }}{% endblock %}',
'base.html' => 'Will never be loaded',
));
$loader = new Twig_Loader_Chain(array($loader1, $loader2));
$twig = new Twig_Environment($loader);
接收由多个加载器构成的数组,传递的加载器需要实现Twig_LoaderInterface,个数不限,实例化后还可以继续添加加载器,使用该方法:
addLoader(Twig_LoaderInterface $loader)
但须注意一旦加载器实例化后,无法调整加载器的顺序
自定义加载器:
全部加载器必须实现接口:
\Twig_LoaderInterface
该接口只有三个方法:
public function getSource($name);
得到模板内容
public function getCacheKey($name);
得到提供给缓存系统使用的模板缓存键,但在缓存系统中真实的缓存id还可以结合其他内容;在文件系统加载器中,该方法返回模板文件的相对路径
public function isFresh($name, $time);
判定模板的缓存是否还有效,第二个参数应该是缓存的模板的修改时间,也就是被编译后的模板的修改时间,在内部将和源