Smarty模板快速入门
文件下载
1、下载地址：http://www.smarty.net/
2、我下载的版本是3.1.27 ，将下载的文件smarty-3.1.27.zip解压出来，然后将libs文件夹的所有文件复制到你的项目中（可重新命名libs文件夹名称）
3、目录结构，如下图
4、本文相关实例完整代码下载：下载地址
Smarty相关配置
1、配置代码
//获取硬路径
define('ROOT_PATH', dirname(__FILE__).'/');
//引入smarty核心类文件
require ROOT_PATH.'smarty/Smarty.class.php';
//自定义模板文件目录，此时是将Smarty默认路径重写了一遍
$_smarty->template_dir = './templates/';
//编译文件目录
$_smarty->compile_dir = './templates_c/';
//配置变量目录
$_smarty->config_dir = './configs/';
//缓存目录
$_smarty->cache_dir = './cache/';
//是否开启缓存，开发阶段，要关闭缓存，1/true表示开启缓存
$_smarty->caching = 1;
//缓存的时间,默认是1小时
$_smarty->cache_lifetime = 60*60*24;
//左定界符，{}是Smarty默认的左右定界符
$_smarty->left_delimiter = '{';
//右定界符
$_smarty->right_delimiter = '}';
2、配置说明
（1）在项目下面要提前新建几个文件夹：templates（放模板文件，如：index.tpl）、templates_c（放编译文件，如、debef1afdc8f3ca548e8845c5d6c8dc1a075b2d5_0.file.index.tpl.php）、configs（放配置文件，如：config.conf）、cache（放缓存文件，如：debef1afdc8f3ca548e8845c5d6c8dc1a075b2d5.index.tpl.php）。其中templates_c和cache文件夹会自动生成，其相应的编译文件和缓存文件也会自动生成。config目录下的配置文件的后缀可以随便定义，为了容易识别一般定义为.conf
（2）左右定界符定义成{ }后，.tpl文件里面就不能像html文件里面那样写JS和CSS代码（符号冲突）。解决办法：可以将定界符定义成其他字符或字符串，还可以将{ }用Smarty的内置函数打印出来，不过常用的方法是将JS、CSS代码和HTML代码（.tpl文件中）分离。
（3）.tpl文件类似于HTML文件，不同的是按照smarty语法可以解析里面的一些变量。.conf配置文件的书写格式是：键=值 （每一行表示一个键值对，键、值都不需要引号）
Smarty解析变量
实例代码：
smarty.inc.php（下面的实例也会用到）
<?php
//获取硬路径
define('ROOT_PATH', dirname(__FILE__).'/');
//引入smarty核心类文件
require ROOT_PATH.'smarty/Smarty.class.php';
//实例化Smarty对象
$_smarty = new Smarty();
//自定义模板文件目录，此时是将Smarty默认路径重写了一遍
$_smarty->template_dir = './templates/';
//编译文件目录
$_smarty->compile_dir = './templates_c/';
//配置变量目录
$_smarty->config_dir = './configs/';
//缓存目录
$_smarty->cache_dir = './cache/';
//是否开启缓存，开发阶段，要关闭缓存，1/true表示开启缓存
$_smarty->caching = 1;
//缓存的时间,默认是1小时
$_smarty->cache_lifetime = 60*60*24;
//左定界符，{}是Smarty默认的左右定界符
$_smarty->left_delimiter = '{';
//右定界符
$_smarty->right_delimiter = '}';
?>
config.conf（下面的实例也会用到）
site=小易blog url=http://blog.csdn.net/oldinaction
index.php
<?php
//导入smarty配置文件
require 'smarty.inc.php';
$_title = 'Smarty模板引擎';
$_array1 = array('1', '2', '3');
$_array2 = array('1'=>'一', '2'=>'二', '3'=>'三');
Class Smalle {
public $site = 'AEZO';
public function url(){
return 'http://www.aezo.cn';
}
}
define('SMALLE', '微信号：smallelife');
//分配普通变量，第一个参数是Smarty模板引擎变量，第二个参数是PHP变量
$_smarty->assign('title', $_title);
$_smarty->assign('a', 1);
$_smarty->assign('b', 2);
//分配数组变量
$_smarty->assign('array1', $_array1);
$_smarty->assign('array2', $_array2);
//分配对象变量
$_smarty->assign('smalle', new Smalle());
//引入模板
$_smarty->display('index.tpl');
?>
index.tpl
{config_load file='config.conf'} {*注释：此时文件目录不需config这一层，因smarty.inc.php已经定义了配置文件目录*}
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>{$title}</title>
</head>
<body>
数组变量显示结果：<br />
{$array1[1]}<br />
{$array2.1}<br />
----------------------<br />
对象变量显示结果：<br />
{$smalle->site}<br />
{$smalle->url()}<br />
----------------------<br />
模板中可进行计算：<br />
{$a+$b}<br />
----------------------<br />
Smarty保留变量：<br />
{*注释：保留的$smarty.const变量专门针对常量，这样就不需要将常量像变量一样分配了*}
{$smarty.const.SMALLE}<br />
----------------------<br />
config目录下的配置文件中的键值对：<br />
{*注释：下面两种表示方法都可以*}
{$smarty.config.site}<br />
{#url#}<br />
----------------------<br />
</body>
</html>
效果展示：
在浏览器访问 http://127.0.0.1/smarty/index.php 效果如下
Smarty自定义函数
此处说的自定义函数主要包括Smarty提供的自定义函数和开发者自己写的函数称为自定义函数。开发者以插件的形式自定义的函数，文件要放在Smarty核心文件的plugins目录下。
function.smfunc.php 自定义函数文件，放在plugins目录下
<?php
/**
* Smalle 以插件的形式自定义的函数
* 注意：
* 1、文件格式为function.xxx.php
* 2、函数名为smarty_function_xxx($params){}
* 3、使用：{smfunc a=1 b=2} a、b参数和其值会以关联数组的形式传给此函数的第一个参数
*/
function smarty_function_smfunc($_arr){
$_cout = $_arr['a'] + $_arr['b'];
return $_cout;
}
?>
func.php
<?php
//导入smarty配置文件
require 'smarty.inc.php';
$_smarty->assign('array', array('a'=>'一','b'=>'二','c'=>'三'));
//引入模板
$_smarty->display('func.tpl');
?>
func.tpl
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>自定义函数</title>
</head>
<body>
Smarty的自定义函数举例：<br />
{html_checkboxes options=$array selected=b}<br />
----------------------<br />
开发者以插件的形式自定义的函数举例：<br />
{smfunc a=1 b=2}<br />
----------------------<br />
</body>
</html>
效果展示：
Smarty内置函数
builtFunc.php
<?php
//导入smarty配置文件
require 'smarty.inc.php';
/**
* {insert}内置函数中调用的即为此处的函数
* 注意：
* 1、函数命名：insert_xxx (xxx指{insert}内置函数中name的值)
* 2、{insert}内置函数中的参数会以数组的形式传递给此函数
*/
function insert_getConfig($_arr){
return $_arr['site'].'：'.$_arr['url'];
}
$_smarty->assign('arr',array('a'=>'一','b'=>'二','c'=>'三'));
//引入模板
$_smarty->display('builtFunc.tpl');
?>
builtFunc.tpl
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>内置函数</title>
</head>
<body>
内置函数举例1：<br />
----------------------示例1<br />
{assign var="flag" value=false}
{assign var="i" value=1}
{if $flag}
0
{elseif $i == 2}
2
{else $i < 2}
1
{/if}
<br /><br />
----------------------示例2<br />
{foreach $arr as $item}
{$item@key}=>{$item}
{/foreach}<br />
一共循环了{$item@total}次<br />
{foreach $arr as $key=>$value}
{$key}=>{$value}
{/foreach}<br /><br />
----------------------示例3<br />
{for $var=1 to 10}
{$var}
{/for}<br />
{for $var=2 to 10 step 2}
{$var}
{/for}<br />
{for $var=2 to 10 max=3}
{$var}
{/for}<br /><br /><br />
内置函数举例2：<br />
----------------------示例4（显示左右定界符）<br />
{ldelim} {rdelim}<br /><br />
----------------------示例5（literal显示代码块）<br />
{literal}
function(){
alert(1);
}
{/literal}<br /><br />
----------------------示例6<br />
{assign var="name" value="smalle"}
{$name}<br /><br />
-->{ldelim}config_load file="example.conf"{rdelim}用来从配置文件中加载config变量到模版<br />
使用 $smarty.config.键 或者 #键# 获取<br /><br />
-->{ldelim}strip{rdelim}{ldelim}/strip{rdelim}压缩源代码，去掉空格和换行
----------------------示例7<br />
{strip}
<table border=0>
<tr>
<td>
<font color="red">This is a test</font>
</td>
</tr>
</table>
{/strip}<br />
-->{ldelim}insert name="insertName"{rdelim}插入函数。所包含的内容不会被缓存，每次调用模板都会执行<br />
----------------------示例8<br />
{config_load file="config.conf"}
{insert name="getConfig" site=#site# url=#url#}<br />
</body>
</html>
效果展示：
Smarty变量调节器
同自定义函数一样，开发者也可以以插件的形式自定义变量调节器，当然Smarty也提供了一些变量调节器。自定义的插件文件也要放在plugins目录下。
modifier_smtruncate.php（放在plugins目录下）
<?php
/**
* Smalle 自定义变量调节器（截取字符串）
* 注意：
* 1、文件命名格式：modifier.xxx.php
* 2、函数的命名格式：smarty_modifier_xxx($params){}
* 3、使用：{$str|smtruncate:0:20:'utf-8':'###'} $str是注入进来的变量，会传给函数的第一个参数
*/
function smarty_modifier_smtruncate($_str, $_length, $_start=0, $_encoding='utf-8', $_endStr='...'){
if(mb_strlen($_str) > $_length){
return mb_substr($_str, $_start, $_length, $_encoding);
} else {
return mb_substr($_str, $_start, $_length, $_encoding).$_endStr;
}
}
?>
mvar.php
<?php
//导入smarty配置文件
require 'smarty.inc.php';
$_url = 'http://www.aezo.cn/tag=<strong>小易你好啊</strong>';
$_smarty->assign('url', $_url);
//引入模板
$_smarty->display('mvar.tpl');
?>
mvar.tpl
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>变量调节器</title>
</head>
<body>
Smarty的变量调节器举例<br />
--regex_replace[正则替换]<br />
{$url|regex_replace:"/http/":"https"}<br /><br />
--strip_tags[去除html标签],参数false指标签不用空格替换<br />
{$url|strip_tags:false}<br /><br />
--组合变量调节器<br />
{$url|regex_replace:"/http/":"https"|strip_tags:false}<br />
----------------------<br /><br />
开发者以插件的形式自定义的变量调节器举例：<br />
{$url|smtruncate:33}<br />
----------------------<br />
</body>
</html>
效果展示：
Smarty缓存机制
要先开启缓存（$_smarty->caching = 1;），下面的功能才能实现
cache.php
<?php
//设置时区
date_default_timezone_set('Asia/Shanghai');
//导入smarty配置文件
require 'smarty.inc.php';
//多重缓存，访问 http://127.0.0.1/smarty/cache.php?id=1&page=1 改变参数的值
$_id = @$_GET['id'];
//部分片段不缓存
function smarty_block_nocache($param, $content, $smarty) {
return $content;
}
//注册插件
$_smarty->registerPlugin('block','nocache', 'smarty_block_nocache', false);
//清除所有缓存
//$_smarty->clearAllCache();
//引入模板,多重缓存时要加上第二个参数（可以有多个参数）
//$_smarty->display('cache.tpl', $_id);//多重缓存时也可以将URL中的参数全部传给后面的参数
$_smarty->display('cache.tpl', $_SERVER["REQUEST_URI"]);
?>
cache.tpl
<!doctype html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>缓存机制</title>
</head>
<body>
Smarty的的多重缓时存获取参数：<br />
{$id}
<br />
----------------------<br />
开启缓存后，让部分代码不缓存（利用自定义函数）：<br />
{'0'|date_format:'%Y-%m-%d %H:%M:%S'}<br />
{nocache}
{'0'|date_format:'%Y-%m-%d %H:%M:%S'}
{/nocache}<br />
----------------------<br />
</body>
</html>
效果展示：
如果访问http://127.0.0.1/smarty/cache.php?id=1&page=1，则会自动生成如_smarty_cache_php_id_1_page_1^de087441c95bd03a91d833c6b344eb35bda77af9.cache.tpl.php的缓存文件。
相信大家掌握了这些，基本就可以在项目中使用Smarty了，更深入的研究就留给你们自己吧！
*************************************************************
PHP开发交流QQ群：127255239 验证消息：smcsdn
群成员有限，先到先得会员资格，请认真填写验证消息
资源都在这里，你还在到处闲逛什么呢？
大神都在这里，你还在到处闲逛什么呢？
*************************************************************
