本文主要是介绍twig模板引擎详解(上集:设计师篇)【twig模板引擎中文使用教程】,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
前文:本文是《云客drupal源码分析》系列的番外篇,由于drupal采用了twig模板引擎,因此该篇将详细介绍twig,但不会涉及drupal任何内容,是原生twig的使用详解,分上下两集,上集供设计师阅读,讲解在模板中的使用,下集供php程序开发人员阅读,讲解程序调用、扩展开发。
本篇为上集,额外介绍了安装等必要内容,以便首次接触人员查阅,纯模板设计师可以跳过。
官网地址:https://twig.symfony.com/
本文写作时官网已经发布了V1.35.3 及V2.4.8
安装:
需求:
和php一样,发布大版本后,以前的版本依然会维护一段时间,因此twig目前有两个版本都在维护
1.X版本:至少PHP 5.2.7,从1.34开始至少需要PHP 5.3.3.
2.X版本:至少PHP 7.0.0
包括drupal8在内,许多项目都还在使用1.X,这里以1.X做主要介绍,有多种方法安装twig,官方推荐使用composer,运行如下命令即可:
composer require twig/twig:~1.0
为了提高性能twig还提供了有限功能的php层面的C扩展,详见官网,这里我们以下载文件方式来安装。
安装:
到这里下载文件包:https://github.com/twigphp/Twig/tags
本文选择: v1.35.3 解压下载的Twig-1.35.3.tar.gz 由于twig使用psr-0的自动加载方式,所以里面的lib就是我们需要的库文件,将其复制到网站根目录即可
你可以在本机通过phpstudy等软件安装运行环境,这里以C:\root\twigtest作为网站根目录,以http://www.twigtest.com/作为域名
根目录建立index.php,内容如下:
<?php
require_once 'lib/Twig/Autoloader.php';
Twig_Autoloader::register();
$loader = new Twig_Loader_Array(array('index' => 'Hello {{ name }}!',
));
$twig = new Twig_Environment($loader);
echo $twig->render('index', array('name' => 'Fabien'));
访问域名,即可看到结果,安装完成。
开始使用:
假设你已经按前一步设置好了目录与文件,我们来从文件系统加载一个模板文件,进行显示:
在根目录建立子目录“templates”用以存放模板文件,在其中建立文本文件“index.html.twig”,内容如下:
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>twig</title>
</head>
<body>
hello world ! {{name}}
</body>
</html>
在网站根目录重新建立index.php,内容如下:
<?php
require_once 'lib/Twig/Autoloader.php';
Twig_Autoloader::register();$loader = new Twig_Loader_Filesystem('templates');
$twig = new Twig_Environment($loader, array('cache' => 'templates_cache',
));
echo $twig->render('index.html.twig', array('name' => 'yunke'));
然后访问站点http://www.twigtest.com/index.php,你将会看到:
hello world ! yunke
同时在站点根目录下多出了一个子目录:
templates_cache
其中存放着为提高性能编译为php文件的模板文件,默认只编译一次,如原文件发生变化需重新编译(删除缓存)
在以上代码中Twig_Environment是twig的中枢对象,类接收两个参数:
\Twig_Environment::__construct (Twig_LoaderInterface $loader = null, $options = array())
$loader是实现了\Twig_LoaderInterface接口的加载器,用于加载模板文件
$options是选项数组,控制twig行为,有效选项如下:
debug:
是否处于调试模式,布尔值,默认为falsecharset:
模板使用的字符编码,默认为 UTF-8base_template_class:
基础模板类,用于被编译后的模板php文件,默认为Twig_Templatecache:
可选值有储存编译后模板的目录,或者为false以禁用编译缓存,这是默认值,也可以是缓存对象(接口:Twig_CacheInterface的实例,见开发者篇)auto_reload:
布尔值,在原模板文件改变时是否重新加载,如果没有提供那么将根据debug选项决定strict_variables:
是否使用严格变量模式,默认为false,为真时模板中使用无效变量将抛出错误,否则为NULLautoescape:
是否全局自动转义,可能的值有:false(禁止转义),true(默认值,等效为html),html(转义html实体),js(转义js),css(转义css),url(转义url),html_attr(转义html和属性),name(基于模板扩展名设置自动转义策略),PHP callback(由一个php回调来返回转义策略,该回调接收模板的名字做参数)optimizations:
模板编译时的优化选项,“-1”代表开启全部优化(默认值),“0”代表禁用优化,还有其他值详见下集中优化扩展一节
渲染代码:$twig->render('index.html.twig', array('name' => 'yunke'));原型为:
render($name, array $context = array())
第一个参数是模板的文件名,用于加载模板
第二个是传递给模板的变量数组,键名为在模板中的变量名,键值为对应的变量值,该变量数组称为模板的“上下文”,在模板中通过“_context”能访问到该数组,下文将多次提到“上下文”就是指该变量数组
模板文件命名:
twig模板是一个段文本内容,可以存放在数据库、php变量、文件等地方,如果是文本文件,命名是任意的,任意扩展名均可,但通常使用“.twig”或“.html.twig”作为扩展名
----上集部分(设计师篇)----
默认界定符:
{% ... %} 执行标签,用于执行语句,如控制结构
{{ ... }} 打印标签,用于打印表达式的计算结果
{# ... #} 注释标签,用于注释,类似程序中的注释:/* ..*/
#{…} 插值标签,用于向表达式中的字符串插入变量值
这些定界符只是twig的默认值,是可以完全自定义的,详见下集开发者篇
字面量Literals:
字符串:如"Hello World",可用“\”转义特殊字符,如'It\'s good','c:\\Program Files'
数字:包括整数和浮点数,如4/3.14
数组:如["foo", "bar"]&#x
这篇关于twig模板引擎详解(上集:设计师篇)【twig模板引擎中文使用教程】的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!