smarty半小時快速上手入門教程

http://www.jb51.net/article/56754.htm

http://www.yiibai.com/smarty/smarty_functions.html

http://www.php100.com/manual/smarty/

本文講述了smarty快速上手入門的方法，可讓讀者在半小時內快速掌握smarty的用法。分享給你們供你們參考。具體實現方法以下：

1、smarty的程序設計部分：

在smarty的模板設計部分我簡單的把smarty在模板中的一些經常使用設置作了簡單的介紹，這一節主要來介紹一下如何在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模板 
?>

2、解釋smarty的程序

 

咱們能夠看到，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是一種編譯型模板語言，而這個目錄，就是它編譯模板的目錄，要注意，若是站點位於linux服務器上，請確保

teamplates_c裏定義的這個目錄具備可寫可讀權限，默認狀況下它的編譯目錄是當前目錄下的templates_c，出於一樣的理由咱們將其明確的寫出來。

6：$smarty->left_delimiter與$smarty->right_delimiter:

指明在查找模板變量時的左右分割符。默認狀況下爲"{"與"}"，但在實際中由於咱們要在模板中使用<script>,Script中的函數定義不免會使用{}，雖然它有本身的解決辦法，但習慣上咱們將它從新定義

爲"{#"與"#}"或是"<!--{"與"}-->"或其它標誌符，注意，若是在這裏定義了左右分割符後，在模板文件中相應的要使每個變量使用與定義相同的符號，例如在這裏指定爲"<{"與"}>"，htm模板中也要

相應的將{$name}變成<{$name}>,這樣程序才能夠正確的找到模板變量。

7：$smarty->cache("./cache"):

告訴Smarty輸出的模板文件緩存的位置。上一篇咱們知道Smarty最大的優勢在於它能夠緩存，這裏就是設置緩存的目錄。默認狀況下爲當前目錄下的cache目錄，與templates_c目錄至關，在linux系統中

咱們要確保它的可讀可寫性。

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", "zaocha")：

該數的原型爲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程序中的一些經常使用的基本元素介紹了一下，在後邊的例子中你能夠看到將它們將被屢次的使用。

3、模板說明

接下來介紹一個section循環塊與foreach循環塊，原本它應該屬於模板部分，可是因爲它們是smarty的精華所在，並且與smarty程序設計部分聯繫很是緊密，因此就在本節單獨拿出來說一下。

1： foreach：用於循環簡單數組，它是一個選擇性的section循環，它的定義格式爲:

 

複製代碼代碼以下:

{foreach from=$array item=array_id} 
{foreachelse} 
{/foreach}

其中，from 指出要循環的數組變量，item爲要循環的變量名稱，循環次數由from所指定的數組變量的個數所決定。{foreachelse}用來當程序中傳遞過來的數組爲空時的處理，下面是一個簡單的例子：

 

模板文件：

example.htm頁面以下：

 

複製代碼代碼以下:

foreach 輸出一個「二維關聯數組」的數據：

 

{#foreach item=new from=$news#}

新聞編號：{#$new.id#}

新聞內容：{#$new.title#}

{#foreachelse#}
數據庫中沒有新聞輸出!

{#/foreach#}

{foreach from=$newsArray item=newsID}
新聞編號：{$newsID}
新聞內容：{$newsTitle}
{foreachelse}
對不起，數據庫中沒有新聞輸出!

{/foreach}

這是一個錯誤的不顯示數據，本文作了更正。

 

程序文件：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條新聞"); 
//這是一個二維關聯數組 
$smarty->assign("newsArray", $array); 
//編譯並顯示位於./templates下的index.htm模板 
$smarty->display("example.htm"); 
?>

輸入結果：example.php輸出以下：

 

 

複製代碼代碼以下:

這裏將輸出一個數組：

 

新聞編號：1

新聞內容：第1條新聞

新聞編號：2

新聞內容：第2條新聞

新聞編號：3

新聞內容：第3條新聞

新聞編號：4

新聞內容：第4條新聞

新聞編號：5

新聞內容：第5條新聞

新聞編號：6

新聞內容：第6條新聞

 

foreach還能夠用foreachelse來匹配，用foreachelse來表示當傳遞給foreach的數組爲空值時程序要執行的操做，具體的使用方法，請參考手冊的說明。

2. section:

section的產生是爲解決foreach的不足的，與foreach同樣，它用於設計模板內的循環塊，它較爲複雜，可極大程序上知足程序須要，因此在程序中我習慣使用它而不使用foreach,基本原形爲：

 

複製代碼代碼以下:

{section name = name loop = $varName[, start = $start, step = $step, max = $max, show = true]}

 

參數解釋以下：

name: section的名稱，不用加$

$loop: 要循環的變量，在程序中要使用assign對這個變量進行操做。

$start: 開始循環的下標，循環下標默認由0開始

$step: 每次循環時下標的增數

$max: 最大循環下標

$show: boolean類型，決定是否對這個塊進行顯示，默認爲true
這裏有個名詞須要說明：

循環下標：實際它的英文名稱爲index，是索引的意思，這裏我將它譯成"下標"，主要是爲了好理解。它表示在顯示這個循環塊時當前的循環索引，默認從0開始，受$start的影響，若是將$start設爲5，它也將從5開始計數，在模板設計部分咱們使用過它，這是當前{section}的一個屬性，調用方式爲Smarty.section.sectionName.index,這裏的sectionName指的是函數原型中的name屬性。

{section}塊具備的屬性值，分別爲：

1. index: 上邊咱們介紹的"循環下標"，默認爲0

2. index_prev: 當前下標的前一個值，默認爲-1

3. index_next: 當前下標的下一個值，默認爲1

4. first: 是否爲第一下循環

5. last: 是否爲最後一個循環

6. iteration: 循環次數

7. rownum: 當前的行號，iteration的另外一個別名

8. loop: 最後一個循環號，可用在section塊後統計section的循環次數

9. total: 循環次數，可用在section塊後統計循環次數

10. show: 在函數的聲明中有它，用於判斷section是否顯示

它們的具體屬性你們能夠參考手冊，在程序中可靈活使用它的這些屬性，模板部分我就使用過index屬性，你們能夠回過頭去看看。

一樣，{section}也能夠配合使用{sectionelse}，用來表示傳入的數組變量爲空時對模板進行的處理。

咱們把上邊的那個例子使用{section}來替代{foreach}來實現現樣的功能，注意，在這個例子中我只將tpl模板中的{foreach}用{section}來實現，php程序文件中沒有任何改動，同時加了{sectionelse}處理塊：

example.tpl模板文件以下：

 

複製代碼代碼以下:

這裏將輸出一個數組：

 

{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 輸出文件以下：

 

 

複製代碼代碼以下:

這裏將輸出一個數組：

 

新聞編號：1

新聞內容：第1條新聞

新聞編號：2

新聞內容：第2條新聞

新聞編號：3

新聞內容：第3條新聞

新聞編號：4

新聞內容：第4條新聞

新聞編號：5

新聞內容：第5條新聞

新聞編號：6

新聞內容：第6條新聞

這裏的{section}塊的對於變量的命名方式感受有些彆扭，不過不要緊，你只要記住模板變量使用：

 

$loopName[name].var這種模式就好了，loopName爲loop處賦予的變量名，[name]爲name處賦予的字符串，.後爲爲你要在程序數組中設定要與值相對應的下標名稱就好了。

好了，本文關於smarty程序設計學習指南就寫到這裏，對於通常的應用，這些知識已經夠用了，其它的一些高級技巧你們請參看手冊中的例子，此外相關的還有Smarty在實際應用中的例子，以php內置的mysql語句，phplib中的DB類，ADODB，Pear中DB類等等。感興趣的朋友能夠關注一下相關內容。

但願本文所述對你們的PHP程序設計有所幫助。