文件下载
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
群成员有限,先到先得会员资格,请认真填写验证消息
资源都在这里,你还在到处闲逛什么呢?
大神都在这里,你还在到处闲逛什么呢?
*************************************************************