Smarty实例教程

一、什么是smarty?
smarty是一个使用PHP写出来的模板PHP模板引擎，它提供了逻辑与外在内容的分离，简单的讲，目的就是要使用PHP程序员同美工分
离,使用的程序员改变程序的逻辑内容不会影响到美工的页面设计，美工重新修改页面不会影响到程序的程序逻辑，这在多人合作的项目
中显的尤为重要。

二、smarty优点：
1. 速度：采用smarty编写的程序可以获得最大速度的提高，这一点是相对于其它的模板引擎技术而言的。

2. 编译型：采用smarty编写的程序在运行时要编译成一个非模板技术的PHP文件，这个文件采用了PHP与HTML混合的方式，在下一次访
问模板时将WEB请求直接转换到这个文件中，而不再进行模板重新编译（在源程序没有改动的情况下）

3. 缓存技术：smarty选用的一种缓存技术，它可以将用户最终看到的HTML文件缓存成一个静态的HTML页，当设定smarty的cache属性为
true时，在smarty设定的cachetime期内将用户的WEB请求直接转换到这个静态的HTML文件中来，这相当于调用一个静态的HTML文件。

4. 插件技术：smarty可以自定义插件。插件实际就是一些自定义的函数。

5. 模板中可以使用if/elseif/else/endif。在模板文件使用判断语句可以非常方便的对模板进行格式重排。

三、不适合使用smarty的地方：

1. 需要实时更新的内容。例如像股票显示，它需要经常对数据进行更新，这类型的程序使用smarty会使模板处理速度变慢。

2. 小项目。小项目因为项目简单而美工与程序员兼于一人的项目，使用smarty会丧失php开发迅速的优点。

四、安装smarty类：

安装smarty的环境：php版本4.06以上版本。

安装smarty方法非常简单，从http://samrty.php.net中下载smarty.t…将LIB中所有文件
拷入comm目录,完成基本安装.

其它高级安装使用方法请看手册.

五、smarty在模板中的使用：

本节通过几个实例来讲一讲smarty的使用。smarty模板通常使用.tpl来标识，有些人为了美工方便，将扩展名直接写成.html，也是可以
的。本文中采用smarty标准写法:以.tpl来表示为一个smarty模板。

PHP代码:——————————————————————————–

实例1：

先来看一个简单的例子。
=====================================================
index.tpl
=====================================================

{* 显示是smarty变量识符里的用*包含的文字为注释内容 *}
{include file=”header.tpl”}{*页面头*}
大家好，我叫{$name}, 欢迎大家阅读我的smarty学习材料。
{include file=”foot.tpl”}{*页面尾*}

上边的这个例子是一个tpl模板，其中：
1. {**}是模板页的注释，它在smarty对模板进行解析时不进行任何输出，仅供模板设计师对模板进行注释。
2. {include file=”xxx.tpl”}使用此句将一个模板文件包含到当前页面中，例子中将在网站中公用事的head.tpl与foot.tpl进行了包含，你可以
这样想，使用这一句将xxx.tpl中的内容全部复制在当前语句处。当然，你不使用这一句也可以，将XXX.tpl中的内容复制到当前语句处
也是完全可以了。

3.{$name}: 模板变量，smarty中的核心组成，采用smarty定义的左边界符{与右边界符}包含着、以PHP变量形式给出，在smarty程序中将使用
$smarty->assign(”name”, “李晓军”)；将模板中的$name替换成”李晓军”三个字。

整个实例源程序如下：
=============================
header.tpl
=============================

===============================
foot.tpl
===============================

=====================================================
index.tpl
=====================================================

{* 显示是smarty变量识符里的用*包含的文字为注释内容 *}
{include file=”header.tpl”}{*页面头*}
大家好，我叫{$name}, 欢迎大家阅读我的smarty学习材料。
{include file=”foot.tpl”}{*页面尾*}

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

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

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

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

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

最终执行这个程序时将显示为：
================================
执行index.php
================================





大家好，我叫李晓军, 欢迎大家阅读我的smarty学习材料。

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

================================================
exmple2.tpl
================================================



1. 第一句首字母要大写：{$str1capitalize}

2. 第二句模板变量 + 李晓军：{$str2cat:”李晓军”}

3. 第三句输出当前日期：{$str3date_format:”%Y年%m月%d日”}
4. 第四句.php程序中不处理，它显示默认值：{$str4default:”没有值！”}
5。第五句要让它缩进8个空白字母位，并使用”*”取替这8个空白字符：

{$str5indent:8:”*”}}

6. 第六句把TEACHerLI@163.com全部变为小写：{$str6lower}

7. 第七句把变量中的teacherli替换成：李晓军：{$str7replace:”teacherli”:”李晓军”}

8. 第八句为组合使用变量修改器：{$str8capitalizecat:”这里是新加的时间：”date_format:”%Y年%m月%d日”lower}

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

$smarty = new Smarty(); //建立smarty实例对象$smarty
$smarty->templates(”./templates”); //设置模板目录
$smarty->templates_c(”./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输出效果：
======================================================



1. 第一句首字母要大写：My Name Is Xiao Jun, Li.

2. 第二句模板变量 + 李晓军：我的名字叫：李晓军

3. 第三句输出当前日期：公元2004年8月21日

4. 第四句.php程序中不处理，它显示默认值：没有值！

5。第五句要让它缩进8个空白字母位，并使用”*”取替这8个空白字符：

********前边8个*

6. 第六句把TEACHerLI@163.com全部变为小写：teacherli@163.com

7. 第七句把变量中的teacherli替换成：李晓军：this is 李晓军

8. 第八句为组合使用变量修改器：Here is Combining:这里是新加的时间：2004年8月21日

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

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

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

下面的这一行将显示3个checkBox:

{html_checkboxes name=”CheckBox” values=$CheckName checked=$IsChecked output=$value separator=”
”}
下面在这一行将显示3个radio:

{html_radioes name=”RadioBox” values=$RadioName checked=$IsChecked output=$value separator=”
”}

下面显示一个月,日, 年选择框:

{html_select_date}