Smarty模板引擎

曼亚灿

发布于 2023-05-17 13:38:05

4.7K0

发布于 2023-05-17 13:38:05

文章被收录于专栏：亚灿网志

学习目标模板引擎的工作原理Smarty入门Smarty...

请注意，本文编写于 1727 天前，最后修改于 996 天前，其中某些信息可能已经过时。

学习目标

模板引擎的工作原理
Smarty入门
Smarty配置
Smarty中的变量：普通变量、保留变量、配置文件变量
Smarty中的循环：foreach、section
Smarty中的if语句
Smarty变量调节器

模板引擎的工作原理

1、如何实现HTML代码和PHP代码分离？

实现HTML代码和PHP代码分离的目的是：实现前端设计人员和PHP程序员的分离。

多数Web开发人员要么是精通网页设计，能够设计出漂亮的网页外观，但是编写的PHP代码很糟糕；要么仅熟悉PHP编程，能够写出健壮的PHP代码，但是设计的网页外观很难看。具备两种才能的开发人员很少见。

将PHP和HTML混合页面，分成两个独立的页面：

一个是HTML静态页面(视图文件、模板文件)，扩展名是.html，包含HTML、CSS、JS

一个是纯PHP程序页面(控制器文件)，扩展名是.php，主要PHP代码。

运行时，将HTML文件代码，包含到PHP文件中。

实现PHP与静态文件的简单分离：

<?php
/**
 * 本页PHP程序...
 */

// 引入HTML静态文件
include './demo.html';

为啥要用include而不用require？因为静态文件中没有类、函数的定义，使用include可以降低服务器压力（我自己猜的。。。）。

2、如何完全去除视图文件中的PHP标记？

首先，视图中的典型PHP代码是这样的：**<?php echo $name ?>**
再者，前端工程师能看得懂的、比较喜欢的HTML标签形式的代码是这样的：{$name}
最后，我们把 {name} 替换成 <?php echo
模板引擎的原理：就是替换，就是将 {name} 转换成 <?php echo
如何替换呢？使用PHP替换函数str_replace()，将 { 替换成 <?php echo ，将}替换成?>。

简单实现：

<?php

// 编写本页程序
$name = '猪八戒';
$age = 22;

// 读取引入页面
$str = file_get_contents('./demo.html');

// 对读取的内容进行替换
$str = str_replace('{', '<?php echo ', $str);
$str = str_replace('}', ' ?>', $str);

// 将替换后的字符串写入原文件
file_put_contents('./demo.html', $str);

// 引入替换后的文件
include './demo.html';

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    <h1> {$name}今年{$age}岁了！！！</h1>
</body>

</html>

示例代码

3、常用PHP模板引擎介绍

Smarty，是模板引擎鼻祖。其它的模板引擎都是基于Smarty开发的。
Template Lite
TinyButStrong
XTemplate
Savant
phemplate
Dwoo
Sugar
Twig，symfony框架默认的模板引擎；
FXL Template
H2o
ns-template
Blade：laravel框架默认的模板引擎。

Smarty快速入门

1、Smarty是什么？

Smarty是一个使用PHP写出来的模板引擎，是目前业界最著名的PHP模板引擎之一。它分离了逻辑代码和外在的内容，提供了一种易于管理和使用的方法，用来将原本与HTML代码混杂在一起PHP代码逻辑分离。简单的讲，目的就是要使PHP程序员同前端人员分离，使程序员改变程序的逻辑内容不会影响到前端人员的页面设计，前端人员重新修改页面不会影响到程序的程序逻辑，这在多人合作的项目中显的尤为重要。

2、Smarty下载和目录结构

官网：https://www.smarty.net/

3、实例：第1个Smarty案例

PHP文件代码：

<?php

// 引入Smarty类
include_once('./Smart/libs/Smarty.class.php');

// 实例化Smarty类对象
$smarty = new Smarty();

// 使用Smarty对变量赋值
$smarty->assign('name', '猪八戒');
$smarty->assign('age', 22);

// 引入前端展示文件
$smarty->display('./demo.html');

HTML前端展示页面代码：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    <h1> {$name}今年{$age}岁了！！！</h1>
</body>

</html>

Smarty配置

1、Smarty左右定界符配置

在Smarty中，默认使用 "{" 和 "}"作为变量的定界符。但这样，会与CSS、JS中的大括号冲突。

// Smarty类边界符重新定义
$smarty->left_delimiter = '<{';
$smarty->right_delimiter = '}>';

// 设置Smarty的视图文件根目录
$smarty->setTemplateDir('./view');

2、Smarty常用目录配置

目录类别	默认目录	修改方法	查看方法
Smarty默认模板目录	./templates	$smarty->setTemplateDir()	$smarty->getTemplateDir()
Smarty默认配置目录	./configs	$smarty->setConfigDir()	$smarty->getConfigDir()
Smarty默认编译目录	./templates_c	$smarty->setCompileDir()	$smarty->getCompileDir()
Smarty默认缓存目录	./cache	$smarty->setCacheDir()	$smarty->getCacheDir()
Smarty默认插件目录	./libs/plugins	$smarty->setPluginsDir()	$smarty->getPluginsDir()

查看Smarty常用目录配置：Smarty类文件中的__construct()构造方法

Smarty模板(视图)中的变量

1、Smarty普通变量

PHP中的所有变量，都可以在视图文件中使用；
使用 $smarty->assign() 向Smarty模板传递普通变量；
使用 $smarty->display() 显示指定的视图文件；
在Smarty模板中，使用"[ ]"或点"."来访问数组元素；
在Smarty模板中，使用"->"来访问对象的属性和方法。

PHP文件：

<?php

// 引入Smarty类
include_once('./Smart/libs/Smarty.class.php');

// 实例化Smarty类对象
$smarty = new Smarty();

// 设置Smarty的视图文件根目录
$smarty->setTemplateDir('./view');



// 使用Smarty对变量赋值
$smarty->assign('name', '猪八戒');
$smarty->assign('age', 22);
$smarty->assign('is_married', true);
$smarty->assign('money', 1234.44545);
// 创建一个学生类
class Student
{
    const TITLE = '学生';
}
$stu = new Student;
$smarty->assign('student', $stu);

// 引入前端展示文件
$smarty->display('./demo.html');

HTML文件：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <style>
        body {
            background-color: #fff;
        }
    </style>
</head>

<body>
    <h1>
        {$name}今年 {$age}岁了！！！职业是{$student::TITLE}，工资{$money},婚姻状况为{$is_married}.
    </h1>
</body>

</html>

2、Smarty保留变量

（1）Smarty页面请求保留变量

{smarty.get} 访问_GET数组
{smarty.post} 访问_POST数组
{smarty.request} 访问_REQUEST数组
{smarty.cookie} 访问_COOKIE数组
{smarty.session} 访问_SESSION数组
{smarty.server} 访问_SERVER数组
{smarty.files} 访问_FILES数组

注意：这些变量名为系统定义！

（2）访问PHP的预定义常量

语法：{$smarty.const.预定义常量}

（3）Smarty时间戳保留变量

语法：{$smarty.now}

3、Smarty配置文件变量

（1）配置文件变量概述

网站上有一些比较简单的变量信息，美工人员可以自行定义并调用。这样可以脱离程序员的依赖，工作比较有主动权。

（2）定义配置文件

配置文件默认目录：./configs
设置配置文件目录：$smarty->setConfigDir()
读取配置文件目录：$smarty->getConfigDir()
配置文件扩展名：.ini或.conf
配置文件中注释：#
配置文件变量分组：[ ]
语法格式：配置名 = 变量值
变量不带$符号，变量值不带引号

（3）访问Smarty配置文件变量

载入配置文件：{config_load file = “配置文件路径”}
语法格式一：{#配置文件变量名#}
语法格式二：**{$smarty.config.配置变量}

（4）配置文件分组

载入分组配置文件变量：**{config_load file = “配置文件路径” section = “分组名”}

Smarty循环——foreach

1、foreach语法格式

语法格式1：{foreach arr as key=>
语法格式2：{foreach from=$myarr key="mykey" item="myitem"}{/foreach}
提示：foreach可以遍历所有类型的数组，包括：枚举数组、关联数组、混合数组。

2、实例：输出一维数组

PHP页面：

<?php

// 引入Smarty类
include_once('./Smart/libs/Smarty.class.php');

// 实例化Smarty类对象
$smarty = new Smarty();

// 设置Smarty的视图文件根目录
$smarty->setTemplateDir('./view');

// 创建一个枚举数组
$db_info = array(
    'db_host' => 'localhost',
    'username' => 'root',
    'password' => 'root',
    'db_name' => 'demo'
);

// 使用Smarty对变量赋值
$smarty->assign('db_info', $db_info);

// 引入前端展示文件
$smarty->display('./demo.html');

HTML前端展示页面：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <style>
        body {
            background-color: #fff;
        }
    </style>
</head>

<body>
    <h1>循环输出枚举数组</h1>
    {foreach $db_info as $key=>$value} {$key} {$value};<br> {/foreach}
    <h1>循环输出枚举数组（第二种方式）</h1>
    {foreach from=$db_info key='key' item='value'} {$key} {$value};<br> {/foreach}
</body>

</html>

3、实例：输出二维数组

PHP页面：

<?php

// 引入Smarty类
include_once('./Smart/libs/Smarty.class.php');

// 实例化Smarty类对象
$smarty = new Smarty();

// 设置Smarty的视图文件根目录
$smarty->setTemplateDir('./view');

//创建一个二维数组
$stu_info = array(
    array(10010, '张三', '男', 24, 6000, 300),
    array(10020, '李四', '女', 28, 9000, 200),
    array(10030, '周五', '男', 29, 12000, 340),
    array(10040, '陆六', '女', 26, 9800, 230)
);

// 使用Smarty对变量赋值
$smarty->assign('stu_info', $stu_info);

// 引入前端展示文件
$smarty->display('./demo.html');

HTML前端展示页面：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
    <style>
        body {
            background-color: #fff;
        }
    </style>
</head>

<body>
    <table border="1">
        {foreach $stu_info as $arr}
        <tr>
            {foreach $arr as $value}
            <td>
                {$value}
            </td>
            {/foreach}
        </tr>
        {/foreach}
    </table>
</body>

</html>

4、foreach常用属性应用

@key：输出当前值的索引，可能是整型索引，也可能是字符索引；
@index：当前数组索引，从0开始计算；
@iteration，当前循环的次数，从1开始计算；
@first：当首次循环时，值为true；
@last：当最后一次循环时，值为true；
@total：是整个循环的次数，可以在foreach内部或外部使用。

PHP页面：

<?php

// 引入Smarty类
include_once('./Smart/libs/Smarty.class.php');

// 实例化Smarty类对象
$smarty = new Smarty();

// 设置Smarty的视图文件根目录
$smarty->setTemplateDir('./view');

// 创建一个枚举数组
$db_info = array(
    'db_host' => 'localhost',
    'username' => 'root',
    'password' => 'root',
    'db_name' => 'demo'
);

// 使用Smarty对变量赋值
$smarty->assign('db_info', $db_info);

// 引入前端展示文件
$smarty->display('./demo.html');

HTML前端展示页面：

<!DOCTYPE html>
<html>

<head>
    <meta charset="utf-8">
    <title>Smarty模板引擎</title>
    <style type="text/css">
        body {
            background-color: #99ff00;
        }
    </style>
</head>

<body>

    <table border="1">
        {foreach $db_info as $value} {if $value@first}
        <tr>
            <th>值</th>
            <th>索引</th>
            <th>从0开始计数</th>
            <th>从1开始计数</th>
            <th>是否为第1次循环</th>
            <th>是否为最后1次循环</th>
            <th>循环总次数</th>
        </tr>
        {/if}
        <tr>
            <td>
                {$value}
            </td>
            <td>
                {$value@key}
            </td>
            <td>
                {$value@index}
            </td>
            <td>
                {$value@iteration}
            </td>
            <td>
                {$value@first}
            </td>
            <td>
                {$value@last}
            </td>
            <td>
                {if $value@last} {$value@total} {/if}
            </td>
        </tr>
        {/foreach}
    </table>

浏览器渲染结果

Smarty循环——section循环

1、section语法格式

Section循环就是PHP中的for循环。
PHP中的for循环对于foreach来说，有什么特点？
for循环可以控制循环起点，而foreach不可以；如：i = 1 或 i = 3
for循环可以指定步长值，而foreach不可以；如：i += 2 或 i += 3
for循环可以控制循环次数，而foreach不可以；如：count = 10 或 count = 5
**注意：section循环只能遍历枚举数组。

name= 随便命名

loop= 最后一个循还号

start= 起点

step= 跳的值的个数

max= 最大输出几个值

show=

2、实例：输出一维枚举数组

PHP页面：

<?php

// 引入Smarty类
include_once('./Smart/libs/Smarty.class.php');

// 实例化Smarty类对象
$smarty = new Smarty();

// 设置Smarty的视图文件根目录
$smarty->setTemplateDir('./view');

// 创建一个枚举数组
$stu_info = array(10010, '张三', '男', 24, 6000, 300);

// 使用Smarty对变量赋值
$smarty->assign('stu_info', $stu_info);

// 引入前端展示文件
$smarty->display('./demo.html');

HTML前端展示页面：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    {section name='i' loop=$stu_info} {$stu_info[i]} {/section}
</body>

</html>

3、实例：输出二维枚举数组

PHP页面：

<?php

// 引入Smarty类
include_once('./Smart/libs/Smarty.class.php');

// 实例化Smarty类对象
$smarty = new Smarty();

// 设置Smarty的视图文件根目录
$smarty->setTemplateDir('./view');

//创建一个二维数组
$stu_info = array(
    array(10010, '张三', '男', 24, 6000, 300),
    array(10020, '李四', '女', 28, 9000, 200),
    array(10030, '周五', '男', 29, 12000, 340),
    array(10040, '陆六', '女', 26, 9800, 230)
);

// 使用Smarty对变量赋值
$smarty->assign('stu_info', $stu_info);

// 引入前端展示文件
$smarty->display('./demo.html');

HTML前端展示页面：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    {section name='i' loop=$stu_info}
        {section name='k' loop=$stu_info[i]}
            {$stu_info[i][k]}
        {/section}
    {/section}
</body>

</html>

4、section控制循环起点、步长值

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Document</title>
</head>

<body>
    {section name='i' loop=$stu_info start=2 step=2 max=4}
        {section name='k' loop=$stu_info[i]}
            {$stu_info[i][k]}
        {/section}
    {/section}
</body>

</html>

Smarty条件判断——if语句

1、if中运算符

	meaning	translate	example
eq	equal	相等	{if count eq 1}{/if}
ne / neq	not equal	不相等	{if count ne 0 && name eq "lucy"}{/if}
gt	greater than	大于	{if count gt 1}{/if}
lt	less than	小于	{if count lt 10}{/if}
gte / ge	great than or equal	大于等于	{if count ge 1}{/if}
let / le	less than or equal	小于等于	{if count le 10}{/if}
mod	module	求模	{if count eq 1}{/if}
not	not	非
X is [not] div by Y	divisible	整除	{if count is div by 20}{/if}
X is [not] even	even	X [不] 是偶数	{if count1 is even}{/if}
X is [not] even by Y	even	(X/Y)%2 (!=) == 0	{if count1 is even by count2}{/if}
X is [not] odd	odd number	X [不] 是奇数	{if count2 is odd}{/if}
X is [not] odd by Y	odd number	(X/Y)%2 (==) != 0	{if count1 is odd by count2}{/if}

2、实例：当兵年龄判断

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Smarty模板引擎</title>
<style type="text/css">
body{background-color: #99ff00;}
</style>
</head>
<body>

<h2>判断当兵的年龄</h2>
<{if $smarty.get.age gte 18 and $smarty.get.age lte 23}>
<font color='blue'>你符合当兵的年龄要求！</font>
<{else}>
<font color='red'>你干嘛干嘛去！</font>
<{/if}>

3、实例：表格隔行变色

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>Smarty模板引擎</title>
</head>
<body>

<h2>表格隔行变色</h2>
<table border="1" width="500">
    <tr bgcolor=#f0f0f0>
        <th>编号</th>
        <th>新闻标题</th>
        <th>发布时间</th>
    </tr>
    <{foreach $arr as $value}>
    <{if $value@iteration is div by 3}>
    <tr bgcolor='#99ff00'>
    <{else}>
    <tr>
    <{/if}>
        <td>&nbsp;</td>
        <td>&nbsp;</td>
        <td>&nbsp;</td>
    </tr>
    <{/foreach}>
</table>

Smarty变量调节器

1、Smarty变量调节器概述

变量修饰器可以用于格式化变量；
使用修饰器，需要在变量的后面加上|(竖线)并且跟着修饰器名称。
修饰器可能还会有附加的参数以便达到效果。
参数会跟着修饰器名称，用:(冒号)分开。
同时，默认全部PHP函数都可以作为修饰器来使用(不止下面的)，而且修饰器可以被联合使用。
修饰器可以作用于任何类型的变量，数组或者对象。

举例

2、Smarty中常用变量调节器

调节器	含义	PHP函数	示例演示
upper	将变量值转成大写字母。	strtoupper()	{$title\	upper}
lower	将变量值转成小写字母	strtolower()	{$title\	lower}
capitalize	每个单词的第一个字母大写	ucwords()	{$title\	capitalize}
nl2br	将变量中"\n"回车全部转换成HTML的 <br />	nl2br()	{$title\	nl2br}
replace	对变量进行简单的查找和替换	str_replace()	{$title\	replace:’a’:’b’}
date_format	将日期和时间格式化成strftime()的格式。	strftime()	{$time\	date_format:%Y-%m-%d}
truncate	截取字符串到指定长度，默认长度是80	substr()	{$title\	truncate:80:’…’}

3、date_format调节器参数及应用

4、truncate调节器参数及应用

smarty中的truncate调节器，对应PHP的substr()函数或mb_substr()函数。
substr()函数是按字节截取字符串；
mb_substr()函数是按字符截取字符串，但需要开启PHP的扩展。

----- END -----

本文参与腾讯云自媒体同步曝光计划，分享自作者个人站点/博客。

原始发表：2018-08-24，如有侵权请联系 cloudcommunity@tencent.com 删除

smarty

本文分享自作者个人站点/博客前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度