程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
 程式師世界 >> 編程語言 >> 網頁編程 >> PHP編程 >> PHP綜合 >> smarty快速上手教程

smarty快速上手教程

編輯:PHP綜合
一:smarty的程序設計部分:

在smarty的模板設計部分我簡單的把smarty在模板中的一些常用設置做了簡單的介紹,這一節主要來介紹一下如何在smarty中開始我們程序設計下載Smarty文件放到你們站點中。
index.php PHP代碼:
<?php
/**
 *
 * @version $Id: index.PHP
 * @package
 * @author www.jzxue.com
 * @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語言規范的一組代碼,我們依次來解釋一下:
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程序中的一些常用的基本元素介紹了一下,在後邊的例子中你可以看到將它們將被多次的使用。

  三:模板說明

  接下來介紹一個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#}

  


--------------------------------------------------------------------------------

 

  

  

  注:PHP100上面的寫法是這樣的:(PHP100.com的鏈接:http://www.jzxue.com/Html/webkaifa/PHP/PHPyingyong/2009/0429/2897.Html)

  {foreach from=$newsArray item=newsID}

  新聞編號:{$newsID}
 

  新聞內容:{$newsTitle}
 


--------------------------------------------------------------------------------

 

  {foreachelse}

  對不起,數據庫中沒有新聞輸出!

  {/foreach}

  這是一個錯誤的不顯示數據,本文做了更正。運行正確如下圖片:

程序文件:example.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

  ==========================================

  

  /*********************************************

  *

  * 文件名: 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類來分別講一下各個類庫在同一個例子中的實現。

 

  1. 上一頁:
  2. 下一頁:
Copyright © 程式師世界 All Rights Reserved