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