include_once("./comm/Smarty.class.php"); //包含smarty類文件
$smarty = new Smarty(); //建立smarty實例對象$smarty
$smarty->templates("./templates"); //設置模板目錄
$smarty->templates_c("./templates_c"); //設置編譯目錄
//****大家注意,這裡我是我新加入的****//
$smarty->cache("./cache"); //設置緩存目錄
$smarty->cache_lifetime = 60 * 60 * 24; //設置緩存時間
$smarty->caching = true; //設置緩存方式
//----------------------------------------------------
//左右邊界符,默認為{},但實際應用當中容易與JavaScript
//相沖突,所以建議設成<{}>或其它。
//----------------------------------------------------
$smarty->left_delimiter = "<{";
$smarty->right_delimiter = "}>";
$smarty->assign("name", "李曉軍"); //進行模板變量替換
//編譯並顯示位於./templates下的index.tpl模板
$smarty->display("index.tpl");
?>
我們可以看到,smarty的程序部分實際就是符合php語言規范的一組代碼,我們依次來解釋一下:
1。/**/語句:
包含的部分為程序篇頭注釋。主要的內容應該為對程序的作用,版權與作者及編寫時間做一個簡單的介紹,這在smarty中不是必
需的,但從程序的風格來講,這是一個好的風格。
2。include_once語句:
它將安裝到網站的smarty文件包含到當前文件中,注意包含的路徑一定要寫正確。
3。$smarty = new Smarty():
這一句新建一個Smarty對象$smarty,簡單的一個對象的實例化。
4。$smarty->templates(""):
這一句指明$smarty對象使用tpl模板時的路徑,它是一個目錄,在沒有這一句時,Smarty默認的模板路徑為當前目錄的templates
目錄,實際在寫程序時,我們要將這一句寫明,這也是一種好的程序風格。
5。$smarty->templates_c(""):
這一句指明$smarty對象進行編譯時的目錄。在模板設計篇我們已經知道Smarty是一種編譯型模板語言,而這個目錄,就是它編譯
模板的目錄,這裡要注意,如果站點位於*nix服務器上,請確保teamplates_c裡定義的這個目錄具有可寫可讀權限,默認情況下它的編譯目錄
是當前目錄下的templates_c,出於同樣的理由我們將其明確的寫出來。
6。$smarty->left_delimiter與$smarty->right_delimiter:
指明在查找模板變量時的左右分割符。默認情況下為"{"與"}",但在實際中因為我們要在模板中使用<script>,Script中的函數定
義難免會使用{},雖然它有自己的解決辦法,但習慣上我們將它重新定義為"<{"與"}>"或是"<!--{"與"}-->"或其它標志符,注意,如果在這裡
定義了左右分割符後,在模板文件中相應的要使每一個變量使用與定義相同的符號,例如在這裡指定為"<{"與"}>",tpl模板中也要相應的將
{$name}變成<{$name}>,這樣程序才可以正確的找到模板變量。
7。$smarty->cache("./cache"):
告訴Smarty輸出的模板文件緩存的位置。上一篇我們知道Smarty最大的優點在於它可以緩存,這裡就是設置緩存的目錄。默認情
況下為當前目錄下的cache目錄,與templates_c目錄相當,在*nix系統中我們要確保它的可讀可寫性。
8. $smarty->cache_lifetime = 60 * 60 * 24:
這裡將以秒為單位進行計算緩存有效的時間。第一次緩存時間到期時當Smarty的caching變量設置為true時緩存將被重建。當它的
取值為-1時表示建立起的緩存從不過期,為0時表示在程序每次執行時緩存總是被重新建立。上面的設置表示將cache_lifetime設置為一天。
9. $smarty->caching = 1:
這個屬性告訴Smarty是否要進行緩存以及緩存的方式。它可以取3個值,0:Smarty默認值,表示不對模板進行緩存;1:表示
Smarty將使用當前定義的cache_lifetime來決定是否結束cache;2:表示Smarty將使用在cache被建立時使用cache_lifetime這個值。習慣上使
用true與false來表示是否進行緩存。
10. $smarty->assign("name", "李曉軍"):
該數的原型為assign(string varname, mixed var),varname為模板中使用的模板變量,var指出要將模板變量替換的變量名;其
第二種原形為assign(mixed var),我們要在後面的例子詳細的講解這個成員函數的使用方法,assign是Smarty的核心函數之一,所有對模板變
量的替換都要使用它。
11. $smarty->display("index.tpl"):
該函數原形為display(string varname),作用為顯示一個模板。簡單的講,它將分析處理過的模板顯示出來,這裡的模板文件不
用加路徑,只要使用一個文件名就可以了,它路徑我們已經在$smarty->templates(string path)中定義過了。
程序執行完後我們可以打開當前目錄下的templates_c與cache目錄,就會發現在下邊多出一些%%的目錄,這些目錄就是Smarty的編譯與
緩存目錄,它由程序自動生成,不要直接對這些生成的文件進行修改。
以上我簡單的把Smarty程序中的一些常用的基本元素介紹了一下,在後邊的例子中你可以看到將它們將被多次的使用。
接下來介紹一個section循環塊與foreach循環塊,本來它應該屬於模板部分,但是由於它們是smarty的精華所在,而且與smarty程序設計
部分聯系非常緊密,所以就在本節單獨拿出來講一下。
1. foreach:用於循環簡單數組,它是一個選擇性的section循環,它的定義格式為:
{foreach from=$array item=array_id}
{foreachelse}
{/foreach}
其中,from 指出要循環的數組變量,item為要循環的變量名稱,循環次數由from所指定的數組變量的個數所決定。{foreachelse}用來當
程序中傳遞過來的數組為空時的處理,下面是一個簡單的例子:
===========================================
example6.tpl
===========================================
<html>
<head><title>這是一個foreach使用的例子</title></head>
<body>
這裡將輸出一個數組:<br>
{foreach from=$newsArray item=newsID}
新聞編號:{$newsID}<br>
新聞內容:{$newsTitle}<br><hr>
{foreachelse}
對不起,數據庫中沒有新聞輸出!
{/foreach}
</body>
</html>
==========================================
example6.php
==========================================
<?php
/*********************************************
*
* 文件名: example6.php
* 作 用: 顯示實例程序2
*
* 作 者: 大師兄
* Email: [email protected]
*
*********************************************/
include_once("./comm/Smarty.class.php");
$smarty = new Smarty();
$smarty->templates("./templates"); //一般不要,要了出錯.自己實驗得出
$smarty->templates_c("./templates_c"); //一般不要,要了出錯.自己實驗得
$smarty->cache("./cache"); //一般不要,要了出錯.自己實驗得
$smarty->cache_lifetime = 0; //一般不要,要了出錯.自己實驗得
$smarty->caching = true; //一般不要,要了出錯.自己實驗得
$smarty->left_delimiter = "<{";
$smarty->right_delimiter = "}>";
$array[] = array("newsID"=>1, "newsTitle"=>"第1條新聞");
$array[] = array("newsID"=>2, "newsTitle"=>"第2條新聞");
$array[] = array("newsID"=>3, "newsTitle"=>"第3條新聞");
$array[] = array("newsID"=>4, "newsTitle"=>"第4條新聞");
$array[] = array("newsID"=>5, "newsTitle"=>"第5條新聞");
$array[] = array("newsID"=>6, "newsTitle"=>"第6條新聞");
$smarty->assign("newsArray", $array);
//編譯並顯示位於./templates下的index.tpl模板
$smarty->display("example6.tpl");
?>