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

相关文章

Java使用ANTLR4对Lua脚本语法校验详解

《Java使用ANTLR4对Lua脚本语法校验详解》ANTLR是一个强大的解析器生成器,用于读取、处理、执行或翻译结构化文本或二进制文件,下面就跟随小编一起看看Java如何使用ANTLR4对Lua脚本... 目录什么是ANTLR?第一个例子ANTLR4 的工作流程Lua脚本语法校验准备一个Lua Gramm

Java Optional的使用技巧与最佳实践

《JavaOptional的使用技巧与最佳实践》在Java中,Optional是用于优雅处理null的容器类,其核心目标是显式提醒开发者处理空值场景,避免NullPointerExce... 目录一、Optional 的核心用途二、使用技巧与最佳实践三、常见误区与反模式四、替代方案与扩展五、总结在 Java

IDEA自动生成注释模板的配置教程

《IDEA自动生成注释模板的配置教程》本文介绍了如何在IntelliJIDEA中配置类和方法的注释模板,包括自动生成项目名称、包名、日期和时间等内容,以及如何定制参数和返回值的注释格式,需要的朋友可以... 目录项目场景配置方法类注释模板定义类开头的注释步骤类注释效果方法注释模板定义方法开头的注释步骤方法注

使用Java将DOCX文档解析为Markdown文档的代码实现

《使用Java将DOCX文档解析为Markdown文档的代码实现》在现代文档处理中,Markdown(MD)因其简洁的语法和良好的可读性,逐渐成为开发者、技术写作者和内容创作者的首选格式,然而,许多文... 目录引言1. 工具和库介绍2. 安装依赖库3. 使用Apache POI解析DOCX文档4. 将解析

一文详解如何在Python中从字符串中提取部分内容

《一文详解如何在Python中从字符串中提取部分内容》:本文主要介绍如何在Python中从字符串中提取部分内容的相关资料,包括使用正则表达式、Pyparsing库、AST(抽象语法树)、字符串操作... 目录前言解决方案方法一:使用正则表达式方法二:使用 Pyparsing方法三:使用 AST方法四:使用字

Qt中QUndoView控件的具体使用

《Qt中QUndoView控件的具体使用》QUndoView是Qt框架中用于可视化显示QUndoStack内容的控件,本文主要介绍了Qt中QUndoView控件的具体使用,具有一定的参考价值,感兴趣的... 目录引言一、QUndoView 的用途二、工作原理三、 如何与 QUnDOStack 配合使用四、自

C++使用printf语句实现进制转换的示例代码

《C++使用printf语句实现进制转换的示例代码》在C语言中,printf函数可以直接实现部分进制转换功能,通过格式说明符(formatspecifier)快速输出不同进制的数值,下面给大家分享C+... 目录一、printf 原生支持的进制转换1. 十进制、八进制、十六进制转换2. 显示进制前缀3. 指

Python列表去重的4种核心方法与实战指南详解

《Python列表去重的4种核心方法与实战指南详解》在Python开发中,处理列表数据时经常需要去除重复元素,本文将详细介绍4种最实用的列表去重方法,有需要的小伙伴可以根据自己的需要进行选择... 目录方法1:集合(set)去重法(最快速)方法2:顺序遍历法(保持顺序)方法3:副本删除法(原地修改)方法4:

使用Python构建一个Hexo博客发布工具

《使用Python构建一个Hexo博客发布工具》虽然Hexo的命令行工具非常强大,但对于日常的博客撰写和发布过程,我总觉得缺少一个直观的图形界面来简化操作,下面我们就来看看如何使用Python构建一个... 目录引言Hexo博客系统简介设计需求技术选择代码实现主框架界面设计核心功能实现1. 发布文章2. 加

python logging模块详解及其日志定时清理方式

《pythonlogging模块详解及其日志定时清理方式》:本文主要介绍pythonlogging模块详解及其日志定时清理方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录python logging模块及日志定时清理1.创建logger对象2.logging.basicCo