[PHP]模板引擎Smarty深入浅出介绍

答案：

Smarty介绍
　　
　什么是模版引擎
　　
　不知道从什么时候开始，有人开始对 HTML 内嵌入 Server Script 觉得不太满意。然而不论是微软的 ASP 或是开放源码的 PHP，都是属于内嵌 Server Script 的网页伺服端语言。因此也就有人想到，如果能把程序应用逻辑 (或称商业应用逻辑) 与网页呈现 (Layout) 逻辑分离的话，是不是会比较好呢？
　　
　其实这个问题早就存在已久，从交互式网页开始风行时，不论是 ASP 或是 PHP 的使用者都是身兼程序开发者与视觉设计师两种身份。可是通常这些使用者不是程序强就是美工强，如果要两者同时兼顾，那可得死掉不少脑细胞...
　　
　所以模版引擎就应运而生啦！模版引擎的目的，就是要达到上述提到的逻辑分离的功能。它能让程序开发者专注于资料的控制或是功能的达成；而视觉设计师则可专注于网页排版，让网页看起来更具有专业感！因此模版引擎很适合公司的网站开发团队使用，使每个人都能发挥其专长！
　　
　就笔者接触过的模版引擎来说，依资料呈现方式大概分成：需搭配程序处理的模版引擎和完全由模版本身自行决定的模版引擎两种形式。
　　
　在需搭配程序处理的模版引擎中，程序开发者必须要负责变量的呈现逻辑，也就是说他必须把变量的内容在输出到模版前先处理好，才能做 assign 的工作。换句话说，程序开发者还是得多写一些程序来决定变量呈现的风貌。而完全由模版本身自行决定的模版引擎，它允许变量直接 assign 到模版中，让视觉设计师在设计模版时再决定变量要如何呈现。因此它就可能会有另一套属于自己的模版程序语法 (如 Smarty) ，以方便控制变量的呈现。但这样一来，视觉设计师也得学习如何使用模版语言。
　　
　模版引擎的运作原理，首先我们先看看以下的运行图：
　　
　　一般的模版引擎 (如 PHPLib) 都是在建立模版对象时取得要解析的模版，然后把变量套入后，透过 parse() 这个方法来解析模版，最后再将网页输出。
　　
　　对 Smarty 的使用者来说，程序里也不需要做任何 parse 的动作了，这些 Smarty 自动会帮我们做。而且已经编译过的网页，如果模版没有变动的话， Smarty 就自动跳过编译的动作，直接执行编译过的网页，以节省编译的时间。
　　
　　使用Smarty的一些概念
　　
　　在一般模版引擎中，我们常看到区域的观念，所谓区块大概都会长成这样：
　　
　　区域内容
　　
　　
　　这些区块大部份都会在 PHP 程序中以 if 或 for, while 来控制它们的显示状态，虽然模版看起来简洁多了，但只要一换了显示方式不同的模版， PHP 程序势必要再改一次！
　　
　　在 Smarty 中，一切以变量为主，所有的呈现逻辑都让模版自行控制。因为 Smarty 会有自己的模版语言，所以不管是区块是否要显示还是要重复，都是用 Smarty 的模版语法 (if, foreach, section) 搭配变量内容作呈现。这样一来感觉上好象模版变得有点复杂，但好处是只要规划得当， PHP 程序一行都不必改。
　　
　　由上面的说明，我们可以知道使用Smarty 要掌握一个原则：将程序应用逻辑与网页呈现逻辑明确地分离。就是说 PHP 程序里不要有太多的 HTML 码。程序中只要决定好那些变量要塞到模版里，让模版自己决定该如何呈现这些变量 (甚至不出现也行) 。
　　
　　Smarty的基础
　　
　　安装Smarty
　　
　　首先，我们先决定程序放置的位置。
　　
　　Windows下可能会类似这样的位置：「 d:\appserv\web\demo\ 」。
　　
　　Linux下可能会类似这样的位置：「 /home/jaceju/public_html/ 」。
　　
　　到Smarty的官方网站下载最新的Smarty套件：http://smarty.php.net。
　　
　　解开 Smarty 2.6.0 后，会看到很多档案，其中有个 libs 资料夹。在 libs 中应该会有 3 个 class.php 檔 + 1 个 debug.tpl + 1 个 plugin 资料夹 + 1 个 core 资料夹。然后直接将 libs 复制到您的程序主资料夹下，再更名为 class 就可以了。就这样？没错！这种安装法比较简单，适合一般没有自己主机的使用者。
　　
　　至于 Smarty 官方手册中为什么要介绍一些比较复杂的安装方式呢？基本上依照官方的方式安装，可以只在主机安装一次，然后提供给该主机下所有设计者开发不同程序时直接引用，而不会重复安装太多的 Smarty 复本。而笔者所提供的方式则是适合要把程序带过来移过去的程序开发者使用，这样不用烦恼主机有没有安装 Smarty 。
　　
　　程序的资料夹设定
　　
　　以笔者在Windows安装Appserv为例，程序的主资料夹是「d:\appserv\web\demo\」。安装好Smarty后，我们在主资料夹下再建立这样的资料夹：

　　在 Linux 底下，请记得将 templates_c 的权限变更为 777 。Windows 下则将其只读取消。
　　
　　第一个用Smarty写的小程序
　　
　　我们先设定 Smarty 的路径，请将以下这个档案命名为 main.php ，并放置到主资料夹下：
　　
　　main.php:

<?php
　　include "class/Smarty.class.php";
　　define(@#__SITE_ROOT@#, @#d:/appserv/web/demo@#); // 最后没有斜线
　　$tpl = new Smarty();
　　$tpl->template_dir = __SITE_ROOT . "/templates/";
　　$tpl->compile_dir = __SITE_ROOT . "/templates_c/";
　　$tpl->config_dir = __SITE_ROOT . "/configs/";
　　$tpl->cache_dir = __SITE_ROOT . "/cache/";
　　$tpl->left_delimiter = @#<{@#;
　　$tpl->right_delimiter = @#}>@#;
　　?>

照上面方式设定的用意在于，程序如果要移植到其它地方，只要改 __SITE_ROOT 就可以啦。 (这里是参考 XOOPS 的 )
　　
　　Smarty 的模版路径设定好后，程序会依照这个路径来抓所有模版的相对位置 (范例中是 @#d:/appserv/web/demo/templates/@# ) 。然后我们用 display() 这个 Smarty 方法来显示我们的模版。
　　
　　接下来我们在 templates 资料夹下放置一个 test.htm：(扩展名叫什么都无所谓，但便于视觉设计师开发，笔者都还是以 .htm 为主。)
　　
　　templates/test.htm:

　　现在我们要将上面的模版显示出来，并将网页标题 ($title) 与内容 ($content) 更换，请将以下档案内容命名为 test.php ，并放置在主资料夹下：
　　
　　test.php:

<?php
　　require "main.php";
　　$tpl->assign("title", "测试用的网页标题");
　　$tpl->assign("content", "测试用的网页内容");
　　// 上面两行也可以用这行代替
　　// $tpl->assign(array("title" => "测试用的网页标题", "content" => "测试用的网页内容"));
　　$tpl->display(@#test.htm@#);
　　?>

请打开浏览器，输入 http://localhost/demo/test.php 试试看(依您的环境决定网址)，应该会看到以下的画面：
　　
　

　　再到 templates_c 底下，我们会看到一个奇怪的资料夹 (%%179) ，再点选下去也是一个奇怪的资料夹 (%%1798044067) ，而其中有一个档案：
　　
　　templates_c/%%179/%%1798044067/test.htm.php:

<?php /* Smarty version 2.6.0, created on 2003-12-15 22:19:45 compiled from test.htm */ ?>
　　<html>
　　<head>
　　<meta http-equiv="Content-Type" content="text/html; charset=big5">
　　<title><?php echo $this->_tpl_vars[@#title@#]; ?\></title>
　　</head>
　　<body>
　　<?php echo $this->_tpl_vars[@#content@#]; ?\>
　　</body>
　　</html>
　　

　没错，这就是 Smarty 编译过的档案。它将我们在模版中的变量转换成了 PHP 的语法来执行，下次再读取同样的内容时， Smarty 就会直接抓取这个档案来执行了。
　　
　　最后我们整理一下整个 Smarty 程序撰写步骤：
　　
　　Step 1. 加载 Smarty 模版引擎。
　　
　　Step 2. 建立 Smarty 对象。
　　
　　Step 3. 设定 Smarty 对象的参数。
　　
　　Step 4. 在程序中处理变量后，再用 Smarty 的 assign 方法将变量置入模版里。
　　
　　Step 5. 利用 Smarty 的 display 方法将网页秀出。
　　
　　如何安排你的程序架构
　　
　　上面我们看到除了 Smarty 所需要的资料夹外 (class 、 configs 、 templates 、 templates_c) ，还有两个资料夹： includes 、 modules 。其实这是笔者模仿 XOOPS 的架构所建立出来的，因为 XOOPS 是笔者所接触到的程序中，少数使用 Smarty 模版引擎的架站程序。所谓西瓜偎大边，笔者这样的程序架构虽没有 XOOPS 的百分之一强，但至少给人看时还有 XOOPS 撑腰。
　　
　　includes 这个资料夹主要是用来放置一些 function 、 sql 檔，这样在 main.php 就可以将

上一个：弄了个检测传输的参数是否为数字的Function
下一个：echo, print, printf 和 sprintf 区别

更多图片编程知识: