<?php
/*********************************************
*
* 文件名： index.php
* 作 用： 顯示實(shí)例程序
*
* 作 者： 大師兄
* Email： teacherli@163.com
*
*********************************************/
include_once("./comm/Smarty.class.php"); //包含smarty類(lèi)文件
$smarty = new Smarty(); //建立smarty實(shí)例對象$smarty
$smarty->templates("./templates"); //設置模板目錄
$smarty->templates_c("./templates_c"); //設置編譯目錄
//****大家注意，這里我是我新加入的****//
$smarty->cache("./cache"); //設置緩存目錄
$smarty->cache_lifetime = 60 * 60 * 24; //設置緩存時(shí)間
$smarty->caching = true; //設置緩存方式
//----------------------------------------------------
//左右邊界符，默認為{}，但實(shí)際應用當中容易與JavaScript
//相沖突，所以建議設成<{}>或其它。
//----------------------------------------------------
$smarty->left_delimiter = "<{";
$smarty->right_delimiter = "}>";
$smarty->assign("name", "李曉軍"); //進(jìn)行模板變量替換
//編譯并顯示位于./templates下的index.tpl模板
$smarty->display("index.tpl");
?>
我們可以看到，smarty的程序部分實(shí)際就是符合php語(yǔ)言規范的一組代碼，我們依次來(lái)解釋一下：
1。/**/語(yǔ)句：
包含的部分為程序篇頭注釋。主要的內容應該為對程序的作用，版權與作者及編寫(xiě)時(shí)間做一個(gè)簡(jiǎn)單的介紹，這在smarty中不是必
需的，但從程序的風(fēng)格來(lái)講，這是一個(gè)好的風(fēng)格。
2。include_once語(yǔ)句：
它將安裝到網(wǎng)站的smarty文件包含到當前文件中，注意包含的路徑一定要寫(xiě)正確。
3。$smarty = new Smarty():
這一句新建一個(gè)Smarty對象$smarty,簡(jiǎn)單的一個(gè)對象的實(shí)例化。
4。$smarty->templates(""):
這一句指明$smarty對象使用tpl模板時(shí)的路徑，它是一個(gè)目錄，在沒(méi)有這一句時(shí)，Smarty默認的模板路徑為當前目錄的templates
目錄，實(shí)際在寫(xiě)程序時(shí)，我們要將這一句寫(xiě)明，這也是一種好的程序風(fēng)格。
5。$smarty->templates_c(""):
這一句指明$smarty對象進(jìn)行編譯時(shí)的目錄。在模板設計篇我們已經(jīng)知道Smarty是一種編譯型模板語(yǔ)言，而這個(gè)目錄，就是它編譯
模板的目錄，這里要注意，如果站點(diǎn)位于*nix服務(wù)器上，請確保teamplates_c里定義的這個(gè)目錄具有可寫(xiě)可讀權限，默認情況下它的編譯目錄
是當前目錄下的templates_c，出于同樣的理由我們將其明確的寫(xiě)出來(lái)。
6。$smarty->left_delimiter與$smarty->right_delimiter:
指明在查找模板變量時(shí)的左右分割符。默認情況下為"{"與"}"，但在實(shí)際中因為我們要在模板中使用<script>,Script中的函數定
義難免會(huì )使用{}，雖然它有自己的解決辦法，但習慣上我們將它重新定義為"<{"與"}>"或是"<!--{"與"}-->"或其它標志符，注意，如果在這里
定義了左右分割符后，在模板文件中相應的要使每一個(gè)變量使用與定義相同的符號，例如在這里指定為"<{"與"}>"，tpl模板中也要相應的將
{$name}變成<{$name}>,這樣程序才可以正確的找到模板變量。
7。$smarty->cache("./cache"):
告訴Smarty輸出的模板文件緩存的位置。上一篇我們知道Smarty最大的優(yōu)點(diǎn)在于它可以緩存，這里就是設置緩存的目錄。默認情
況下為當前目錄下的cache目錄，與templates_c目錄相當，在*nix系統中我們要確保它的可讀可寫(xiě)性。
8. $smarty->cache_lifetime = 60 * 60 * 24:
這里將以秒為單位進(jìn)行計算緩存有效的時(shí)間。第一次緩存時(shí)間到期時(shí)當Smarty的caching變量設置為true時(shí)緩存將被重建。當它的
取值為-1時(shí)表示建立起的緩存從不過(guò)期，為0時(shí)表示在程序每次執行時(shí)緩存總是被重新建立。上面的設置表示將cache_lifetime設置為一天。
9. $smarty->caching = 1:
這個(gè)屬性告訴Smarty是否要進(jìn)行緩存以及緩存的方式。它可以取3個(gè)值，0：Smarty默認值，表示不對模板進(jìn)行緩存；1：表示
Smarty將使用當前定義的cache_lifetime來(lái)決定是否結束cache；2：表示Smarty將使用在cache被建立時(shí)使用cache_lifetime這個(gè)值。習慣上使
用true與false來(lái)表示是否進(jìn)行緩存。
10. $smarty->assign("name", "李曉軍")：
該數的原型為assign(string varname, mixed var),varname為模板中使用的模板變量，var指出要將模板變量替換的變量名；其
第二種原形為assign(mixed var),我們要在后面的例子詳細的講解這個(gè)成員函數的使用方法，assign是Smarty的核心函數之一，所有對模板變
量的替換都要使用它。
11. $smarty->display("index.tpl"):
該函數原形為display(string varname),作用為顯示一個(gè)模板。簡(jiǎn)單的講，它將分析處理過(guò)的模板顯示出來(lái)，這里的模板文件不
用加路徑，只要使用一個(gè)文件名就可以了，它路徑我們已經(jīng)在$smarty->templates(string path)中定義過(guò)了。
程序執行完后我們可以打開(kāi)當前目錄下的templates_c與cache目錄，就會(huì )發(fā)現在下邊多出一些%%的目錄，這些目錄就是Smarty的編譯與
緩存目錄，它由程序自動(dòng)生成，不要直接對這些生成的文件進(jìn)行修改。
以上我簡(jiǎn)單的把Smarty程序中的一些常用的基本元素介紹了一下，在后邊的例子中你可以看到將它們將被多次的使用。
接下來(lái)介紹一個(gè)section循環(huán)塊與foreach循環(huán)塊，本來(lái)它應該屬于模板部分，但是由于它們是smarty的精華所在，而且與smarty程序設計
部分聯(lián)系非常緊密，所以就在本節單獨拿出來(lái)講一下。
1. foreach：用于循環(huán)簡(jiǎn)單數組，它是一個(gè)選擇性的section循環(huán)，它的定義格式為:
{foreach from=$array item=array_id}
{foreachelse}
{/foreach}
其中，from 指出要循環(huán)的數組變量，item為要循環(huán)的變量名稱(chēng)，循環(huán)次數由from所指定的數組變量的個(gè)數所決定。{foreachelse}用來(lái)當
程序中傳遞過(guò)來(lái)的數組為空時(shí)的處理，下面是一個(gè)簡(jiǎn)單的例子：
===========================================
example6.tpl
===========================================
<html>
<head><title>這是一個(gè)foreach使用的例子</title></head>
<body>
這里將輸出一個(gè)數組：<br>
{foreach from=$newsArray item=newsID}
新聞編號：{$newsID}<br>
新聞內容：{$newsTitle}<br><hr>
{foreachelse}
對不起，數據庫中沒(méi)有新聞輸出！
{/foreach}
</body>
</html>
==========================================
example6.php
==========================================
<?php
/*********************************************
*
* 文件名： example6.php
* 作 用： 顯示實(shí)例程序2
*
* 作 者： 大師兄
* Email： teacherli@163.com
*
*********************************************/
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");
?>
=================================================
example6.php 輸出文件
=================================================
<html>
<head><title>foreach使用的例子</title></head>
<body>
這里將輸出一個(gè)數組：<br>
新聞編號：1<br>
新聞內容：第1條新聞<br><hr>
新聞編號：2<br>
新聞內容：第2條新聞<br><hr>
新聞編號：3<br>
新聞內容：第3條新聞<br><hr>
新聞編號：4<br>
新聞內容：第4條新聞<br><hr>
新聞編號：5<br>
新聞內容：第5條新聞<br><hr>
新聞編號：6<br>
新聞內容：第6條新聞<br><hr>
</body>
</html>
foreach還可以用foreachelse來(lái)匹配，用foreachelse來(lái)表示當傳遞給foreach的數組為空值時(shí)程序要執行的操作，具體的使用方法，請參考
手冊的說(shuō)明。
2. section:
section的產(chǎn)生是為解決foreach的不足的，與foreach一樣，它用于設計模板內的循環(huán)塊，它較為復雜，可極大程序上滿(mǎn)足程序需要，所
以在程序中我習慣使用它而不使用foreach,基本原形為：
{section name = name loop = $varName[, start = $start, step = $step, max = $max, show = true]}
name: section的名稱(chēng)，不用加$
$loop: 要循環(huán)的變量，在程序中要使用assign對這個(gè)變量進(jìn)行操作。
$start: 開(kāi)始循環(huán)的下標，循環(huán)下標默認由0開(kāi)始
$step: 每次循環(huán)時(shí)下標的增數
$max: 最大循環(huán)下標
$show: boolean類(lèi)型，決定是否對這個(gè)塊進(jìn)行顯示，默認為true
這里有個(gè)名詞需要說(shuō)明：
循環(huán)下標：實(shí)際它的英文名稱(chēng)為index，是索引的意思，這里我將它譯成"下標"，主要是為了好理解。它表示在顯示這個(gè)循環(huán)塊時(shí)當
前的循環(huán)索引，默認從0開(kāi)始，受$start的影響，如果將$start設為5，它也將從5開(kāi)始計數，在模板設計部分我們使用過(guò)它，這是當前
{section}的一個(gè)屬性，調用方式為Smarty.section.sectionName.index,這里的sectionName指的是函數原型中的name屬性。
{section}塊具有的屬性值，分別為：
1. index: 上邊我們介紹的"循環(huán)下標"，默認為0
2. index_prev: 當前下標的前一個(gè)值，默認為-1
3. index_next: 當前下標的下一個(gè)值，默認為1
4. first: 是否為第一下循環(huán)
5. last: 是否為最后一個(gè)循環(huán)
6. iteration: 循環(huán)次數
7. rownum: 當前的行號，iteration的另一個(gè)別名
8. loop: 最后一個(gè)循環(huán)號，可用在section塊后統計section的循環(huán)次數
9. total: 循環(huán)次數，可用在section塊后統計循環(huán)次數
10. show: 在函數的聲明中有它，用于判斷section是否顯示
它們的具體屬性大家可以參考手冊，在程序中可靈活使用它的這些屬性，模板部分我就使用過(guò)index屬性，大家可以回過(guò)頭去看看。
同樣，{section}也可以配合使用{sectionelse}，用來(lái)表示傳入的數組變量為空時(shí)對模板進(jìn)行的處理。
我們把上邊的那個(gè)例子使用{section}來(lái)替代{foreach}來(lái)實(shí)現現樣的功能，注意，在這個(gè)例子中我只將tpl模板中的{foreach}用
{section}來(lái)實(shí)現，php程序文件中沒(méi)有任何改動(dòng)，同時(shí)加了{sectionelse}處理塊：
===========================================
example7.tpl
===========================================
<html>
<head><title>這是一個(gè)foreach使用的例子</title></head>
<body>
這里將輸出一個(gè)數組：<br>
{section name=loop loop=$News}
新聞編號：{$News[loop].newsID}<br>
新聞標題：{$News[loop].newsTitle}<br><hr>
{sectionelse}
對不起，沒(méi)有任何新聞輸入！
{/section}
</body>
</html>
==========================================
example6.php
==========================================
<?php
/*********************************************
*
* 文件名： example7.php
* 作 用： 顯示實(shí)例程序2
*
* 作 者： 大師兄
* Email： teacherli@163.com
*
*********************************************/
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");
?>
=================================================
example7.php 輸出文件
=================================================
<html>
<head><title>foreach使用的例子</title></head>
<body>
這里將輸出一個(gè)數組：<br>
新聞編號：1<br>
新聞內容：第1條新聞<br><hr>
新聞編號：2<br>
新聞內容：第2條新聞<br><hr>
新聞編號：3<br>
新聞內容：第3條新聞<br><hr>
新聞編號：4<br>
新聞內容：第4條新聞<br><hr>
新聞編號：5<br>
新聞內容：第5條新聞<br><hr>
新聞編號：6<br>
新聞內容：第6條新聞<br><hr>
</body>
</html>
這里的{section}塊的對于變量的命名方式感覺(jué)有些別扭，不過(guò)沒(méi)關(guān)系，你只要記住模板變量使用：
$loopName[name].var這種模式就行了，loopName為loop處賦予的變量名，[name]為name處賦予的字符串，.后為為你要在程序數組中設定要
與值相對應的下標名稱(chēng)就行了。
好了，smarty學(xué)習指南---程序設計篇就寫(xiě)到這里，對于一般的應用，這些知識已經(jīng)夠用了，其它的一些高級技巧大家請參看手冊中的例子
，下一節將講講Smarty在實(shí)際應用中的例子，將分別以php內置的mysql語(yǔ)句，phplib中的DB類(lèi)，ADODB，Pear中DB類(lèi)來(lái)分別講一下各個(gè)類(lèi)庫在同一個(gè)例子中的實(shí)現。
--------------------------------------------------------------------------------
聯(lián)系客服
