Smarty模板引擎技术二 - 尼农小道

Smarty模板引擎技术

1. 内建函数

1. include_php内建函数

作用：载入一个php文件，将载入的文件的内容赋值给一个变量

 

注意：该内建函数只能在2.0中使用，如果使用的话，必须得实例化SmartyBC.class.php

 

示例代码：

Index.php

include 'Smarty/SmartyBC.class.php';
//实例化Smarty类
$Smarty = new SmartyBC();
$Smarty->assign('name','小明');
$Smarty->display('index.tpl');

index.tpl

<code><span style="color:#e54242; font-size:10pt"><strong><em><span style="font-family:Consolas">{*<span style="color:yellow">include_php</span></span>内建函数<span style="font-family:Consolas">*}<br></span></em><span style="color:#b8c21c">{<span style="color:#ca9e4d; font-family:Consolas">include_php <span style="color:#b8c21c">file=<span style="color:#34b434">"date.php" <span style="color:#b8c21c">assign=<span style="color:#34b434">"date"<span style="color:#b8c21c">}<br>{<span style="color:#ca9e4d">$<span style="color:#b8c21c">date}</span></span></span></span></span></span></span></span></span></strong>
				</span></code>

 

1. insert内建函数

作用：当Smarty内置的功能不够使用时，可以通过insert内建函数拓展功能。

 

基本语法：index.php文件中创建一个

insert_自定义函数名($arg){

        echo $arg[模板中定义的变量]    

}

Index.tpl文件

{insert name=自定义函数名称 自定义参数… }

示例代码：

Index.php

function insert_func($arg){
echo $arg['title'];
}
function insert_date($arg){
echo $arg['say']."今天天气好棒的说，现在的时间是".date('Y-m-d H:i:s',time());
echo '
';
echo $arg['zhangsan']."今天天气好棒的说，现在的时间是".date('Y-m-d H:i:s',time());
}

index.tpl模板

{insert name="func" title='PHP是世界上最好的语言'}
hr>
{insert name="date" say='老王说:' zhangsan='哈哈哈：'}

 

 

 

 

 

1. if elseif else内建函数

示例代码：

{if $age >= 18}
此人非未成年
{elseif $age == '14'}
此人14岁
{else}
此人是未成年
{/if}

 

 

1. ldelim或rdelim内建函数

示例代码：

b>在Smarty中我们使用{ldelim}if{rdelim}进行条件判断b>

1. literal内建函数

作用：在该标签中的任何内容都不会受Smarty模板引擎解析

示例代码：

{literal}
{*嗨，我是一个注释*}
{assign var='age' value="14"}
{/literal}

运行效果：

 

1. php内建函数

作用：在该标签中可以使用原生的PHP代码。

示例代码：

{*PHP内建函数*}
{php}
echo date('Y-m-d h:i:s',time());
echo 'br>';
echo "我在php内建函数中的内容";
{/php}

运行效果：

 

7、strip内建函数

作用：去除空格符和换行符

示例代码：

{strip}
table>
tr>
td>1td>
td>2td>
td>3td>
td>4td>
td>5td>
tr>
table>
{/strip}

使用前：

 

 

 

 

 

 

使用后：

8、section、sectionelse内建函数(二维数组，)

作用：遍历数组

基本用法：

{section loop=$arr name="index"}
{$arr[index]}
br>
{/section}

参数详解：loop 要遍历数组

         Name 当前循环的索引

拓展使用1：使用start step max

{section loop=$arr1 name="index" start="0" step="1" max="5"}
{$arr1[index]}
br>
{/section}

• 参数详解：start    循环的起始索引

         Step    每次循环增加的数量

         Max 最大的循环次数

拓展使用2：sectionelse

作用：判断循环的数组是否为空，如果为空的话，则执行后面的内容。

实例代码：

{*section内建函数*}
{section loop=$arr1 name="index" start="0" step="1" max="5"}
{$arr1[index]}
br>
{sectionelse}
b>):没有数组或者数组为空b>
{/section}

• 遍历二维数组

实例代码：

Index.php

$arr3 = array(array('name'=>'小明','age'=>25,'sex'=>'未知'),
array('name'=>'老王','age'=>26,'sex'=>'男'),
array('name'=>'老李','age'=>27,'sex'=>'你猜')
);

Index.tpl

{section loop=$arr3 name="index" }
{$arr3[index]['name']} |
{$arr3[index]['age']} |
{$arr3[index]['sex']} |
hr/>
{/section}

运行效果：

 

拓展内容：

 

<code><span style="color:#2eb11a; font-size:10pt"><strong>当前索引： <span style="color:#b8c21c"><span style="font-family:Consolas">{<span style="color:#ca9e4d">$<span style="color:#b8c21c">smarty.section.index.index} <span style="color:#2eb11a">->><br></span></span></span></span>当前索引的前一个：<span style="font-family:Consolas">{<span style="color:#ca9e4d">$<span style="color:#b8c21c">smarty.section.index.index_prev}<span style="color:#2eb11a">->><br></span></span></span></span>当前索引的下一个：<span style="font-family:Consolas">{<span style="color:#ca9e4d">$<span style="color:#b8c21c">smarty.section.index.index_next}<span style="color:#2eb11a">->><br></span></span></span></span>当前所循环的次数<span style="color:#2eb11a">
								<span style="color:#b8c21c"><span style="font-family:Consolas">{<span style="color:#ca9e4d">$<span style="color:#b8c21c">smarty.section.index.iteration}<span style="color:#2eb11a">->><br></span></span></span></span>判断当前是否第一次<span style="color:#2eb11a"><span style="font-family:Consolas">: <span style="color:#b8c21c">{<span style="color:#ca9e4d">$<span style="color:#b8c21c">smarty.section.index.first}<span style="color:#2eb11a">->><br></span></span></span></span></span>判断当前是否最后一次：<span style="color:#b8c21c; font-family:Consolas">{<span style="color:#ca9e4d">$<span style="color:#b8c21c">smarty.section.index.last}<span style="color:#2eb11a">->>
</span></span></span></span></span></span></span></span></strong></span></code>

循环的总次数：{$smarty.section.index.total}->>

 

运行效果：

1. 自定义函数

1. counter计数器

示例代码：

{counter start='10' }
hr>
{counter}
hr>
{counter print=false}
hr>
{counter skip=2}
hr>
{counter}
hr>

运行效果：

1. cycle轮换函数

基本语法：{cycle values=参数1,参数2,参数3}

 

示例代码：

{*cycle实现各行换色*}
hr>
table width="100%">
tr style="background-color: {cycle values="red,green,yellow"}">
td>我的第{counter start='1' skip='1'}次循环td>
tr>
tr style="background-color: {cycle values="red,green,yellow"}">
td>我的第{counter}次循环td>
tr>
tr style="background-color: {cycle values="red,green,yellow"}">
td>我的第{counter}次循环td>
tr>
tr style="background-color: {cycle values="red,green,yellow"}">
td>我的第{counter}次循环td>
tr>
tr style="background-color: {cycle values="red,green,yellow"}">
td>我的第{counter}次循环td>
tr>
tr style="background-color: {cycle values="red,green,yellow"}">
td>我的第{counter}次循环td>
tr>
table>

 

1. debug调试函数

{debug}

运行效果：

1. fetch函数

作用：捕获一个文件的内容，然后赋值给一个变量

示例代码：

{fetch file="shi.txt" assign="text"}
{fetch file="date.php" assign="php"}
{*变量调节器
{$text|变量调节器名称:参数1:参数2}
*}
{$php}
hr>
{$text|nl2br}

运行效果：

1. html_image自定义函数

<code><span style="color:#b8c21c; font-family:Consolas; font-size:10pt"><strong>{<span style="color:#ca9e4d">html_image <span style="color:#b8c21c">file=<span style="color:#34b434">"1.jpg"<span style="color:#b8c21c">}</span></span></span></span></strong>
				</span></code>

 

参数：file    图片资源的路径

运行效果：

 

1. html_table自定义函数

作用:生成一个表格，将数据遍历进去

示例代码：

{html_table loop=$arr cols="3"}

参数说明：loop    要循环遍历的数组

     Cols    指定表格列数

1. html_checkboxes自定义函数

作用：生成一组多选框

示例代码：

{html_checkboxes name = 'job'
values = $arr
checked = $arr2
output = $arr3
separator = "|"
}

参数说明： name        对应多选框中的name属性

         Values    对应多选框中你的value属性

Checked    选中指定的多选框

         Output    控制文本内容

         Separator 连接符

运行效果：

{待补充}

1. html_options自定义函数

示例代码：

<code><span style="color:#c2c256; font-family:Consolas; font-size:10pt"><strong>select <span style="color:#ded772">style=<span style="color:#2bba2b">"<span style="color:#b8c21c">width: <span style="color:#f971bb">100<span style="color:#b8c21c">%;<span style="color:#2bba2b">"<span style="color:#c2c256">><br>
														<span style="color:#b8c21c">{<span style="color:#ca9e4d">html_options <span style="color:#b8c21c">values    =   <span style="color:#ca9e4d">$<span style="color:#b8c21c">arr<br>                  selected  =   <span style="color:#34b434">'GO'<br>
																				<span style="color:#b8c21c">output    =   <span style="color:#ca9e4d">$<span style="color:#b8c21c">arr3<br>    }<br><span style="color:#c2c256"><span style="color:#00b109">select<span style="color:#c2c256">></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></span></strong></span><span style="color:#b8c21c">
					</span></code>

参数说明：values         下拉框选项的值

     Selected    指定被选中的下拉选项，注意：必须和value的值对应

         Output    输出的文本

9、html_radios自定义函数

示例代码：

<code><span style="color:#b8c21c; font-family:Consolas; font-size:10pt"><strong>{<span style="color:#ca9e4d">html_radios <span style="color:#b8c21c">values     =   <span style="color:#ca9e4d">$<span style="color:#b8c21c">arr<br>             checked    =   <span style="color:#34b434">'nodejs'<br>
											<span style="color:#b8c21c">output     =   <span style="color:#ca9e4d">$<span style="color:#b8c21c">arr3<br>             separator  =   <span style="color:#34b434">"|"<br><span style="color:#b8c21c">}</span></span></span></span></span></span></span></span></span></span></strong>
				</span></code>

 

参数说明：values    单选框的值

         Checked    指定默认被选中的单选框

         Output    输出的文本

         Separator    连接符

运行效果：

{待补充}

1. 综合应用

实例代码：

{section loop=$arr4 name="index" }
{html_image file="./img/{$arr4[index]}.jpg"}
hr>
{/section}

 

1. 程序篇

1. 常量

SMARTY_DIR

1. 变量

• $template_dir        模板目录    默认是：templates
• $compile_dir        编译目录    默认是：templates_c
• $config_dir        配置目录    默认：configs
• $cache_dir        缓存目录    默认:cache
• $left_delimiter    左定界符    默认：{
• $right_delimiter    右定界符    默认：}

 

以上变量都有默认行为。

• $caching            是否开启缓存
• $cache_lifetime    缓存的生命周期:默认3600s
• $debugging        开启调试模板
• $php_handling    是否允许在模板中引入php

3、常用方法

• assign 向模板中传递变量
• assignByRef    分配变量到模板文件（按引用传递）
• append         追加变量

$Smarty->append('var1','小明');
$Smarty->append('var1','25');
$Smarty->append('var1','男');

• appendByRef追加不同的数据到模板的数组变量中（按引用传递）
• clearAllAssign     清除模板中所有变量

$Smarty->clearAllAssign(); //清除所有模板变量

• clearAssign 清除指定的变量

$Smarty->clearAssign('title');

• clearCache     清除缓存
• configLoad     配置加载

$Smarty->configLoad('config.conf','class2');

• clearConfig    清除配置内容

$Smarty->clearConfig('name');

• display        指定渲染模板

$Smarty->display('index_3.tpl');

加载模板文件

渲染模板

显示模板

• fetch        捕获模板但是不输出

 

加载模板文件

渲染（将标签替换为php代码）模板文件

我们可以通过fetch实现静态技术。

Index_3.php文件

/*
* 如果有静态文件则加载静态文件，如果没有静态生成一个静态文件。
* */
if(!is_file('./html/index_3.html')){
$html = $Smarty->fetch('index_3.tpl');
file_put_contents('./html/index_3.html',$html);
echo '这里是没有静态文件';
include "./html/index_3.html";
}else{
echo '这里是有静态文件';
include "./html/index_3.html";
}

[待补充]

• templateExists 判断模板文件是否存在    

if($Smarty->templateExists('index_4.tpl')){
$Smarty->display('index_3.tpl');
}else{
echo '矮油，模板文件不在哦~';
}

 

 

补充：如何在smarty模板中读取数组，对象。

 

• 在模板中获取数组内容：

{*多维数组*}
{$var[0]['name']}
{*一位数组*}
{$var['name']}

• 在模板中获取对象内容

{*获取对象属性*}
{$std->name}
hr>
{*获取对方法*}
{$person->speak()}

Index3.php文件

$std = new StdClass();
class person{
function __construct(){}
function speak(){
echo '你猜猜我谁?';
}
}
$person = new person();
$std->name = '张二明';

 

 

1. Smarty模板中的缓存技术

1. 什么是缓存技术

概念：一般在我们项目中，有一部分数据并不是实时更新的，但是，有又必须实时访问。如果不使用缓存技术的话，每访问一次，得查询一次或者多次数据库，那么会给数据造成很高的I/O开销。会增加服务器的压力。

1. Smarty缓存原理图

用户端缓存原理：

 

服务器缓存原理：

 

1. 缓存的开启

//开启缓存
$Smarty->caching = true;

//设置缓存文件的生命周期
$Smarty->cache_lifetime = '7200';

1. 缓存文件从何而来？

缓存文件由编译文件而来。

 

1. 缓存文件何时变化？

编译文的内容何时变化？

1. 当模板文件被修改时会发生变化
2. 当缓存不在声明周期内会发生变化（重新生成新缓存文件）

 

思路：设置一个生命周期只有30秒的缓存文件，定义一个变量，在模板中使用该变量。然后打开index.php.

然后修改该变量的值。等待。。。30

1. Smarty执行原理图（缓存版）

Smarty缓存相关细节

1. 缓存检测

<code><span style="color:#4b8590; font-family:Consolas; font-size:10pt"><strong>$Smarty<span style="color:#b8c21c">->isCached(<span style="color:#34b434">'index_4.tpl'<span style="color:#b8c21c">)</span></span></span></strong>
				</span></code>

• 基本语法：isCached(templatesName); 检测模板文件的缓村文件是否存在
• 参数说明：模板文件名称

1. 清除缓存

<code><span style="color:#e54242; font-size:10pt"><span style="font-family:Consolas"><strong><em>//</em></strong></span><span style="color:yellow"><strong><em>清除所有缓存<br><span style="color:#e54242"><span style="font-family:Consolas">$<span style="color:yellow">Smarty->clearAllCache();<br><span style="color:#e54242">//</span></span></span><span style="color:yellow">清楚某模板缓存文件<br></span></span></em><span style="color:#4b8590; font-family:Consolas">$Smarty<span style="color:#b8c21c">->clearCache(<span style="color:#34b434">'index_4.tpl'<span style="color:#b8c21c">);</span></span></span></span></strong>
					</span></span></code>

 

1. 局部缓存

在Smarty的缓村是全局缓存，如果开启缓存，访问整个页面的数据都会被缓存，如果页面中有一些动态数据需要修改，如何处理？

如何处理页面中动态显示的数据部分呢？

1. 通过给assign(模板变量名称,值,设置不缓存)设置不缓存

<code><span style="color:#4b8590; font-size:10pt"><strong><span style="font-family:Consolas">$Smarty<span style="color:#b8c21c">->assign(<span style="color:#34b434">'shige'<span style="color:#b8c21c">,<span style="color:#34b434">'</span></span></span></span></span>《再别康桥》<span style="color:#34b434; font-family:Consolas">'<span style="color:#b8c21c">,<span style="color:#2eb11a">true<span style="color:#b8c21c">);</span></span></span></span></strong>
				</span></code>

1. 在模板文件中通过{nocache}{/nocache}方式设置变量不被缓存

<code><span style="color:#b8c21c; font-family:Consolas; font-size:10pt"><strong>{<span style="color:#ca9e4d">nocache<span style="color:#b8c21c">}<br>    {<span style="color:#ca9e4d">$<span style="color:#b8c21c">title}<br>{/<span style="color:#ca9e4d">nocache<span style="color:#b8c21c">}</span></span></span></span></span></span></strong>
				</span></code>

1. 单页面多缓存

如何解决一个模板文件，动态显示不同的内容。

实际场景：譬如一个电商网站的商品详细页，会动态的根据URL上的参数，改变该页面的内容。

那么这种情况如何实现缓存呢？

http://localhost:63354/Smarty/Smarty02/index5.php?goods_id=1

http://localhost:63354/Smarty/Smarty02/index5.php?goods_id=2

http://localhost:63354/Smarty/Smarty02/index5.php?goods_id=3

http://localhost:63354/Smarty/Smarty02/index5.php?goods_id=250

 

在Smarty中，我们通过设置display()第二个参数，来实现，单页面，多缓存。

11、缓存集合

http://localhost:63354/Smarty/Smarty02/index5.php?goods_id=1&cate_id=15

http://localhost:63354/Smarty/Smarty02/index5.php?goods_id=1&cate_id=15

http://localhost:63354/Smarty/Smarty02/index5.php?goods_id=1&cate_id=15