twig模板引擎详解（上集：设计师篇）【twig模板引擎中文使用教程】

最新推荐文章于 2024-06-16 18:56:54 发布

u011474028

最新推荐文章于 2024-06-16 18:56:54 发布

阅读量4.5k

点赞数 1

分类专栏： php程序文章标签： twig模板引擎详解（上集：设计师篇） twig使用教程中文文档

本文链接：https://blog.csdn.net/u011474028/article/details/81086725

版权

前文：本文是《云客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：
是否处于调试模式，布尔值，默认为false

charset：
模板使用的字符编码，默认为 UTF-8

base_template_class：
基础模板类，用于被编译后的模板php文件，默认为Twig_Template

cache：
可选值有储存编译后模板的目录，或者为false以禁用编译缓存，这是默认值，也可以是缓存对象（接口：Twig_CacheInterface的实例，见开发者篇）

auto_reload：
布尔值，在原模板文件改变时是否重新加载，如果没有提供那么将根据debug选项决定

strict_variables：
是否使用严格变量模式，默认为false，为真时模板中使用无效变量将抛出错误，否则为NULL

autoescape：
是否全局自动转义，可能的值有：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

最低0.47元/天解锁文章

u011474028

关注

1
点赞
踩
5

收藏

觉得还不错? 一键收藏
0
评论
twig模板引擎详解（上集：设计师篇）【twig模板引擎中文使用教程】

前文：本文是《云客drupal源码分析》系列的番外篇，由于drupal采用了twig模板引擎，因此该篇将详细介绍twig，但不会涉及drupal任何内容，是原生twig的使用详解，分上下两集，上集供设计师阅读，讲解在模板中的使用，下集供php程序开发人员阅读，讲解程序调用、扩展开发。本篇为上集，额外介绍了安装等必要内容，以便首次接触人员查阅，纯模板设计师可以跳过。官网地址：https://t...
复制链接

扫一扫

专栏目录