PHP模板Smarty的具体使用指南

通常我们的解决方法是由美工设计页面后交付程序设计者进行开发，再交付美工对页面进行改善，来回重复好几回，如果遇到程序设计者对HTML不熟悉，对双方来说更是个痛苦的差事，效率也更低下，这时候如果有模板支持就显得非常重要。

我们知道PHP语言作为开源社区的一员，提供了各种模板引擎，如FastTemplate，Smarty，SimpleTemplate等，而Smarty是现在使用得比较多的PHP模板引擎，今天和大家分享在PHP开发中如何安装与使用PHP模板Smarty，也算是对Smarty的入门学习。

准备工作

1、选择安装Smarty的目录

如果拥有服务器权限，考虑到安全性可以选择将Smarty安装在WEB程序文档目录之外的地方，然后通过将Smarty安装目录地址包含在PHP.INI文件中的include_path选项。

如果是虚拟主机权限，或者好几个项目，可以将Smarty安装在各自的项目目录中，在require Smarty类文件，也可以使用Smarty模板引擎。当然为了安全考虑，你可以通过apache禁止相关目录访问。

另外这两种PHP模板Smarty安装方式在移植性方面有所区别，第一种方式需要保证每台服务器有相同的Smarty配置，第二种方式对每台服务器配置没有影响。你可以根据各自的需要选择Smarty的安装方式。

2、下载Smarty，，我选择的是Smarty-2.6.25

PHP模板Smarty安装步骤

1、解压下载的Smarty-2.6.25压缩包

2、拷贝libs文件夹到WEB程序目录下，我的目录为testsmarty

Linux下的安装方法可以参考这里。

在安装完Smarty模板后，我们开始简单使用Smarty。

PHP模板Smarty使用

1、创建相关目录

由于在使用Smarty的过程中，Smarty会生成编译的模板文件以及其他配置文件、缓存文件，我们需要创建相关的目录。我在testsmarty目录下，另外创建了tpls目录，并在tpls目录下创建templates、templates_c、configs、cache目录。为什么需要创建这些目录呢？打开Smarty.class.php文件，我们可以看到Smarty类定义了部分的成员属性。

$template_dir：设定所有模板文件都需要放置的目录地址。默认情况下，目录是：“./templates”，也就是在PHP执行程序同一个目录下寻找该模板目录。

$compile_dir：设定Smarty编译过的所有模板文件的存放目录地址。默认目录是：“./templates_c”，也就是在PHP执行程序同一个目录下寻找该编译目录。如果你在Linux服务器上创建这个目录，你还需要修改此目录的权限，使它有写的权限。

$config_dir：设定用于存放模板特殊配置文件的目录，默认目录是：“./configs”，也就是在PHP执行程序同一个目录下寻找该配置目录。

$cache_dir：在启动缓存特性的情况下，这个属性所指定的目录中放置PHP模板Smarty缓存的所有模板。默认目录是：”./cache”，也就是在PHP执行程序同一个目录下寻找该缓存目录。你也可以用你自定义的缓存处理函数来控制缓存文件，它将会忽略这项设置。同样如果你在Linux服务器上创建这个目录，你还需要修改此目录的权限，使它有写的权限。

为了系统安全和移植性考虑，建议不要将这些目录建立在PHP执行程序同一目录下，可以将它建立在PHP执行程序目录之外，如果已建立在PHP执行程序同一目录下，可以通过Apache做好目录限制访问工作。

2、建立相关配置文件

我们需要创建一个配置文件，来覆盖PHP模板Smarty类的默认成员属性，并命名为main.php，保存在smarty目录下，以后哪个脚本需要使用Smarty，我们只要把main.php包含进来即可。

<ol class="dp-xml">
<li class="alt"><span><span class="tag"><span> ?  </span></span></span></li>
<li><span>include("./smarty/libs/Smarty.class.php");  </span></li>
<li class="alt"><span>define('SMARTY_ROOT', './smarty/tpls');  </span></li>
<li>
<span>$</span><span class="attribute">tpl</span><span> = </span><span class="attribute-value">new</span><span> Smarty();  </span>
</li>
<li class="alt">
<span>$tpl-</span><span class="tag">></span><span class="attribute">template_dir</span><span> = </span><span class="attribute-value">SMARTY_ROOT</span><span>."/templates/";  </span>
</li>
<li>
<span>$tpl-</span><span class="tag">></span><span class="attribute">compile_dir</span><span> = </span><span class="attribute-value">SMARTY_ROOT</span><span>."/templates_c/";  </span>
</li>
<li class="alt">
<span>$tpl-</span><span class="tag">></span><span class="attribute">config_dir</span><span> = </span><span class="attribute-value">SMARTY_ROOT</span><span>."/configs/";  </span>
</li>
<li>
<span>$tpl-</span><span class="tag">></span><span class="attribute">cache_dir</span><span> = </span><span class="attribute-value">SMARTY_ROOT</span><span>."/cache/";  </span>
</li>
<li class="alt">
<span>$tpl-</span><span class="tag">></span><span class="attribute">caching</span><span>=</span><span class="attribute-value">1</span><span>;  </span>
</li>
<li>
<span>$tpl-</span><span class="tag">></span><span class="attribute">cache_lifetime</span><span>=</span><span class="attribute-value">60</span><span>*60*24;  </span>
</li>
<li class="alt">
<span>$tpl-</span><span class="tag">></span><span class="attribute">left_delimiter</span><span> = </span><span class="attribute-value">'<span>;  </span></span>
</li>
<li>
<span>$tpl-</span><span class="tag">></span><span class="attribute">right_delimiter</span><span> = </span><span class="attribute-value">'}>'</span><span>;  </span>
</li>
<li class="alt">
<span class="tag">?></span><span> </span>
</li>
</ol>

注释：

第1-8行：主要定义一个smarty对象，同时设定模板文件、编译文件、缓存文件、配置文件的存放目录，覆盖Smarty.class.php中的默认值。

第9-10行：设定开启缓存，同时设定缓存的有效时间为1天。
知识点：$caching用来设置是否开启缓存功能。默认值设为0或无效。你也可以为同一个模板设有多个缓存，当值为1或2时启动缓存。1告诉Smarty使用当前的$cache_lifetime变量判断缓存是否过期。2告诉PHP模板Smarty使用生成缓存时的cache_lifetime值。建议在项目开发过程中关闭缓存，将值设置为0

第11-12行：设置smarty语言的左右结束符，我们知道大括号是smarty的默认定界符，但在和javascript、css等结合时可能会产生冲突，所以这里我们设定为。

3、建立一个模板文件

一般情况下在美工页面设计完毕后，双方的交集点是模版文件，双方约定后，程序员不需要花太大的精力在前台，这就是使用Smarty模板引擎进行开发的好处。

我们首先建立一个简单的模版文件，名为leapsoul.tpl，你可在html文件中加入smarty变量后将文件另存为tpl类型的文件。

<ol class="dp-xml">
<li class="alt"><span><span class="tag"><span> </span><span class="tag-name">html</span><span class="tag">></span><span> </span></span></span></li>
<li><span class="tag"><span> </span><span class="tag-name">head</span><span class="tag">></span><span> </span></span></li>
<li class="alt"><span class="tag"><span> </span><span class="tag-name">meta</span><span> </span><span class="attribute">http-equiv</span><span>=</span><span class="attribute-value">"Content-type"</span><span> <br></span><span class="attribute">content</span><span>=</span><span class="attribute-value">"text/html; charset=gb2312"</span><span class="tag">></span><span> </span></span></li>
<li><span class="tag"><span> </span><span class="tag-name">title</span><span class="tag">></span><span>   </span></span></li>
<li class="alt"><span class="tag"><span> { $title }</span><span class="tag">></span><span> </span></span></li>
<li><span class="tag"><span> /title</span><span class="tag">></span><span>   </span></span></li>
<li class="alt"><span class="tag"><span> /head</span><span class="tag">></span><span>   </span></span></li>
<li>
<span> </span><span class="tag"><span class="tag-name">body</span><span class="tag">></span><span>   </span></span>
</li>
<li class="alt"><span class="tag"><span> { $content }</span><span class="tag">></span><span>   </span></span></li>
<li><span class="tag"><span> /body</span><span class="tag">></span><span>   </span></span></li>
<li class="alt"><span class="tag"><span> /html</span><span class="tag">></span><span> </span></span></li>
</ol>

注释：在这个tpl文件中设定了title和content两个PHP模板Smarty变量，文件保存为leapsoul.tpl，同时将其保存在testsmartytplstemplates模板文件目录下。

4、建立应用程序文件

模版文件类似于一个表现层，在建立完模板文件后，我们需要一个应用程序去驱动表现层，应用程序文件定义为smarty.php。

<ol class="dp-xml">
<li class="alt"><span><span class="tag"><span> ?  </span></span></span></li>
<li><span>include("smarty/main.php");  </span></li>
<li class="alt">
<span>$tpl-</span><span class="tag">></span><span>assign("title", "leapsoul.cn为你<br>展示smarty模板技术");  </span>
</li>
<li>
<span>$tpl-</span><span class="tag">></span><span>assign("content", "leapsoul.cn<br>通过详细的安装使用步骤为你展示smarty模板技术");  </span>
</li>
<li class="alt">
<span>$tpl-</span><span class="tag">></span><span>display("leapsoul.tpl");  </span>
</li>
<li>
<span class="tag">?></span><span> </span>
</li>
</ol>

注释：

在这段代码中我们主要用到smarty中的两个函数assign和display，assign你可以理解为为变量赋值，display主要是用来将网页输出。更多smarty函数今后会详细介绍。

其他说明

由于我们开启了缓存功能，有兴趣的朋友可以打开cache和templates_c，cache目录存放了这个模板的缓存文件，文件开头部分有缓存信息，如文件的生成时间和过期时间等，其他的和一般的HTML文件没有多大的区别，而templates_c存放了模板经过编译后的PHP执行文件。

至此一个简单入门的PHP模板Smarty应用实例就算介绍完成了。