走过平凡人生、留下平凡足迹 注册 | 登陆

smarty模板实例教程

Submitted by aming on 2008, March 21, 4:58 PM. Smarty

<?php
/*********************************************
*
* 文件名： index.php
* 作 用： 显示实例程序
*
* 作 者： 大师兄
* Email： teacherli@163.com
*
*********************************************/
include_once("./comm/smarty.class.php"); //包含smarty类文件

$smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->template_dir = "./templates";//设置模板目录
$smarty->compile_dir = "./templates_c"; //设置编译目录

//----------------------------------------------------
//左右边界符，默认为{}，但实际应用当中容易与javascript
//相冲突，所以建议设成<{}>或其它。
//----------------------------------------------------
$smarty->left_delimiter = "{"; 
$smarty->right_delimiter = "}";

$smarty->assign("name", "李晓军"); //进行模板变量替换

//编译并显示位于./templates下的index.tpl模板
$smarty->display("index.tpl"); 
?> 
最终执行这个程序时将显示为：
================================
执行index.php
================================
<html>
<head>
<title>大师兄smarty教程</title>
</head>
<body>
大家好，我叫李晓军, 欢迎大家阅读我的smarty学习材料。
<hr>
<center> CopyRight&#169; by 大师兄 2004年8月 Email: teacherli@163.com </center>
<hr>
</body>
</html>



实例2：
这个例子是综合使用smarty模板参数的一个例子，这些参数用来控制模板的输出，我只选其中几个，其它的参数你去看参考吧。

================================================
example2.tpl
================================================


<html>
<head><title>大师兄smarty示例2</title></head>
<body>
1. 第一句首字母要大写：{$str1|capitalize}<br>
2. 第二句模板变量 + 李晓军：{$str2|cat:"李晓军"}<br>
3. 第三句输出当前日期：{$str3|date_format:"%Y年%m月%d日"}<br>
4. 第四句.php程序中不处理，它显示默认值：{$str4|default:"没有值！"}<br>
5。第五句要让它缩进8个空白字母位，并使用"*"取替这8个空白字符：<br>
{$str5|indent:8:"*"}}<br>
6. 第六句把TEACHerLI@163.com全部变为小写：{$str6|lower}<br>
7. 第七句把变量中的teacherli替换成：李晓军：{$str7|replace:"teacherli":"李晓军"}<br>
8. 第八句为组合使用变量修改器：{$str8|capitalize|cat:"这里是新加的时间："|date_format:"%Y年%m月%d日"|lower}
</body>
</html>



===============================================
example2 .php
===============================================

<?php
/*********************************************
*
* 文件名： example2.php
* 作 用： 显示实例程序2
*
* 作 者： 大师兄
* Email： teacherli@163.com
*
*********************************************/
include_once("./comm/Smarty.class.php"); //包含smarty类文件

$smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->template_dir = "./templates";//设置模板目录
$smarty->compile_dir = "./templates_c"; //设置编译目录

//----------------------------------------------------
//左右边界符，默认为{}，但实际应用当中容易与JavaScript
//相冲突，所以建议设成<{}>或其它。
//----------------------------------------------------
$smarty->left_delimiter = "{"; 
$smarty->right_delimiter = "}";

$smarty->assign("str1", "my name is xiao jun, li."); //将str1替换成My Name Is Xiao Jun, Li.
$smarty->assign("str2", "我的名字叫："); //输出: 我的名字叫:李晓军
$smarty->assign("str3", "公元"); //输出公元2004年8月21日（我的当前时间）
//$smarty->assign("str4", ""); //第四句不处理时会显示默认值，如果使用前面这一句则替换为""
$smarty->assign("str5", "前边8个*"); //第五句输出：********前边8个*
$smarty->assign("str6", "TEACHerLI@163.com"); //这里将输出teacherli@163.com
$smarty->assign("str7", "this is teacherli"); //在模板中显示为：this is 李晓军
$smarty->assign("str8", "HERE IS COMBINING:");

//编译并显示位于./templates下的index.tpl模板
$smarty->display("example2.tpl"); 
?>



最终输出效果：
======================================================
example2.php输出效果：
======================================================


<html>
<head><title>大师兄smarty示例2</title></head>
<body>
1. 第一句首字母要大写：My Name Is Xiao Jun, Li.<br>
2. 第二句模板变量 + 李晓军：我的名字叫：李晓军<br>
3. 第三句输出当前日期：公元2004年8月21日<br>
4. 第四句.php程序中不处理，它显示默认值：没有值！<br>
5。第五句要让它缩进8个空白字母位，并使用"*"取替这8个空白字符：<br>
********前边8个*<br>
6. 第六句把TEACHerLI@163.com全部变为小写：teacherli@163.com<br>
7. 第七句把变量中的teacherli替换成：李晓军：this is 李晓军<br>
8. 第八句为组合使用变量修改器：Here is Combining:这里是新加的时间：2004年8月21日
</body>
</html>



在模板中的这些参数被称为变量修改器（variable modifiers），使用这些参数可对模板进行一系列的修改控制。变量修改器
使用"|"和调节器名称应用修改器， 使用":"分开修改器参数。变量修改器可以组合使用，像第八句一样，实际使用中可以灵活应用。



实例3.
==================================================
example3.tpl
==================================================


<html>
<head><title>模板中内定的一些函数</title></head>
<body>

{*下面的这一段相当于在模板内部定义一个变量UserName*}
{assign var="UserName" value="大师兄"} 
这里将显示模板内部定义的一个变量:UserName = {$UserName}

下面的这一行将显示3个checkBox:<br>
{html_checkboxes name="CheckBox" values=$CheckName checked=$IsChecked output=$value separator="<br />"}
下面在这一行将显示3个radio:<br>
{html_radios name="RadioBox" values=$RadioName checked=$IsChecked output=$value separator="<br />"}


下面显示一个月,日, 年选择框:<br>
{html_select_date}

<hr><b>CopyRight&#169; By XiaoJun, Li 2004<b>{mailto address="teacherli@163.ccom" text="联系作者"}

</body>
</html>



======================================================
example3.php
======================================================

<?php
/*********************************************
*
* 文件名： example3.php
* 作 用： 显示实例程序3
*
* 作 者： 大师兄
* Email： teacherli@163.com
*
*********************************************/

require_once ("./comm/Smarty.class.php");

$smarty = new Smarty();
$smarty->template_dir = './templates/';
$smarty->compile_dir = './templates_c/';
$smarty->config_dir = './configs/';
$smarty->cache_dir = './cache/';
$smarty->caching = false;

//--------------------------------------------------------------------------------------
//处理{html_checkboxes name="CheckBox" values=$CheckName checked=$IsChecked output=$value separator="<br />"}
//--------------------------------------------------------------------------------------
$smarty->assign('CheckName', array(
1001 => '语文',
1002 => '数学',
1003 => '外语'));
$smarty->assign('IsChecked', 1001);


//--------------------------------------------------------------------------------------
//处理{html_radioes name="RadioBox" values=$RadioName checked=$IsChecked output=$value separator="<br />"}
//--------------------------------------------------------------------------------------
$smarty->assign('RadioName', array(
1001 => '语文',
1002 => '数学',
1003 => '外语'));
$smarty->assign('IsChecked', 1001);

//--------------------------------------------------------------------------------------
//{html_select_date}不用处理会自动输出
//--------------------------------------------------------------------------------------

$smarty->display("example3.tpl");
?>




======================================================
example3.php输出效果:
======================================================


<html>
<head><title>模板中内定的一些函数</title></head>
<body>

{assign var="UserName" value="大师兄"} 
这里将显示模板内部定义的一个变量:UserName = 大师兄

下面的这一行将显示3个checkBox:<br>
<input type="checkbox" name="CheckBox[]" value="1000">语文<br />
<input type="checkbox" name="CheckBox[]" value="1001" checked="checked">数学<br />
<input type="checkbox" name="CheckBox[]" value="1002">外语<br />
下面在这一行将显示3个radio:<br>
<input type="radio" name="RadioBox[]" value="1000">语文<br />
<input type="radio" name="RadioBox[]" value="1001" checked="checked">数学<br />
<input type="radio" name="RadioBox[]" value="1002">外语<br />
下面显示一个月,日, 年选择框:<br>
<select name="Date_Month">
<option label="January" value="01">January</option>
<option label="February" value="02">February</option>
<option label="March" value="03">March</option>
<option label="April" value="04">April</option>
<option label="May" value="05">May</option>
<option label="June" value="06">June</option>
<option label="July" value="07">July</option>
<option label="August" value="08" selected="selected">August</option>
<option label="September" value="09">September</option>
<option label="October" value="10">October</option>
<option label="November" value="11">November</option>
<option label="December" value="12">December</option>
</select>
<select name="Date_Day">
<option label="01" value="1">01</option>
<option label="02" value="2">02</option>
<option label="03" value="3">03</option>
<option label="04" value="4">04</option>
<option label="05" value="5">05</option>
<option label="06" value="6">06</option>
<option label="07" value="7">07</option>
<option label="08" value="8">08</option>
<option label="09" value="9">09</option>
<option label="10" value="10">10</option>
<option label="11" value="11">11</option>
<option label="12" value="12">12</option>
<option label="13" value="13">13</option>
<option label="14" value="14">14</option>
<option label="15" value="15">15</option>
<option label="16" value="16">16</option>
<option label="17" value="17">17</option>
<option label="18" value="18">18</option>
<option label="19" value="19">19</option>
<option label="20" value="20">20</option>
<option label="21" value="21" selected="selected">21</option>
<option label="22" value="22">22</option>
<option label="23" value="23">23</option>
<option label="24" value="24">24</option>
<option label="25" value="25">25</option>
<option label="26" value="26">26</option>
<option label="27" value="27">27</option>
<option label="28" value="28">28</option>
<option label="29" value="29">29</option>
<option label="30" value="30">30</option>
<option label="31" value="31">31</option>
</select>
<select name="Date_Year">
<option label="2004" value="2004" selected="selected">2004</option>
</select>
<hr><b>CopyRight&#169; By XiaoJun, Li 2004<b><a href="mailto:teacherli@163.com">&#193;&#170;&#207;&#181;×÷&#213;&#223;</a>
</body>
</html>


例3使用了一些smarty模板中内置的一些函数,相似的函数大家可以在手册中查到,使用方法很简单,大家可以自己去查找.


例4.模板控制(if / elseif / else/ endif )
=======================================================
example4.tpl
=======================================================


<html>
<head><title>模板中的流程控制</title><head>
<body>
<table border="1">
{assign var="tbColor" value="#D4D0C8"}
色彩:{$tbColor}<br>

{section name=loop loop=$News}
{if $tbColor == "#D4D0C8"}
<tr bgcolor="{$tbColor}">
{assign var="tbColor" value="#EEEEEE"}
{else $tbColor == "#EEEEEE"}
<tr bgcolor = "{$tbColor}">
{assign var="tbColor" value="#D4D0C8"}
{/if}
<td>{$News[loop].newsID}</td>
<td>{$News[loop].newsTitle}</td>
<tr>
{/section}
</table>
</body>
</html>



=======================================================
example4.php
=======================================================

<?php
/*********************************************
*
* 文件名： example4.php
* 作 用： 显示实例程序4
*
* 作 者： 大师兄
* Email： teacherli@163.com
*
*********************************************/

require_once ("./comm/Smarty.class.php");

$smarty = new Smarty();
$smarty->template_dir = './templates/';
$smarty->compile_dir = './templates_c/';
$smarty->config_dir = './configs/';
$smarty->cache_dir = './cache/';
$smarty->caching = false;

$array[]= array("newsID"=>"001", "newsTitle"=>"第1条新闻"); 
$array[]= array("newsID"=>"002", "newsTitle"=>"第2条新闻");
$array[]= array("newsID"=>"003", "newsTitle"=>"第3条新闻");
$array[]= array("newsID"=>"004", "newsTitle"=>"第4条新闻");
$array[]= array("newsID"=>"005", "newsTitle"=>"第5条新闻");
$array[]= array("newsID"=>"006", "newsTitle"=>"第6条新闻");
$array[]= array("newsID"=>"007", "newsTitle"=>"第7条新闻");
$array[]= array("newsID"=>"008", "newsTitle"=>"第8条新闻");


$smarty->assign("News", $array);

$smarty->display("example4.tpl");
?>



==================================================
example4.php输出:
==================================================


<html>
<head><title>模板中的流程控制</title><head>
<body>
<table border="1">

<tr bgcolor="#D4D0C8">

<td>001</td>
<td>第1条新闻</td>
</tr>
<tr bgcolor = "#EEEEEE">

<td>002</td>
<td>第2条新闻</td>
</tr>
<tr bgcolor="#D4D0C8">

<td>003</td>
<td>第3条新闻</td>
</tr>
<tr bgcolor = "#EEEEEE">

<td>004</td>
<td>第4条新闻</td>
</tr>
<tr bgcolor="#D4D0C8">

<td>005</td>
<td>第5条新闻</td>
</tr>
<tr bgcolor = "#EEEEEE">

<td>006</td>
<td>第6条新闻</td>
</tr>
<tr bgcolor="#D4D0C8">

<td>007</td>
<td>第7条新闻</td>
</tr>
<tr bgcolor = "#EEEEEE">

<td>008</td>
<td>第8条新闻</td>
</tr>
</table>
</body>
</html>



模板文件中使用:


{if $tbColor == "#D4D0C8"}
<tr bgcolor="{$tbColor}">
{assign var="tbColor" value="#EEEEEE"}
{else $tbColor == "#EEEEEE"}
<tr bgcolor = "{$tbColor}">
{assign var="tbColor" value="#D4D0C8"}
{/if}


这一语句块进行设置每一行的背景颜色, {assign var="tbColor" value="#D4D0C8"}还记的吧,是例3中设置模板内部变量的定义方法,

使用模板内置的流程控制语句有时可以极大程度上提高程序的控制能力,下面一个例子是phpx.com中曾经有位朋友问过的,我将它作为
实例放在这里供大家学习.
例4我用来说明{if / elseif /else /if}的使用方法,如果单为了实现隔行的目的,大家可以使用这一句就行了:
PHP代码:


--------------------------------------------------------------------------------
{section name=rows loop=$data}
<tr bgcolor="{cycle values="#D4D0C8,#EEEEEE"}">
<td>{$data[rows]}</td>
</tr>
{/section}
---------------------------------------------------------------------------------





例5: 使用模板内置流程控制语句进行一行多单元格内容输出, 也就是在视觉上smarty每记输出几条记录:
================================================
example5.tpl
================================================


<html>
<head><title>一行输出多条记录</title></head>
<body>
<table>
<tr>
{section name=loop loop=$News step=1} 
{if $smarty.section.loop.index % 4 == 0}
</tr> 
<tr>
{/if}
<td>{$News[loop].newsID}</td>
<td>{$News[loop].newsTitle}</td>
{/section}
</tr> 
</table>
</body>
</html>




====================================================
example5.php
====================================================

<?php
/*********************************************
*
* 文件名： example5.php
* 作 用： 显示实例程序5
*
* 作 者： 大师兄
* Email： teacherli@163.com
*
*********************************************/

require_once ("./comm/Smarty.class.php");

$smarty = new Smarty();
$smarty->template_dir = './templates/';
$smarty->compile_dir = './templates_c/';
$smarty->config_dir = './configs/';
$smarty->cache_dir = './cache/';
$smarty->caching = false;

$array[]= array("newsID"=>"001", "newsTitle"=>"第1条新闻"); 
$array[]= array("newsID"=>"002", "newsTitle"=>"第2条新闻");
$array[]= array("newsID"=>"003", "newsTitle"=>"第3条新闻");
$array[]= array("newsID"=>"004", "newsTitle"=>"第4条新闻");
$array[]= array("newsID"=>"005", "newsTitle"=>"第5条新闻");
$array[]= array("newsID"=>"006", "newsTitle"=>"第6条新闻");
$array[]= array("newsID"=>"007", "newsTitle"=>"第7条新闻");
$array[]= array("newsID"=>"008", "newsTitle"=>"第8条新闻");


$smarty->assign("News", $array);

$smarty->display("example5.tpl");
?>



==================================================
example5.php输出内容:
==================================================


<html>
<head><title>一行输出多条记录</title></head>
<body>
<table>
<tr>

</tr> 
<tr>
<td>001</td>
<td>第1条新闻</td>

<td>002</td>
<td>第2条新闻</td>

<td>003</td>
<td>第3条新闻</td>

<td>004</td>
<td>第4条新闻</td>

</tr> 
<tr>
<td>005</td>
<td>第5条新闻</td>

<td>006</td>
<td>第6条新闻</td>

<td>007</td>
<td>第7条新闻</td>

<td>008</td>
<td>第8条新闻</td>
</tr> 
</table>
</body>
</html>



说明:本来还可以优化,使得第一行不输出一个空行的<tr> </tr>,但是学习程序,简单为好,先就这么用了. 在这里说明一下:


{section name=loop loop=$News step=1} 
{if $smarty.section.loop.index % 4 == 0}
</tr> 
<tr>
{/if}
<td>{$News[loop].newsID}</td>
<td>{$News[loop].newsTitle}</td>
{/section}



{ section}{/ section}指的是一个循环部分,在下一节会有详细的介绍,我们主要来看看这一句:


{if $smarty.section.loop.index % 4 == 0}


$smarty.section.loop 指出$smarty的实例中的section段有一个叫loop的部分, 它有一个属性叫index, 它的表示当前循环的索引值,从0开始递增,我们把它%4后与0相比较,也就是说,如果当前的索引值是4的倍数,它就输出一个</tr> <tr>,否则执行下面的部分,
很简单的就解决了一个在程序上实现起来很麻烦的事情.这里我仅演示的是如何使用{ if}语句功能,实现这个功能在Smarty的模板中还有一个非常方便的办法:{ cycle},使用的例子如下所示:


=================================
     {section name=rows loop=$data}
<tr bgcolor="{cycle values="#D4D0C8,#EEEEEE"}">
<td>{$data[rows]}</td>
</tr>
{/section}
     =================================


Posted:2004/09/30 18:40
--------------------------------------------------------------------------------

2.---程序设计部分


在smarty的模板设计部分我简单的把smarty在模板中的一些常用设置做了简单的介绍，这一节主要来介绍一下如何在smarty中开始我们程序设计。


首先来介绍一下在上一节中我们使用的过的.php文件中的一些元素。同样，我们拿上一节中最开始的那个index.php文件来说明一下：

================================================
index.php
================================================

<?php
/*********************************************
*
* 文件名： index.php
* 作 用： 显示实例程序
*
* 作 者： 大师兄
* Email： teacherli@163.com
*
*********************************************/
include_once("./comm/Smarty.class.php"); //包含smarty类文件

$smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->template_dir = "./templates";//设置模板目录
$smarty->compile_dir = "./templates_c"; //设置编译目录


//****大家注意，这里我是我新加入的****//

$tpl->cache_dir = "./cache"; //设置缓存目录
$smarty->cache_lifetime = 60 * 60 * 24; //设置缓存时间
$smarty->caching = true; //设置缓存方式

//---------------------------------------------------- <