twig模板引擎详解(下集:开发者篇)【twig模板引擎中文使用教程】

这篇博客详细讲解了Twig模板引擎的开发者使用,包括Twig_Environment对象、加载器、缓存对象、自定义加载器和缓存、以及如何添加和使用扩展。重点介绍了Twig_Loader_Filesystem、Twig_Loader_Array、Twig_Loader_Chain等加载器,以及自定义缓存对象的实现。此外,还涵盖了核心扩展、沙盒模式、分析器和优化器的使用。开发者可以通过这些知识更好地管理和扩展Twig模板引擎。
摘要由CSDN通过智能技术生成

上集重点介绍了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);
判定模板的缓存是否还有效,第二个参数应该是缓存的模板的修改时间,也就是被编译后的模板的修改时间,在内部将和源

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值