twig模板引擎详解(上集:设计师篇)【twig模板引擎中文使用教程】

2024-06-09 08:18

本文主要是介绍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模板引擎中文使用教程】的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1044650

相关文章

Redis中6种缓存更新策略详解

《Redis中6种缓存更新策略详解》Redis作为一款高性能的内存数据库,已经成为缓存层的首选解决方案,然而,使用缓存时最大的挑战在于保证缓存数据与底层数据源的一致性,本文将介绍Redis中6种缓存更... 目录引言策略一:Cache-Aside(旁路缓存)策略工作原理代码示例优缺点分析适用场景策略二:Re

使用Python创建一个功能完整的Windows风格计算器程序

《使用Python创建一个功能完整的Windows风格计算器程序》:本文主要介绍如何使用Python和Tkinter创建一个功能完整的Windows风格计算器程序,包括基本运算、高级科学计算(如三... 目录python实现Windows系统计算器程序(含高级功能)1. 使用Tkinter实现基础计算器2.

在.NET平台使用C#为PDF添加各种类型的表单域的方法

《在.NET平台使用C#为PDF添加各种类型的表单域的方法》在日常办公系统开发中,涉及PDF处理相关的开发时,生成可填写的PDF表单是一种常见需求,与静态PDF不同,带有**表单域的文档支持用户直接在... 目录引言使用 PdfTextBoxField 添加文本输入域使用 PdfComboBoxField

Git可视化管理工具(SourceTree)使用操作大全经典

《Git可视化管理工具(SourceTree)使用操作大全经典》本文详细介绍了SourceTree作为Git可视化管理工具的常用操作,包括连接远程仓库、添加SSH密钥、克隆仓库、设置默认项目目录、代码... 目录前言:连接Gitee or github,获取代码:在SourceTree中添加SSH密钥:Cl

Java注解之超越Javadoc的元数据利器详解

《Java注解之超越Javadoc的元数据利器详解》本文将深入探讨Java注解的定义、类型、内置注解、自定义注解、保留策略、实际应用场景及最佳实践,无论是初学者还是资深开发者,都能通过本文了解如何利用... 目录什么是注解?注解的类型内置注编程解自定义注解注解的保留策略实际用例最佳实践总结在 Java 编程

MySQL数据库约束深入详解

《MySQL数据库约束深入详解》:本文主要介绍MySQL数据库约束,在MySQL数据库中,约束是用来限制进入表中的数据类型的一种技术,通过使用约束,可以确保数据的准确性、完整性和可靠性,需要的朋友... 目录一、数据库约束的概念二、约束类型三、NOT NULL 非空约束四、DEFAULT 默认值约束五、UN

Python中模块graphviz使用入门

《Python中模块graphviz使用入门》graphviz是一个用于创建和操作图形的Python库,本文主要介绍了Python中模块graphviz使用入门,具有一定的参考价值,感兴趣的可以了解一... 目录1.安装2. 基本用法2.1 输出图像格式2.2 图像style设置2.3 属性2.4 子图和聚

windows和Linux使用命令行计算文件的MD5值

《windows和Linux使用命令行计算文件的MD5值》在Windows和Linux系统中,您可以使用命令行(终端或命令提示符)来计算文件的MD5值,文章介绍了在Windows和Linux/macO... 目录在Windows上:在linux或MACOS上:总结在Windows上:可以使用certuti

CentOS和Ubuntu系统使用shell脚本创建用户和设置密码

《CentOS和Ubuntu系统使用shell脚本创建用户和设置密码》在Linux系统中,你可以使用useradd命令来创建新用户,使用echo和chpasswd命令来设置密码,本文写了一个shell... 在linux系统中,你可以使用useradd命令来创建新用户,使用echo和chpasswd命令来设

Python使用Matplotlib绘制3D曲面图详解

《Python使用Matplotlib绘制3D曲面图详解》:本文主要介绍Python使用Matplotlib绘制3D曲面图,在Python中,使用Matplotlib库绘制3D曲面图可以通过mpl... 目录准备工作绘制简单的 3D 曲面图绘制 3D 曲面图添加线框和透明度控制图形视角Matplotlib