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

群成员有限，先到先得会员资格，请认真填写验证消息

资源都在这里，你还在到处闲逛什么呢？

大神都在这里，你还在到处闲逛什么呢？

*************************************************************