剛開(kāi)始接觸模版引擎的 PHP 設計師,聽(tīng)到 Smarty 時(shí),都會(huì )覺(jué)得很難。其實(shí)筆者也不例外,碰都不敢碰一下。但是后來(lái)在剖析 XOOPS 的程序架構時(shí),開(kāi)始發(fā)現 Smarty 其實(shí)并不難。只要將 Smarty 基礎功練好,在一般應用上就已經(jīng)相當足夠了。當然基礎能打好,后面的進(jìn)階應用也就不用怕了。
這篇文章的主要用意并非要深入探討 Smarty 的使用,這在官方使用說(shuō)明中都已經(jīng)寫(xiě)得很完整了。筆者僅在此寫(xiě)下一些自己使用上的心得,讓想要了解 Smarty 卻不得其門(mén)而入的朋友,可以從中得到一些啟示。就因為這篇文章的內容不是非常深入,會(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)現眼,但筆者相信這篇文章應該能夠滿(mǎn)足大多數想學(xué)習 Smarty 的初學(xué)者了。當然本文有謬誤的地方也歡迎告知,筆者會(huì )在下一次的修訂中更正的。
Smarty介紹
什么是模版引擎
不知道從什么時(shí)候開(kāi)始,有人開(kāi)始對 HTML 內嵌入 Server Script 覺(jué)得不太滿(mǎn)意。然而不論是微軟的 ASP 或是開(kāi)放源碼的 PHP,都是屬于內嵌 Server Script 的網(wǎng)頁(yè)伺服端語(yǔ)言。因此也就有人想到,如果能把程序應用邏輯 (或稱(chēng)商業(yè)應用邏輯) 與網(wǎng)頁(yè)呈現 (Layout) 邏輯分離的話(huà),是不是會(huì )比較好呢?
其實(shí)這個(gè)問(wèn)題早就存在已久,從交互式網(wǎng)頁(yè)開(kāi)始風(fēng)行時(shí),不論是 ASP 或是 PHP 的使用者都是身兼程序開(kāi)發(fā)者與視覺(jué)設計師兩種身份??墒峭ǔ_@些使用者不是程序強就是美工強,如果要兩者同時(shí)兼顧,那可得死掉不少腦細胞...
所以模版引擎就應運而生啦!模版引擎的目的,就是要達到上述提到的邏輯分離的功能。它能讓程序開(kāi)發(fā)者專(zhuān)注于資料的控制或是功能的達成;而視覺(jué)設計師則可專(zhuān)注于網(wǎng)頁(yè)排版,讓網(wǎng)頁(yè)看起來(lái)更具有專(zhuān)業(yè)感!因此模版引擎很適合公司的網(wǎng)站開(kāi)發(fā)團隊使用,使每個(gè)人都能發(fā)揮其專(zhuān)長(cháng)!
就筆者接觸過(guò)的模版引擎來(lái)說(shuō),依資料呈現方式大概分成:需搭配程序處理的模版引擎和完全由模版本身自行決定的模版引擎兩種形式。
在需搭配程序處理的模版引擎中,程序開(kāi)發(fā)者必須要負責變量的呈現邏輯,也就是說(shuō)他必須把變量的內容在輸出到模版前先處理好,才能做 assign 的工作。換句話(huà)說(shuō),程序開(kāi)發(fā)者還是得多寫(xiě)一些程序來(lái)決定變量呈現的風(fēng)貌。而完全由模版本身自行決定的模版引擎,它允許變量直接 assign 到模版中,讓視覺(jué)設計師在設計模版時(shí)再決定變量要如何呈現。因此它就可能會(huì )有另一套屬于自己的模版程序語(yǔ)法 (如 Smarty) ,以方便控制變量的呈現。但這樣一來(lái),視覺(jué)設計師也得學(xué)習如何使用模版語(yǔ)言。
模版引擎的運作原理,首先我們先看看以下的運行圖:
一般的模版引擎 (如 PHPLib) 都是在建立模版對象時(shí)取得要解析的模版,然后把變量套入后,透過(guò) parse() 這個(gè)方法來(lái)解析模版,最后再將網(wǎng)頁(yè)輸出。
對 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)作,直接執行編譯過(guò)的網(wǎng)頁(yè),以節省編譯的時(shí)間。
使用Smarty的一些概念
在一般模版引擎中,我們??吹絽^域的觀(guān)念,所謂區塊大概都會(huì )長(cháng)成這樣:
<!-- START : Block name -->
區域內容
<!-- END : Block name -->
這些區塊大部份都會(huì )在 PHP 程序中以 if 或 for, while 來(lái)控制它們的顯示狀態(tài),雖然模版看起來(lái)簡(jiǎn)潔多了,但只要一換了顯示方式不同的模版, PHP 程序勢必要再改一次!
在 Smarty 中,一切以變量為主,所有的呈現邏輯都讓模版自行控制。因為 Smarty 會(huì )有自己的模版語(yǔ)言,所以不管是區塊是否要顯示還是要重復,都是用 Smarty 的模版語(yǔ)法 (if, foreach, section) 搭配變量?jì)热葑鞒尸F。這樣一來(lái)感覺(jué)上好象模版變得有點(diǎn)復雜,但好處是只要規劃得當, PHP 程序一行都不必改。
由上面的說(shuō)明,我們可以知道使用Smarty 要掌握一個(gè)原則:將程序應用邏輯與網(wǎng)頁(yè)呈現邏輯明確地分離。就是說(shuō) PHP 程序里不要有太多的 HTML 碼。程序中只要決定好那些變量要塞到模版里,讓模版自己決定該如何呈現這些變量 (甚至不出現也行) 。
Smarty的基礎
安裝Smarty
首先,我們先決定程序放置的位置。
Windows下可能會(huì )類(lèi)似這樣的位置:「 d:\appserv\web\demo\ 」。
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 中應該會(huì )有 3 個(gè) class.php 檔 + 1 個(gè) debug.tpl + 1 個(gè) plugin 資料夾 + 1 個(gè) core 資料夾。然后直接將 libs 復制到您的程序主資料夾下,再更名為 class 就可以了。就這樣?沒(méi)錯!這種安裝法比較簡(jiǎn)單,適合一般沒(méi)有自己主機的使用者。
至于 Smarty 官方手冊中為什么要介紹一些比較復雜的安裝方式呢?基本上依照官方的方式安裝,可以只在主機安裝一次,然后提供給該主機下所有設計者開(kāi)發(fā)不同程序時(shí)直接引用,而不會(huì )重復安裝太多的 Smarty 復本。而筆者所提供的方式則是適合要把程序帶過(guò)來(lái)移過(guò)去的程序開(kāi)發(fā)者使用,這樣不用煩惱主機有沒(méi)有安裝 Smarty 。
程序的資料夾設定
以筆者在Windows安裝Appserv為例,程序的主資料夾是「d:\appserv\web\demo\」。安裝好Smarty后,我們在主資料夾下再建立這樣的資料夾:
在 Linux 底下,請記得將 templates_c 的權限變更為 777 。Windows 下則將其只讀取消。
第一個(gè)用Smarty寫(xiě)的小程序
我們先設定 Smarty 的路徑,請將以下這個(gè)檔案命名為 main.php ,并放置到主資料夾下:
main.php:
<?php
include "class/Smarty.class.php";
define(‘__SITE_ROOT‘, ‘d:/appserv/web/demo‘); // 最后沒(méi)有斜線(xiàn)
$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 的模版路徑設定好后,程序會(huì )依照這個(gè)路徑來(lái)抓所有模版的相對位置 (范例中是 ‘d:/appserv/web/demo/templates/‘ ) 。然后我們用 display() 這個(gè) Smarty 方法來(lái)顯示我們的模版。
接下來(lái)我們在 templates 資料夾下放置一個(gè) test.htm:(擴展名叫什么都無(wú)所謂,但便于視覺(jué)設計師開(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>
現在我們要將上面的模版顯示出來(lái),并將網(wǎng)頁(yè)標題 ($title) 與內容 ($content) 更換,請將以下檔案內容命名為 test.php ,并放置在主資料夾下:
test.php:
<?php
require "main.php";
$tpl->assign("title", "測試用的網(wǎng)頁(yè)標題");
$tpl->assign("content", "測試用的網(wǎng)頁(yè)內容");
// 上面兩行也可以用這行代替
// $tpl->assign(array("title" => "測試用的網(wǎng)頁(yè)標題", "content" => "測試用的網(wǎng)頁(yè)內容"));
$tpl->display(‘test.htm‘);
?>
請打開(kāi)瀏覽器,輸入 http://localhost/demo/test.php 試試看(依您的環(huán)境決定網(wǎ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)錯,這就是 Smarty 編譯過(guò)的檔案。它將我們在模版中的變量轉換成了 PHP 的語(yǔ)法來(lái)執行,下次再讀取同樣的內容時(shí), Smarty 就會(huì )直接抓取這個(gè)檔案來(lái)執行了。
最后我們整理一下整個(gè) Smarty 程序撰寫(xiě)步驟:
Step 1. 加載 Smarty 模版引擎。
Step 2. 建立 Smarty 對象。
Step 3. 設定 Smarty 對象的參數。
Step 4. 在程序中處理變量后,再用 Smarty 的 assign 方法將變量置入模版里。
Step 5. 利用 Smarty 的 display 方法將網(wǎng)頁(yè)秀出。
如何安排你的程序架構
上面我們看到除了 Smarty 所需要的資料夾外 (class 、 configs 、 templates 、 templates_c) ,還有兩個(gè)資料夾: includes 、 modules 。其實(shí)這是筆者模仿 XOOPS 的架構所建立出來(lái)的,因為 XOOPS 是筆者所接觸到的程序中,少數使用 Smarty 模版引擎的架站程序。所謂西瓜偎大邊,筆者這樣的程序架構雖沒(méi)有 XOOPS 的百分之一強,但至少給人看時(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)有斜線(xiàn)
// 以 main.php 的位置為基準
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ì )把程序丟得到處都是,整體架構一目了然。
上面我們也提到 main.php ,這是整個(gè)程序的主要核心,不論是常數定義、外部程序加載、共享變量建立等,都是在這里開(kāi)始的。所以之后的模塊都只要將這個(gè)檔案包含進(jìn)來(lái)就可以啦。因此在程序流程規劃期間,就必須好好構思 main.php 中應該要放那些東西;當然利用 include 或 require 指令,把每個(gè)環(huán)節清楚分離是再好不過(guò)了。
在上節提到的 Smarty 程序 5 步驟, main.php 就會(huì )幫我們先將前 3 個(gè)步驟做好,后面的模塊程序只要做后面兩個(gè)步驟就可以了。
從變量開(kāi)始
如何使用變量
從上一章范例中,我們可以清楚地看到我們利用 <{ 及 }> 這兩個(gè)標示符號將變量包起來(lái)。預設的標示符號為 { 及 } ,但為了中文沖碼及 Javascript 的關(guān)系,因此筆者還是模仿 XOOPS ,將標示符號換掉。變量的命名方式和 PHP 的變量命名方式是一模一樣的,前面也有個(gè) $ 字號 (這和一般的模版引擎不同)。標示符號就有點(diǎn)像是 PHP 中的 <?php 及 ?> (事實(shí)上它們的確會(huì )被替換成這個(gè)) ,所以以下的模版變量寫(xiě)法都是可行的:
1. <{$var}>
2. <{ $var }> <!-- 和變量之間有空格 -->
3. <{$var
}> <!-- 啟始的標示符號和結束的標示符號不在同一行 -->
在 Smarty 里,變量預設是全域的,也就是說(shuō)你只要指定一次就好了。指定兩次以上的話(huà),變量?jì)热輹?huì )以最后指定的為主。就算我們在主模版中加載了外部的子模版,子模版中同樣的變量一樣也會(huì )被替代,這樣我們就不用再針對子模版再做一次解析的動(dòng)作。
而在 PHP 程序中,我們用 Smarty 的 assign 來(lái)將變量置放到模版中。 assign 的用法官方手冊中已經(jīng)寫(xiě)得很多了,用法就如同上一節的范例所示。不過(guò)在重復區塊時(shí),我們就必須將變量做一些手腳后,才能將變量 assign 到模版中,這在下一章再提。
修飾你的變量
上面我們提到 Smarty 變量呈現的風(fēng)貌是由模版自行決定的,所以 Smarty 提供了許多修飾變量的函式。使用的方法如下:
<{變量|修飾函式}> <!-- 當修飾函式?jīng)]有參數時(shí) -->
<{變量|修飾函式:"參數(非必要,視函式而定)"}> <!-- 當修飾函式有參數時(shí) -->
范例如下:
<{$var|nl2br}> <!-- 將變量中的換行字符換成 <br /> -->
<{$var|string_format:"%02d"}> <!-- 將變量格式化 -->
好,那為什么要讓模版自行決定變量呈現的風(fēng)貌?先看看底下的 HTML ,這是某個(gè)購物車(chē)結帳的部份畫(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 修飾函式請到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 中我們只要指定一次變量,剩下的交給模版自行決定即可。這樣了解了嗎?這就是讓模版自行決定變量呈現風(fēng)貌的好處!
控制模版的內容
重復的區塊
在 Smarty 樣板中,我們要重復一個(gè)區塊有兩種方式: foreach 及 section 。而在程序中我們則要 assign 一個(gè)數組,這個(gè)數組中可以包含數組數組。就像下面這個(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>測試重復區塊</title>
</head>
<body>
<pre>
利用 foreach 來(lái)呈現 array1
<{foreach item=item1 from=$array1}>
<{$item1}>
<{/foreach}>
利用 section 來(lái)呈現 array1
<{section name=sec1 loop=$array1}>
<{$array1[sec1]}>
<{/section}>
利用 foreach 來(lái)呈現 array2
<{foreach item=index2 from=$array2}>
<{foreach key=key2 item=item2 from=$index2}>
<{$key2}>: <{$item2}>
<{/foreach}>
<{/foreach}>
利用 section 來(lái)呈現 array1
<{section name=sec2 loop=$array2}>
index1: <{$array2[sec2].index1}>
index2: <{$array2[sec2].index2}>
index3: <{$array2[sec2].index3}>
<{/section}>
</pre>
</body>
</html>
執行上例后,我們發(fā)現不管是 foreach 或 section 兩個(gè)執行結果是一樣的。那么兩者到底有何不同呢?
第一個(gè)差別很明顯,就是foreach 要以巢狀處理的方式來(lái)呈現我們所 assign 的兩層數組變量,而 section 則以「主數組[循環(huán)名稱(chēng)].子數組索引」即可將整個(gè)數組呈現出來(lái)。由此可知, Smarty 在模版中的 foreach 和 PHP 中的 foreach 是一樣的;而 section 則是 Smarty 為了處理如上列的數組變量所發(fā)展出來(lái)的敘述。當然 section 的功能還不只如此,除了下一節所談到的巢狀資料呈現外,官方手冊中也提供了好幾個(gè) section 的應用范例。
不過(guò)要注意的是,丟給 section 的數組索引必須是從 0 開(kāi)始的正整數,即 0, 1, 2, 3, ...。如果您的數組索引不是從 0 開(kāi)始的正整數,那么就得改用 foreach 來(lái)呈現您的資料。您可以參考官方討論區中的此篇討論,其中探討了 section 和 foreach 的用法。
巢狀資料的呈現
模版引擎里最令人傷腦筋的大概就是巢狀資料的呈現吧,許多著(zhù)名的模版引擎都會(huì )特意強調這點(diǎn),不過(guò)這對 Smarty 來(lái)說(shuō)卻是小兒科。
最常見(jiàn)到的巢狀資料,就算論譠程序中的討論主題區吧。假設要呈現的結果如下:
公告區
站務(wù)公告
文學(xué)專(zhuān)區
好書(shū)介紹
奇文共賞
計算機專(zhuān)區
硬件外圍
軟件討論
程序中我們先以靜態(tài)資料為例:
test3.php:
<?php
require "main.php";
$forum = array(
array("category_id" => 1, "category_name" => "公告區",
"topic" => array(
array("topic_id" => 1, "topic_name" => "站務(wù)公告")
)
),
array("category_id" => 2, "category_name" => "文學(xué)專(zhuān)區",
"topic" => array(
array("topic_id" => 2, "topic_name" => "好書(shū)介紹"),
array("topic_id" => 3, "topic_name" => "奇文共賞")
)
),
array("category_id" => 3, "category_name" => "計算機專(zhuān)區",
"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)測試</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>
執行的結果就像筆者舉的例子一樣。
因此呢,在程序中我們只要想辦法把所要重復值一層一層的塞到數組中,再利用 <{第一層數組[循環(huán)1].第二層數組[循環(huán)2].第三層數組[循環(huán)3]. ... .數組索引}> 這樣的方式來(lái)顯示每一個(gè)巢狀循環(huán)中的值。至于用什么方法呢?下一節使用數據庫時(shí)我們再提。
轉換數據庫中的資料
上面提到如何顯示巢狀循環(huán),而實(shí)際上應用時(shí)我們的資料可能是從數據庫中抓取出來(lái)的,所以我們就得想辦法把數據庫的資料變成上述的多重數組的形式。這里筆者用一個(gè) DB 類(lèi)別來(lái)抓取數據庫中的資料,您可以自行用您喜歡的方法。
我們只修改 PHP 程序,模版還是上面那個(gè) (這就是模版引擎的好處~),其中 $db 這個(gè)對象假設已經(jīng)在 main.php 中建立好了,而且抓出來(lái)的資料就是上面的例子。
test3.php:
<?php
require "main.php";
// 先建立第一層數組
$category = array();
$db->setSQL($SQL1, ‘CATEGORY‘);
if (!$db->query(‘CATEGORY‘)) die($db->error());
// 抓取第一層循環(huán)的資料
while ($item_category = $db->fetchAssoc(‘CATEGORY‘))
{
// 建立第二層數組
$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‘))
{
// 把抓取的數據推入第二層數組中
array_push($topic, $item_topic);
}
// 把第二層數組指定為第一層數組所抓取的數據中的一個(gè)成員
$item_category[‘topic‘] = $topic;
// 把第一層數據推入第一層數組中
array_push($category, $item_category);
}
$tpl->assign("forum", $category);
$tpl->display("test3.htm");
?>
在數據庫抓取一筆資料后,我們得到的是一個(gè)包含該筆數據的數組。透過(guò) while 敘述及 array_push 函式,我們將數據庫中的資料一筆一筆塞到數組里。如果您只用到單層循環(huán),就把第二層循環(huán) (紅色的部份) 去掉即可。
決定內容是否顯示
要決定是否顯示內容,我們可以使用 if 這個(gè)語(yǔ)法來(lái)做選擇。例如如果使用者已經(jīng)登入的話(huà),我們的模版就可以這樣寫(xiě):
<{if $is_login == true}>
顯示使用者操作選單
<{else}>
顯示輸入賬號和密碼的窗體
<{/if}>
要注意的是,「==」號兩邊一定要各留至少一個(gè)空格符,否則 Smarty 會(huì )無(wú)法解析。
if 語(yǔ)法一般的應用可以參照官方使用說(shuō)明,所以筆者在這里就不詳加介紹了。不過(guò)筆者發(fā)現了一個(gè)有趣的應用:常常會(huì )看到程序里要產(chǎn)生這樣的一個(gè)表格: (數字代表的是資料集的順序)
1 2
3 4
5 6
7 8
這個(gè)筆者稱(chēng)之為「橫向重復表格」。它的特色和傳統的縱向重復不同,前幾節我們看到的重復表格都是從上而下,一列只有一筆資料。而橫向重復表格則可以橫向地在一列中產(chǎn)生 n 筆資料后,再換下一列,直到整個(gè)循環(huán)結束。要達到這樣的功能,最簡(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>橫向重復表格測試</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)始的索引值,所以當 rownum 能被 2 除盡時(shí),就輸出 </tr><tr> 使表格換列 (注意!是 </tr> 在前面<tr> 在后面) 。因此數字 2 就是我們在一列中想要呈現的資料筆數。各位可以由此去變化其它不同的呈現方式。
加載外部?jì)热?div style="height:15px;">
我們可以在模版內加載 PHP 程序代碼或是另一個(gè)子模版,分別是使用 include_php 及 include 這兩個(gè) Smarty 模版語(yǔ)法; include_php 筆者較少用,使用方式可以查詢(xún)官方手冊,這里不再敘述。
在使用 include 時(shí),我們可以預先加載子模版,或是動(dòng)態(tài)加載子模版。預先加載通常使用在有共同的文件標頭及版權宣告;而動(dòng)態(tài)加載則可以用在統一的框架頁(yè),而進(jìn)一步達到如 Winamp 般可換 Skin 。當然這兩種我們也可以混用,視狀況而定。
這里注意幾個(gè)重點(diǎn):1. 模版的位置都是以先前定義的 template_dir 為基準;2. 所有 include 進(jìn)來(lái)的子模版中,其變量也會(huì )被解譯。;3. include 中可以用「變量名稱(chēng)=變量?jì)热荨箒?lái)指定引含進(jìn)來(lái)的模版中所包含的變量,如同上面模版 4 的做法。