剛開(kāi)始接觸模版引擎的 PHP 設(shè)計(jì)師，聽(tīng)到 Smarty 時(shí)，都會(huì)覺(jué)得很難。其實(shí)筆者也不例外，碰都不敢碰一下。但是后來(lái)在剖析 XOOPS 的程序架構(gòu)時(shí)，開(kāi)始發(fā)現(xiàn) Smarty 其實(shí)并不難。只要將 Smarty 基礎(chǔ)功練好，在一般應(yīng)用上就已經(jīng)相當(dāng)足夠了。當(dāng)然基礎(chǔ)能打好，后面的進(jìn)階應(yīng)用也就不用怕了。

這篇文章的主要用意并非要深入探討 Smarty 的使用，這在官方使用說(shuō)明中都已經(jīng)寫(xiě)得很完整了。筆者僅在此寫(xiě)下一些自己使用上的心得，讓想要了解 Smarty 卻不得其門(mén)而入的朋友，可以從中得到一些啟示。就因?yàn)檫@篇文章的內(nèi)容不是非常深入，會(huì)使用 Smarty 的朋友們可能會(huì)覺(jué)得簡(jiǎn)單了點(diǎn)。

目前本文已經(jīng)第三次修訂了，本想多加一些料進(jìn)來(lái)；不過(guò)礙于時(shí)間的關(guān)系，很多 Smarty 的進(jìn)階技巧筆者并沒(méi)有研究得很透徹，所以也不敢拿出來(lái)現(xiàn)眼，但筆者相信這篇文章應(yīng)該能夠滿(mǎn)足大多數(shù)想學(xué)習(xí) Smarty 的初學(xué)者了。當(dāng)然本文有謬誤的地方也歡迎告知，筆者會(huì)在下一次的修訂中更正的。

Smarty介紹

什么是模版引擎

不知道從什么時(shí)候開(kāi)始，有人開(kāi)始對(duì) HTML 內(nèi)嵌入 Server Script 覺(jué)得不太滿(mǎn)意。然而不論是微軟的 ASP 或是開(kāi)放源碼的 PHP，都是屬于內(nèi)嵌 Server Script 的網(wǎng)頁(yè)伺服端語(yǔ)言。因此也就有人想到，如果能把程序應(yīng)用邏輯 (或稱(chēng)商業(yè)應(yīng)用邏輯) 與網(wǎng)頁(yè)呈現(xiàn) (Layout) 邏輯分離的話(huà)，是不是會(huì)比較好呢？

其實(shí)這個(gè)問(wèn)題早就存在已久，從交互式網(wǎng)頁(yè)開(kāi)始風(fēng)行時(shí)，不論是 ASP 或是 PHP 的使用者都是身兼程序開(kāi)發(fā)者與視覺(jué)設(shè)計(jì)師兩種身份?？墒峭ǔ＿@些使用者不是程序強(qiáng)就是美工強(qiáng)，如果要兩者同時(shí)兼顧，那可得死掉不少腦細(xì)胞...

所以模版引擎就應(yīng)運(yùn)而生啦！模版引擎的目的，就是要達(dá)到上述提到的邏輯分離的功能。它能讓程序開(kāi)發(fā)者專(zhuān)注于資料的控制或是功能的達(dá)成；而視覺(jué)設(shè)計(jì)師則可專(zhuān)注于網(wǎng)頁(yè)排版，讓網(wǎng)頁(yè)看起來(lái)更具有專(zhuān)業(yè)感！因此模版引擎很適合公司的網(wǎng)站開(kāi)發(fā)團(tuán)隊(duì)使用，使每個(gè)人都能發(fā)揮其專(zhuān)長(zhǎng)！

就筆者接觸過(guò)的模版引擎來(lái)說(shuō)，依資料呈現(xiàn)方式大概分成：需搭配程序處理的模版引擎和完全由模版本身自行決定的模版引擎兩種形式。

在需搭配程序處理的模版引擎中，程序開(kāi)發(fā)者必須要負(fù)責(zé)變量的呈現(xiàn)邏輯，也就是說(shuō)他必須把變量的內(nèi)容在輸出到模版前先處理好，才能做 assign 的工作。換句話(huà)說(shuō)，程序開(kāi)發(fā)者還是得多寫(xiě)一些程序來(lái)決定變量呈現(xiàn)的風(fēng)貌。而完全由模版本身自行決定的模版引擎，它允許變量直接 assign 到模版中，讓視覺(jué)設(shè)計(jì)師在設(shè)計(jì)模版時(shí)再?zèng)Q定變量要如何呈現(xiàn)。因此它就可能會(huì)有另一套屬于自己的模版程序語(yǔ)法 (如 Smarty) ，以方便控制變量的呈現(xiàn)。但這樣一來(lái)，視覺(jué)設(shè)計(jì)師也得學(xué)習(xí)如何使用模版語(yǔ)言。

模版引擎的運(yùn)作原理，首先我們先看看以下的運(yùn)行圖：

一般的模版引擎 (如 PHPLib) 都是在建立模版對(duì)象時(shí)取得要解析的模版，然后把變量套入后，透過(guò) parse() 這個(gè)方法來(lái)解析模版，最后再將網(wǎng)頁(yè)輸出。

對(duì) Smarty 的使用者來(lái)說(shuō)，程序里也不需要做任何 parse 的動(dòng)作了，這些 Smarty 自動(dòng)會(huì)幫我們做。而且已經(jīng)編譯過(guò)的網(wǎng)頁(yè)，如果模版沒(méi)有變動(dòng)的話(huà)， Smarty 就自動(dòng)跳過(guò)編譯的動(dòng)作，直接執(zhí)行編譯過(guò)的網(wǎng)頁(yè)，以節(jié)省編譯的時(shí)間。

使用Smarty的一些概念

在一般模版引擎中，我們?？吹絽^(qū)域的觀念，所謂區(qū)塊大概都會(huì)長(zhǎng)成這樣：
<!-- START : Block name -->
區(qū)域內(nèi)容
<!-- END : Block name -->

這些區(qū)塊大部份都會(huì)在 PHP 程序中以 if 或 for, while 來(lái)控制它們的顯示狀態(tài)，雖然模版看起來(lái)簡(jiǎn)潔多了，但只要一換了顯示方式不同的模版， PHP 程序勢(shì)必要再改一次！

在 Smarty 中，一切以變量為主，所有的呈現(xiàn)邏輯都讓模版自行控制。因?yàn)?nbsp;Smarty 會(huì)有自己的模版語(yǔ)言，所以不管是區(qū)塊是否要顯示還是要重復(fù)，都是用 Smarty 的模版語(yǔ)法 (if, foreach, section) 搭配變量?jī)?nèi)容作呈現(xiàn)。這樣一來(lái)感覺(jué)上好象模版變得有點(diǎn)復(fù)雜，但好處是只要規(guī)劃得當(dāng)， PHP 程序一行都不必改。

由上面的說(shuō)明，我們可以知道使用Smarty 要掌握一個(gè)原則：將程序應(yīng)用邏輯與網(wǎng)頁(yè)呈現(xiàn)邏輯明確地分離。就是說(shuō) PHP 程序里不要有太多的 HTML 碼。程序中只要決定好那些變量要塞到模版里，讓模版自己決定該如何呈現(xiàn)這些變量 (甚至不出現(xiàn)也行) 。

Smarty的基礎(chǔ)

安裝Smarty

首先，我們先決定程序放置的位置。

Windows下可能會(huì)類(lèi)似這樣的位置：「 d:appservwebdemo 」。

Linux下可能會(huì)類(lèi)似這樣的位置：「 /home/jaceju/public_html/ 」。

到Smarty的官方網(wǎng)站下載最新的Smarty套件：http://smarty.php.net。

解開(kāi) Smarty 2.6.0 后，會(huì)看到很多檔案，其中有個(gè) libs 資料夾。在 libs 中應(yīng)該會(huì)有 3 個(gè) class.php 檔 + 1 個(gè) debug.tpl + 1 個(gè) plugin 資料夾 + 1 個(gè) core 資料夾。然后直接將 libs 復(fù)制到您的程序主資料夾下，再更名為 class 就可以了。就這樣？沒(méi)錯(cuò)！這種安裝法比較簡(jiǎn)單，適合一般沒(méi)有自己主機(jī)的使用者。

至于 Smarty 官方手冊(cè)中為什么要介紹一些比較復(fù)雜的安裝方式呢？基本上依照官方的方式安裝，可以只在主機(jī)安裝一次，然后提供給該主機(jī)下所有設(shè)計(jì)者開(kāi)發(fā)不同程序時(shí)直接引用，而不會(huì)重復(fù)安裝太多的 Smarty 復(fù)本。而筆者所提供的方式則是適合要把程序帶過(guò)來(lái)移過(guò)去的程序開(kāi)發(fā)者使用，這樣不用煩惱主機(jī)有沒(méi)有安裝 Smarty 。

程序的資料夾設(shè)定

以筆者在Windows安裝Appserv為例，程序的主資料夾是「d:appservwebdemo」。安裝好Smarty后，我們?cè)谥髻Y料夾下再建立這樣的資料夾：

在 Linux 底下，請(qǐng)記得將 templates_c 的權(quán)限變更為 777 。Windows 下則將其只讀取消。

第一個(gè)用Smarty寫(xiě)的小程序

我們先設(shè)定 Smarty 的路徑，請(qǐng)將以下這個(gè)檔案命名為 main.php ，并放置到主資料夾下：

main.php:

<?php 
include "class/Smarty.class.php"; 
define(@#__SITE_ROOT@#, @#d:/appserv/web/demo@#); // 最后沒(méi)有斜線 
$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 = @#}>@#; 
?> 




照上面方式設(shè)定的用意在于，程序如果要移植到其它地方，只要改 __SITE_ROOT 就可以啦。 (這里是參考 XOOPS 的 )

Smarty 的模版路徑設(shè)定好后，程序會(huì)依照這個(gè)路徑來(lái)抓所有模版的相對(duì)位置 (范例中是 @#d:/appserv/web/demo/templates/@# ) 。然后我們用 display() 這個(gè) Smarty 方法來(lái)顯示我們的模版。

接下來(lái)我們?cè)?nbsp;templates 資料夾下放置一個(gè) test.htm：(擴(kuò)展名叫什么都無(wú)所謂，但便于視覺(jué)設(shè)計(jì)師開(kāi)發(fā)，筆者都還是以 .htm 為主。)

templates/test.htm:
<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=big5"> 
<title><{$title}></title> 
</head> 
<body> 
<{$content}> 
</body> 
</html> 




現(xiàn)在我們要將上面的模版顯示出來(lái)，并將網(wǎng)頁(yè)標(biāo)題 ($title) 與內(nèi)容 ($content) 更換，請(qǐng)將以下檔案內(nèi)容命名為 test.php ，并放置在主資料夾下：

test.php:

<?php 
require "main.php"; 
$tpl->assign("title", "測(cè)試用的網(wǎng)頁(yè)標(biāo)題"); 
$tpl->assign("content", "測(cè)試用的網(wǎng)頁(yè)內(nèi)容"); 
// 上面兩行也可以用這行代替 
// $tpl->assign(array("title" => "測(cè)試用的網(wǎng)頁(yè)標(biāo)題", "content" => "測(cè)試用的網(wǎng)頁(yè)內(nèi)容")); 
$tpl->display(@#test.htm@#); 
?> 




請(qǐng)打開(kāi)瀏覽器，輸入 http://localhost/demo/test.php 試試看(依您的環(huán)境決定網(wǎng)址)，應(yīng)該會(huì)看到以下的畫(huà)面：



再到 templates_c 底下，我們會(huì)看到一個(gè)奇怪的資料夾 (%%179) ，再點(diǎn)選下去也是一個(gè)奇怪的資料夾 (%%1798044067) ，而其中有一個(gè)檔案：

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> 




沒(méi)錯(cuò)，這就是 Smarty 編譯過(guò)的檔案。它將我們?cè)谀０嬷械淖兞哭D(zhuǎn)換成了 PHP 的語(yǔ)法來(lái)執(zhí)行，下次再讀取同樣的內(nèi)容時(shí)， Smarty 就會(huì)直接抓取這個(gè)檔案來(lái)執(zhí)行了。

最后我們整理一下整個(gè) Smarty 程序撰寫(xiě)步驟：

Step 1. 加載 Smarty 模版引擎。

Step 2. 建立 Smarty 對(duì)象。

Step 3. 設(shè)定 Smarty 對(duì)象的參數(shù)。

Step 4. 在程序中處理變量后，再用 Smarty 的 assign 方法將變量置入模版里。

Step 5. 利用 Smarty 的 display 方法將網(wǎng)頁(yè)秀出。

如何安排你的程序架構(gòu)

上面我們看到除了 Smarty 所需要的資料夾外 (class 、 configs 、 templates 、 templates_c) ，還有兩個(gè)資料夾： includes 、 modules 。其實(shí)這是筆者模仿 XOOPS 的架構(gòu)所建立出來(lái)的，因?yàn)?nbsp;XOOPS 是筆者所接觸到的程序中，少數(shù)使用 Smarty 模版引擎的架站程序。所謂西瓜偎大邊，筆者這樣的程序架構(gòu)雖沒(méi)有 XOOPS 的百分之一強(qiáng)，但至少給人看時(shí)還有 XOOPS 撐腰。

includes 這個(gè)資料夾主要是用來(lái)放置一些 function 、 sql 檔，這樣在 main.php 就可以將它們引入了，如下：

main.php:


<?php 
include "class/Smarty.class.php"; 
define(@#__SITE_ROOT@#, @#d:/appserv/web/demo@#); // 最后沒(méi)有斜線 
// 以 main.php 的位置為基準(zhǔn) 
require_once "includes/functions.php"; 
require_once "includes/include.php"; 
$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 = @#}>@#; 
?> 




modules 這個(gè)資料夾則是用來(lái)放置程序模塊的，如此一來(lái)便不會(huì)把程序丟得到處都是，整體架構(gòu)一目了然。

上面我們也提到 main.php ，這是整個(gè)程序的主要核心，不論是常數(shù)定義、外部程序加載、共享變量建立等，都是在這里開(kāi)始的。所以之后的模塊都只要將這個(gè)檔案包含進(jìn)來(lái)就可以啦。因此在程序流程規(guī)劃期間，就必須好好構(gòu)思 main.php 中應(yīng)該要放那些東西；當(dāng)然利用 include 或 require 指令，把每個(gè)環(huán)節(jié)清楚分離是再好不過(guò)了。



在上節(jié)提到的 Smarty 程序 5 步驟， main.php 就會(huì)幫我們先將前 3 個(gè)步驟做好，后面的模塊程序只要做后面兩個(gè)步驟就可以了。

從變量開(kāi)始

如何使用變量

從上一章范例中，我們可以清楚地看到我們利用 <{ 及 }> 這兩個(gè)標(biāo)示符號(hào)將變量包起來(lái)。預(yù)設(shè)的標(biāo)示符號(hào)為 { 及 } ，但為了中文沖碼及 javascript 的關(guān)系，因此筆者還是模仿 XOOPS ，將標(biāo)示符號(hào)換掉。變量的命名方式和 PHP 的變量命名方式是一模一樣的，前面也有個(gè) $ 字號(hào) (這和一般的模版引擎不同)。標(biāo)示符號(hào)就有點(diǎn)像是 PHP 中的
<?php 及 ?> 



(事實(shí)上它們的確會(huì)被替換成這個(gè)) ，所以以下的模版變量寫(xiě)法都是可行的：

1. <{$var}>

2. <{ $var }> <!-- 和變量之間有空格 -->

3. <{$var

}> <!-- 啟始的標(biāo)示符號(hào)和結(jié)束的標(biāo)示符號(hào)不在同一行 -->
在 Smarty 里，變量預(yù)設(shè)是全域的，也就是說(shuō)你只要指定一次就好了。指定兩次以上的話(huà)，變量?jī)?nèi)容會(huì)以最后指定的為主。就算我們?cè)谥髂０嬷屑虞d了外部的子模版，子模版中同樣的變量一樣也會(huì)被替代，這樣我們就不用再針對(duì)子模版再做一次解析的動(dòng)作。

而在 PHP 程序中，我們用 Smarty 的 assign 來(lái)將變量置放到模版中。 assign 的用法官方手冊(cè)中已經(jīng)寫(xiě)得很多了，用法就如同上一節(jié)的范例所示。不過(guò)在重復(fù)區(qū)塊時(shí)，我們就必須將變量做一些手腳后，才能將變量 assign 到模版中，這在下一章再提。

修飾你的變量

上面我們提到 Smarty 變量呈現(xiàn)的風(fēng)貌是由模版自行決定的，所以 Smarty 提供了許多修飾變量的函式。使用的方法如下：

<{變量|修飾函式}> <!-- 當(dāng)修飾函式?jīng)]有參數(shù)時(shí) -->

<{變量|修飾函式:"參數(shù)(非必要，視函式而定)"}> <!-- 當(dāng)修飾函式有參數(shù)時(shí) -->
范例如下：

<{$var|nl2br}> <!-- 將變量中的換行字符換成 <br /> -->

<{$var|string_format:"%02d"}> <!-- 將變量格式化 -->
好，那為什么要讓模版自行決定變量呈現(xiàn)的風(fēng)貌？先看看底下的 HTML ，這是某個(gè)購(gòu)物車(chē)結(jié)帳的部份畫(huà)面。

<input name="total" type="hidden" value="21000" />

總金額：21,000 元
一般模版引擎的模版可能會(huì)這樣寫(xiě)：

<input name="total" type="hidden" value="{total}" />

總金額：{format_total} 元
它們的 PHP 程序中要這樣寫(xiě)：


<?php 
$total = 21000; 
$tpl->assign("total", $total); 
$tpl->assign("format_total", number_format($total)); 
?> 




而 Smarty 的模版就可以這樣寫(xiě)： (number_format 修飾函式請(qǐng)到Smarty 官方網(wǎng)頁(yè)下載)

<input name="total" type="hidden" value="<{$total}>" />

總金額：<{$total|number_format:""}> 元
Smarty 的 PHP 程序中只要這樣寫(xiě)：


<?php 
$total = 21000; 
$tpl->assign("total", $total); 
?> 




所以在 Smarty 中我們只要指定一次變量，剩下的交給模版自行決定即可。這樣了解了嗎？這就是讓模版自行決定變量呈現(xiàn)風(fēng)貌的好處！

控制模版的內(nèi)容

重復(fù)的區(qū)塊

在 Smarty 樣板中，我們要重復(fù)一個(gè)區(qū)塊有兩種方式： foreach 及 section 。而在程序中我們則要 assign 一個(gè)數(shù)組，這個(gè)數(shù)組中可以包含數(shù)組數(shù)組。就像下面這個(gè)例子：

首先我們來(lái)看 PHP 程序是如何寫(xiě)的：

test2.php:


<?php 
require "main.php"; 
$array1 = array(1 => "蘋(píng)果", 2 => "菠蘿", 3 => "香蕉", 4 => "芭樂(lè)"); 
$tpl->assign("array1", $array1); 
$array2 = array( 
array("index1" => "data1-1", "index2" => "data1-2", "index3" => "data1-3"), 
array("index1" => "data2-1", "index2" => "data2-2", "index3" => "data2-3"), 
array("index1" => "data3-1", "index2" => "data3-2", "index3" => "data3-3"), 
array("index1" => "data4-1", "index2" => "data4-2", "index3" => "data4-3"), 
array("index1" => "data5-1", "index2" => "data5-2", "index3" => "data5-3")); 
$tpl->assign("array2", $array2); 
$tpl->display("test2.htm"); 
?> 




而模版的寫(xiě)法如下：

templates/test2.htm:

<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=big5"> 
<title>測(cè)試重復(fù)區(qū)塊</title> 
</head> 
<body> 
<pre> 
利用 foreach 來(lái)呈現(xiàn) array1 
<{foreach item=item1 from=$array1}> 
<{$item1}> 
<{/foreach}> 
利用 section 來(lái)呈現(xiàn) array1 
<{section name=sec1 loop=$array1}> 
<{$array1[sec1]}> 
<{/section}> 
利用 foreach 來(lái)呈現(xiàn) array2 
<{foreach item=index2 from=$array2}> 
<{foreach key=key2 item=item2 from=$index2}> 
<{$key2}>: <{$item2}> 
<{/foreach}> 
<{/foreach}> 
利用 section 來(lái)呈現(xiàn) array1 
<{section name=sec2 loop=$array2}> 
index1: <{$array2[sec2].index1}> 
index2: <{$array2[sec2].index2}> 
index3: <{$array2[sec2].index3}> 
<{/section}> 
</pre> 
</body> 
</html> 




執(zhí)行上例后，我們發(fā)現(xiàn)不管是 foreach 或 section 兩個(gè)執(zhí)行結(jié)果是一樣的。那么兩者到底有何不同呢？

第一個(gè)差別很明顯，就是foreach 要以巢狀處理的方式來(lái)呈現(xiàn)我們所 assign 的兩層數(shù)組變量，而 section 則以「主數(shù)組[循環(huán)名稱(chēng)].子數(shù)組索引」即可將整個(gè)數(shù)組呈現(xiàn)出來(lái)。由此可知， Smarty 在模版中的 foreach 和 PHP 中的 foreach 是一樣的；而 section 則是 Smarty 為了處理如上列的數(shù)組變量所發(fā)展出來(lái)的敘述。當(dāng)然 section 的功能還不只如此，除了下一節(jié)所談到的巢狀資料呈現(xiàn)外，官方手冊(cè)中也提供了好幾個(gè) section 的應(yīng)用范例。

不過(guò)要注意的是，丟給 section 的數(shù)組索引必須是從 0 開(kāi)始的正整數(shù)，即 0, 1, 2, 3, ...。如果您的數(shù)組索引不是從 0 開(kāi)始的正整數(shù)，那么就得改用 foreach 來(lái)呈現(xiàn)您的資料。您可以參考官方討論區(qū)中的此篇討論，其中探討了 section 和 foreach 的用法。

巢狀資料的呈現(xiàn)

模版引擎里最令人傷腦筋的大概就是巢狀資料的呈現(xiàn)吧，許多著名的模版引擎都會(huì)特意強(qiáng)調(diào)這點(diǎn)，不過(guò)這對(duì) Smarty 來(lái)說(shuō)卻是小兒科。

最常見(jiàn)到的巢狀資料，就算論譠程序中的討論主題區(qū)吧。假設(shè)要呈現(xiàn)的結(jié)果如下：

公告區(qū)

站務(wù)公告

文學(xué)專(zhuān)區(qū)

好書(shū)介紹

奇文共賞

計(jì)算機(jī)專(zhuān)區(qū)

硬件外圍

軟件討論

程序中我們先以靜態(tài)資料為例：

test3.php:


<?php 
require "main.php"; 
$forum = array( 
array("category_id" => 1, "category_name" => "公告區(qū)", 
"topic" => array( 
array("topic_id" => 1, "topic_name" => "站務(wù)公告") 
) 
), 
array("category_id" => 2, "category_name" => "文學(xué)專(zhuān)區(qū)", 
"topic" => array( 
array("topic_id" => 2, "topic_name" => "好書(shū)介紹"), 
array("topic_id" => 3, "topic_name" => "奇文共賞") 
) 
), 
array("category_id" => 3, "category_name" => "計(jì)算機(jī)專(zhuān)區(qū)", 
"topic" => array( 
array("topic_id" => 4, "topic_name" => "硬件外圍"), 
array("topic_id" => 5, "topic_name" => "軟件討論") 
) 
) 
); 
$tpl->assign("forum", $forum); 
$tpl->display("test3.htm"); 
?> 




模版的寫(xiě)法如下：

templates/test3.htm:

<html> 
<head> 
<title>巢狀循環(huán)測(cè)試</title> 
</head> 
<body> 
<table width="200" border="0" align="center" cellpadding="3" cellspacing="0"> 
<{section name=sec1 loop=$forum}> 
<tr> 
<td colspan="2"><{$forum[sec1].category_name}></td> 
</tr> 
<{section name=sec2 loop=$forum[sec1].topic}> 
<tr> 
<td width="25"> </td> 
<td width="164"><{$forum[sec1].topic[sec2].topic_name}></td> 
</tr> 
<{/section}> 
<{/section}> 
</table> 
</body> 
</html> 




執(zhí)行的結(jié)果就像筆者舉的例子一樣。

因此呢，在程序中我們只要想辦法把所要重復(fù)值一層一層的塞到數(shù)組中，再利用 <{第一層數(shù)組[循環(huán)1].第二層數(shù)組[循環(huán)2].第三層數(shù)組[循環(huán)3]. ... .數(shù)組索引}> 這樣的方式來(lái)顯示每一個(gè)巢狀循環(huán)中的值。至于用什么方法呢？下一節(jié)使用數(shù)據(jù)庫(kù)時(shí)我們?cè)偬帷?

轉(zhuǎn)換數(shù)據(jù)庫(kù)中的資料

上面提到如何顯示巢狀循環(huán)，而實(shí)際上應(yīng)用時(shí)我們的資料可能是從數(shù)據(jù)庫(kù)中抓取出來(lái)的，所以我們就得想辦法把數(shù)據(jù)庫(kù)的資料變成上述的多重?cái)?shù)組的形式。這里筆者用一個(gè) DB 類(lèi)別來(lái)抓取數(shù)據(jù)庫(kù)中的資料，您可以自行用您喜歡的方法。

我們只修改 PHP 程序，模版還是上面那個(gè) (這就是模版引擎的好處~)，其中 $db 這個(gè)對(duì)象假設(shè)已經(jīng)在 main.php 中建立好了，而且抓出來(lái)的資料就是上面的例子。

test3.php:


<?php 
require "main.php"; 
// 先建立第一層數(shù)組 
$category = array(); 
$db->setSQL($SQL1, @#CATEGORY@#); 
if (!$db->query(@#CATEGORY@#)) die($db->error()); 
// 抓取第一層循環(huán)的資料 
while ($item_category = $db->fetchAssoc(@#CATEGORY@#)) 
{ 
// 建立第二層數(shù)組 
$topic = array(); 
$db->setSQL(sprintf($SQL2, $item_category[@#category_id@#]), @#TOPIC@#); 
if (!$db->query(@#TOPIC@#)) die($db->error()); 
// 抓取第二層循環(huán)的資料 
while ($item_topic = $db->fetchAssoc(@#TOPIC@#)) 
{ 
// 把抓取的數(shù)據(jù)推入第二層數(shù)組中 
array_push($topic, $item_topic); 
} 
// 把第二層數(shù)組指定為第一層數(shù)組所抓取的數(shù)據(jù)中的一個(gè)成員 
$item_category[@#topic@#] = $topic; 
// 把第一層數(shù)據(jù)推入第一層數(shù)組中 
array_push($category, $item_category); 
} 
$tpl->assign("forum", $category); 
$tpl->display("test3.htm"); 
?> 




在數(shù)據(jù)庫(kù)抓取一筆資料后，我們得到的是一個(gè)包含該筆數(shù)據(jù)的數(shù)組。透過(guò) while 敘述及 array_push 函式，我們將數(shù)據(jù)庫(kù)中的資料一筆一筆塞到數(shù)組里。如果您只用到單層循環(huán)，就把第二層循環(huán) (紅色的部份) 去掉即可。

決定內(nèi)容是否顯示

要決定是否顯示內(nèi)容，我們可以使用 if 這個(gè)語(yǔ)法來(lái)做選擇。例如如果使用者已經(jīng)登入的話(huà)，我們的模版就可以這樣寫(xiě)：

<{if $is_login == true}>
顯示使用者操作選單
<{else}>
顯示輸入帳號(hào)和密碼的窗體
<{/if}>

要注意的是，「==」號(hào)兩邊一定要各留至少一個(gè)空格符，否則 Smarty 會(huì)無(wú)法解析。

if 語(yǔ)法一般的應(yīng)用可以參照官方使用說(shuō)明，所以筆者在這里就不詳加介紹了。不過(guò)筆者發(fā)現(xiàn)了一個(gè)有趣的應(yīng)用：常常會(huì)看到程序里要產(chǎn)生這樣的一個(gè)表格： (數(shù)字代表的是資料集的順序)

1 2

3 4

5 6

7 8

這個(gè)筆者稱(chēng)之為「橫向重復(fù)表格」。它的特色和傳統(tǒng)的縱向重復(fù)不同，前幾節(jié)我們看到的重復(fù)表格都是從上而下，一列只有一筆資料。而橫向重復(fù)表格則可以橫向地在一列中產(chǎn)生 n 筆資料后，再換下一列，直到整個(gè)循環(huán)結(jié)束。要達(dá)到這樣的功能，最簡(jiǎn)單的方式只需要 section 和 if 搭配即可。

我們來(lái)看看下面這個(gè)例子：

test4.php:


<?php 
require "main.php"; 
$my_array = array( 
array("value" => "0"), 
array("value" => "1"), 
array("value" => "2"), 
array("value" => "3"), 
array("value" => "4"), 
array("value" => "5"), 
array("value" => "6"), 
array("value" => "7"), 
array("value" => "8"), 
array("value" => "9")); 
$tpl->assign("my_array", $my_array); 
$tpl->display(@#test4.htm@#); 
?> 




模版的寫(xiě)法如下：

templates/test4.htm:

<html> 
<head> 
<title>橫向重復(fù)表格測(cè)試</title> 
</head> 
<body> 
<table width="500" border="1" cellspacing="0" cellpadding="3"> 
<tr> 
<{section name=sec1 loop=$my_array}> 
<td><{$my_array[sec1].value}></td> 
<{if $smarty.section.sec1.rownum is div by 2}> 
</tr> 
<tr> 
<{/if}> 
<{/section}> 
</tr> 
</table> 
</body> 
</html> 




重點(diǎn)在于 $smarty.section.sec1.rownum 這個(gè) Smarty 變量，在 section 循環(huán)中這個(gè)變量會(huì)取得從 1 開(kāi)始的索引值，所以當(dāng) rownum 能被 2 除盡時(shí)，就輸出 </tr><tr> 使表格換列 (注意！是 </tr> 在前面<tr> 在后面) 。因此數(shù)字 2 就是我們?cè)谝涣兄邢胍尸F(xiàn)的資料筆數(shù)。各位可以由此去變化其它不同的呈現(xiàn)方式。

加載外部?jī)?nèi)容

我們可以在模版內(nèi)加載 PHP 程序代碼或是另一個(gè)子模版，分別是使用 include_php 及 include 這兩個(gè) Smarty 模版語(yǔ)法； include_php 筆者較少用，使用方式可以查詢(xún)官方手冊(cè)，這里不再敘述。

在使用 include 時(shí)，我們可以預(yù)先加載子模版，或是動(dòng)態(tài)加載子模版。預(yù)先加載通常使用在有共同的文件標(biāo)頭及版權(quán)宣告；而動(dòng)態(tài)加載則可以用在統(tǒng)一的框架頁(yè)，而進(jìn)一步達(dá)到如 Winamp 般可換 Skin 。當(dāng)然這兩種我們也可以混用，視狀況而定。

我們來(lái)看看下面這個(gè)例子：

test5.php:


<?php 
require "main.php"; 
$tpl->assign("title", "Include 測(cè)試"); 
$tpl->assign("content", "這是模版 2 中的變量"); 
$tpl->assign("dyn_page", "test5_3.htm"); 
$tpl->display(@#test5_1.htm@#); 
?> 




模版 1 的寫(xiě)法如下：

templates/test5_1.htm:

<html> 
<head> 
<meta http-equiv="Content-Type" content="text/html; charset=big5"> 
<title><{$title}></title> 
</head> 
<body> 
<{include file="test5_2.htm"}><br /> 
<{include file=$dyn_page}> 
<{include file="test5_4.htm" custom_var="自訂變量的內(nèi)容"}> 
</body> 
</html> 




模版 2 的寫(xiě)法如下：

templates/test5_2.htm:

<{$content}>
模版 3 的寫(xiě)法如下：

templates/test5_3.htm:

這是模版 3 的內(nèi)容
模版 4 的寫(xiě)法如下：

templates/test5_4.htm:

<{$custom_var}>
這里注意幾個(gè)重點(diǎn)：1. 模版的位置都是以先前定義的 template_dir 為基準(zhǔn)；2. 所有 include 進(jìn)來(lái)的子模版中，其變量也會(huì)被解譯。；3. include 中可以用「變量名稱(chēng)=變量?jī)?nèi)容」來(lái)指定引含進(jìn)來(lái)的模版中所包含的變量，如同上面模版 4 的做法。