smarty半小時(shí)快速上手入門(mén)教程
本文講述了smarty快速上手入門(mén)的方法,可以讓讀者在半小時(shí)內(nèi)快速掌握smarty的用法。分享給大家供大家參考。具體實(shí)現(xiàn)方法如下:
一、smarty的程序設(shè)計(jì)部分:
在smarty的模板設(shè)計(jì)部分我簡(jiǎn)單的把smarty在模板中的一些常用設(shè)置做了簡(jiǎn)單的介紹,這一節(jié)主要來(lái)介紹一下如何在smarty中開(kāi)始我們程序設(shè)計(jì)。下載Smarty文件放到你們站點(diǎn)中。
index.php代碼如下:
/**
*
* @version $Id: index.php
* @package
* @author www.dbjr.com.cn
* @action 顯示實(shí)例程序
*/
include_once("./Smarty/Smarty.class.php"); //包含smarty類(lèi)文件
$smarty = new Smarty(); //建立smarty實(shí)例對(duì)象$smarty
$smarty->templates("./templates"); //設(shè)置模板目錄
$smarty->templates_c("./templates_c"); //設(shè)置編譯目錄
$smarty->cache("./cache"); //緩存目錄
$smarty->cache_lifetime = 0; //緩存時(shí)間
$smarty->caching = true; //緩存方式
$smarty->left_delimiter = "{#";
$smarty->right_delimiter = "#}";
$smarty->assign("name", "zaocha"); //進(jìn)行模板變量替換
$smarty->display("index.htm"); //編譯并顯示位于./templates下的index.htm模板
?>
二、解釋smarty的程序
我們可以看到,smarty的程序部分實(shí)際就是符合php語(yǔ)言規(guī)范的一組代碼,我們依次來(lái)解釋一下:
1:/**/語(yǔ)句:
包含的部分為程序篇頭注釋。主要的內(nèi)容應(yīng)該為對(duì)程序的作用,版權(quán)與作者及編寫(xiě)時(shí)間做一個(gè)簡(jiǎn)單的介紹,這在smarty中不是必需的,但從程序的風(fēng)格來(lái)講,這是一個(gè)好的風(fēng)格。
2:include_once語(yǔ)句:
它將安裝到網(wǎng)站的smarty文件包含到當(dāng)前文件中,注意包含的路徑一定要寫(xiě)正確。
3:$smarty = new Smarty():
這一句新建一個(gè)Smarty對(duì)象$smarty,簡(jiǎn)單的一個(gè)對(duì)象的實(shí)例化。
4:$smarty->templates(""):
這一句指明$smarty對(duì)象使用tpl模板時(shí)的路徑,它是一個(gè)目錄,在沒(méi)有這一句時(shí),Smarty默認(rèn)的模板路徑為當(dāng)前目錄的templates目錄,實(shí)際在寫(xiě)程序時(shí),我們要將這一句寫(xiě)明,這也是一種好的程序風(fēng)格。
5:$smarty->templates_c(""):
這一句指明$smarty對(duì)象進(jìn)行編譯時(shí)的目錄。在模板設(shè)計(jì)篇我們已經(jīng)知道Smarty是一種編譯型模板語(yǔ)言,而這個(gè)目錄,就是它編譯模板的目錄,要注意,如果站點(diǎn)位于linux服務(wù)器上,請(qǐng)確保
teamplates_c里定義的這個(gè)目錄具有可寫(xiě)可讀權(quán)限,默認(rèn)情況下它的編譯目錄是當(dāng)前目錄下的templates_c,出于同樣的理由我們將其明確的寫(xiě)出來(lái)。
6:$smarty->left_delimiter與$smarty->right_delimiter:
指明在查找模板變量時(shí)的左右分割符。默認(rèn)情況下為"{"與"}",但在實(shí)際中因?yàn)槲覀円谀0逯惺褂?lt;script>,Script中的函數(shù)定義難免會(huì)使用{},雖然它有自己的解決辦法,但習(xí)慣上我們將它重新定義
為"{#"與"#}"或是"<!--{"與"}-->"或其它標(biāo)志符,注意,如果在這里定義了左右分割符后,在模板文件中相應(yīng)的要使每一個(gè)變量使用與定義相同的符號(hào),例如在這里指定為"<{"與"}>",htm模板中也要
相應(yīng)的將{$name}變成<{$name}>,這樣程序才可以正確的找到模板變量。
7:$smarty->cache("./cache"):
告訴Smarty輸出的模板文件緩存的位置。上一篇我們知道Smarty最大的優(yōu)點(diǎn)在于它可以緩存,這里就是設(shè)置緩存的目錄。默認(rèn)情況下為當(dāng)前目錄下的cache目錄,與templates_c目錄相當(dāng),在linux系統(tǒng)中
我們要確保它的可讀可寫(xiě)性。
8:$smarty->cache_lifetime = 60 * 60 * 24:
這里將以秒為單位進(jìn)行計(jì)算緩存有效的時(shí)間。第一次緩存時(shí)間到期時(shí)當(dāng)Smarty的caching變量設(shè)置為true時(shí)緩存將被重建。當(dāng)它的取值為-1時(shí)表示建立起的緩存從不過(guò)期,為0時(shí)表示在程序每次執(zhí)行時(shí)緩
存總是被重新建立。上面的設(shè)置表示將cache_lifetime設(shè)置為一天。
9:$smarty->caching = 1:
這個(gè)屬性告訴Smarty是否要進(jìn)行緩存以及緩存的方式。它可以取3個(gè)值,0:Smarty默認(rèn)值,表示不對(duì)模板進(jìn)行緩存;1:表示Smarty將使用當(dāng)前定義的cache_lifetime來(lái)決定是否結(jié)束cache;2:表示
Smarty將使用在cache被建立時(shí)使用cache_lifetime這個(gè)值。習(xí)慣上使用true與false來(lái)表示是否進(jìn)行緩存。
10:$smarty->assign("name", "zaocha"):
該數(shù)的原型為assign(string varname, mixed var),varname為模板中使用的模板變量,var指出要將模板變量替換的變量名;其第二種原形為assign(mixed var),我們要在后面的例子詳細(xì)的講解這個(gè)成員函數(shù)的使用方法,assign是Smarty的核心函數(shù)之一,所有對(duì)模板變量的替換都要使用它。
11:$smarty->display("index.tpl"):
該函數(shù)原形為display(string varname),作用為顯示一個(gè)模板。簡(jiǎn)單的講,它將分析處理過(guò)的模板顯示出來(lái),這里的模板文件不用加路徑,只要使用一個(gè)文件名就可以了,它路徑我們已經(jīng)在$smarty->templates(string path)中定義過(guò)了。
程序執(zhí)行完后我們可以打開(kāi)當(dāng)前目錄下的templates_c與cache目錄,就會(huì)發(fā)現(xiàn)在下邊多出一些%%的目錄,這些目錄就是Smarty的編譯與緩存目錄,它由程序自動(dòng)生成,不要直接對(duì)這些生成的文件進(jìn)行修改。
以上我簡(jiǎn)單的把Smarty程序中的一些常用的基本元素介紹了一下,在后邊的例子中你可以看到將它們將被多次的使用。
三、模板說(shuō)明
接下來(lái)介紹一個(gè)section循環(huán)塊與foreach循環(huán)塊,本來(lái)它應(yīng)該屬于模板部分,但是由于它們是smarty的精華所在,而且與smarty程序設(shè)計(jì)部分聯(lián)系非常緊密,所以就在本節(jié)單獨(dú)拿出來(lái)講一下。
1: foreach:用于循環(huán)簡(jiǎn)單數(shù)組,它是一個(gè)選擇性的section循環(huán),它的定義格式為:
{foreachelse}
{/foreach}
其中,from 指出要循環(huán)的數(shù)組變量,item為要循環(huán)的變量名稱(chēng),循環(huán)次數(shù)由from所指定的數(shù)組變量的個(gè)數(shù)所決定。{foreachelse}用來(lái)當(dāng)程序中傳遞過(guò)來(lái)的數(shù)組為空時(shí)的處理,下面是一個(gè)簡(jiǎn)單的例子:
模板文件:
example.htm頁(yè)面如下:
{#foreach item=new from=$news#}
新聞編號(hào):{#$new.id#}
新聞內(nèi)容:{#$new.title#}
{#foreachelse#}
數(shù)據(jù)庫(kù)中沒(méi)有新聞?shì)敵?
{#/foreach#}
{foreach from=$newsArray item=newsID}
新聞編號(hào):{$newsID}
新聞內(nèi)容:{$newsTitle}
{foreachelse}
對(duì)不起,數(shù)據(jù)庫(kù)中沒(méi)有新聞?shì)敵?
{/foreach}
這是一個(gè)錯(cuò)誤的不顯示數(shù)據(jù),本文做了更正。
程序文件:example.php如下:
/*********************************************
*
* 文件名: example.php
* 作 用: 顯示實(shí)例程序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條新聞");
//這是一個(gè)二維關(guān)聯(lián)數(shù)組
$smarty->assign("newsArray", $array);
//編譯并顯示位于./templates下的index.htm模板
$smarty->display("example.htm");
?>
輸入結(jié)果:example.php輸出如下:
新聞編號(hào):1
新聞內(nèi)容:第1條新聞
新聞編號(hào):2
新聞內(nèi)容:第2條新聞
新聞編號(hào):3
新聞內(nèi)容:第3條新聞
新聞編號(hào):4
新聞內(nèi)容:第4條新聞
新聞編號(hào):5
新聞內(nèi)容:第5條新聞
新聞編號(hào):6
新聞內(nèi)容:第6條新聞
foreach還可以用foreachelse來(lái)匹配,用foreachelse來(lái)表示當(dāng)傳遞給foreach的數(shù)組為空值時(shí)程序要執(zhí)行的操作,具體的使用方法,請(qǐng)參考手冊(cè)的說(shuō)明。
2. section:
section的產(chǎn)生是為解決foreach的不足的,與foreach一樣,它用于設(shè)計(jì)模板內(nèi)的循環(huán)塊,它較為復(fù)雜,可極大程序上滿足程序需要,所以在程序中我習(xí)慣使用它而不使用foreach,基本原形為:
參數(shù)解釋如下:
name: section的名稱(chēng),不用加$
$loop: 要循環(huán)的變量,在程序中要使用assign對(duì)這個(gè)變量進(jìn)行操作。
$start: 開(kāi)始循環(huán)的下標(biāo),循環(huán)下標(biāo)默認(rèn)由0開(kāi)始
$step: 每次循環(huán)時(shí)下標(biāo)的增數(shù)
$max: 最大循環(huán)下標(biāo)
$show: boolean類(lèi)型,決定是否對(duì)這個(gè)塊進(jìn)行顯示,默認(rèn)為true
這里有個(gè)名詞需要說(shuō)明:
循環(huán)下標(biāo):實(shí)際它的英文名稱(chēng)為index,是索引的意思,這里我將它譯成"下標(biāo)",主要是為了好理解。它表示在顯示這個(gè)循環(huán)塊時(shí)當(dāng)前的循環(huán)索引,默認(rèn)從0開(kāi)始,受$start的影響,如果將$start設(shè)為5,它也將從5開(kāi)始計(jì)數(shù),在模板設(shè)計(jì)部分我們使用過(guò)它,這是當(dāng)前{section}的一個(gè)屬性,調(diào)用方式為Smarty.section.sectionName.index,這里的sectionName指的是函數(shù)原型中的name屬性。
{section}塊具有的屬性值,分別為:
1. index: 上邊我們介紹的"循環(huán)下標(biāo)",默認(rèn)為0
2. index_prev: 當(dāng)前下標(biāo)的前一個(gè)值,默認(rèn)為-1
3. index_next: 當(dāng)前下標(biāo)的下一個(gè)值,默認(rèn)為1
4. first: 是否為第一下循環(huán)
5. last: 是否為最后一個(gè)循環(huán)
6. iteration: 循環(huán)次數(shù)
7. rownum: 當(dāng)前的行號(hào),iteration的另一個(gè)別名
8. loop: 最后一個(gè)循環(huán)號(hào),可用在section塊后統(tǒng)計(jì)section的循環(huán)次數(shù)
9. total: 循環(huán)次數(shù),可用在section塊后統(tǒng)計(jì)循環(huán)次數(shù)
10. show: 在函數(shù)的聲明中有它,用于判斷section是否顯示
它們的具體屬性大家可以參考手冊(cè),在程序中可靈活使用它的這些屬性,模板部分我就使用過(guò)index屬性,大家可以回過(guò)頭去看看。
同樣,{section}也可以配合使用{sectionelse},用來(lái)表示傳入的數(shù)組變量為空時(shí)對(duì)模板進(jìn)行的處理。
我們把上邊的那個(gè)例子使用{section}來(lái)替代{foreach}來(lái)實(shí)現(xiàn)現(xiàn)樣的功能,注意,在這個(gè)例子中我只將tpl模板中的{foreach}用{section}來(lái)實(shí)現(xiàn),php程序文件中沒(méi)有任何改動(dòng),同時(shí)加了{(lán)sectionelse}處理塊:
example.tpl模板文件如下:
{section name=loop loop=$News}
新聞編號(hào):{$News[loop].newsID}
新聞標(biāo)題:{$News[loop].newsTitle}
{sectionelse}
對(duì)不起,沒(méi)有任何新聞?shì)斎?
{/section}
example.php文件如下:
/*********************************************
*
* 文件名: example7.php
* 作 用: 顯示實(shí)例程序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 輸出文件如下:
新聞編號(hào):1
新聞內(nèi)容:第1條新聞
新聞編號(hào):2
新聞內(nèi)容:第2條新聞
新聞編號(hào):3
新聞內(nèi)容:第3條新聞
新聞編號(hào):4
新聞內(nèi)容:第4條新聞
新聞編號(hào):5
新聞內(nèi)容:第5條新聞
新聞編號(hào):6
新聞內(nèi)容:第6條新聞
這里的{section}塊的對(duì)于變量的命名方式感覺(jué)有些別扭,不過(guò)沒(méi)關(guān)系,你只要記住模板變量使用:
$loopName[name].var這種模式就行了,loopName為loop處賦予的變量名,[name]為name處賦予的字符串,.后為為你要在程序數(shù)組中設(shè)定要與值相對(duì)應(yīng)的下標(biāo)名稱(chēng)就行了。
好了,本文關(guān)于smarty程序設(shè)計(jì)學(xué)習(xí)指南就寫(xiě)到這里,對(duì)于一般的應(yīng)用,這些知識(shí)已經(jīng)夠用了,其它的一些高級(jí)技巧大家請(qǐng)參看手冊(cè)中的例子,此外相關(guān)的還有Smarty在實(shí)際應(yīng)用中的例子,以php內(nèi)置的mysql語(yǔ)句,phplib中的DB類(lèi),ADODB,Pear中DB類(lèi)等等。感興趣的朋友可以關(guān)注一下相關(guān)內(nèi)容。
希望本文所述對(duì)大家的PHP程序設(shè)計(jì)有所幫助。
相關(guān)文章
使用php記錄用戶(hù)通過(guò)搜索引擎進(jìn)網(wǎng)站的關(guān)鍵詞
為了方便SEO,我們需要記錄用戶(hù)通過(guò)常見(jiàn)的搜索引擎搜索關(guān)鍵詞,下面是進(jìn)入你網(wǎng)站的情況的相關(guān)實(shí)現(xiàn)代碼,更多的,大家自己拓展咯2014-02-02php中配置文件保存修改操作 如config.php文件的讀取修改等操作
有時(shí)候我們需要用php將一些配置參數(shù)寫(xiě)到文件里面,方便后期讀取使用,這里就為大家分享一下具體的實(shí)現(xiàn)代碼,需要的朋友可以參考一下2021-05-05在Laravel5.6中使用Swoole的協(xié)程數(shù)據(jù)庫(kù)查詢(xún)
這篇文章主要介紹了在Laravel5.6中使用Swoole的協(xié)程數(shù)據(jù)庫(kù)查詢(xún),詳細(xì)的介紹了什么是Swoole,以及Laravel5.6中使用Swoole,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2018-06-06Laravel重寫(xiě)用戶(hù)登錄簡(jiǎn)單示例
這篇文章主要介紹了Laravel重寫(xiě)用戶(hù)登錄的方法,結(jié)合簡(jiǎn)單實(shí)例形式分析了Laravel框架根據(jù)已有的login方法重寫(xiě)實(shí)現(xiàn)針對(duì)驗(yàn)證碼、后臺(tái)登陸頻率及日志記錄的擴(kuò)種等功能,需要的朋友可以參考下2016-10-10Windows7下PHP開(kāi)發(fā)環(huán)境安裝配置圖文方法
備花點(diǎn)時(shí)間學(xué)習(xí)下PHP,于是在自己機(jī)器上配置了下PHP的開(kāi)發(fā)和運(yùn)行環(huán)境。之前在Windows Server 2003 OS中手工配置過(guò),WEB服務(wù)器是IIS。這次是在自己機(jī)器上配置,找了個(gè)簡(jiǎn)單方式。2010-05-05PHP使Laravel為JSON REST API返回自定義錯(cuò)誤的問(wèn)題
這篇文章主要介紹了PHP使Laravel為JSON REST API返回自定義錯(cuò)誤的問(wèn)題,非常不錯(cuò),具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2018-10-10分享PHP函數(shù)實(shí)現(xiàn)數(shù)字與文字分頁(yè)代碼
這篇文章主要介紹了PHP函數(shù)實(shí)現(xiàn)數(shù)字與文字分頁(yè)代碼,定義分頁(yè)函數(shù)_paging,在核心函數(shù)庫(kù)包裝代碼,需要的朋友可以參考下2015-07-07從零開(kāi)始學(xué)YII2框架(六)高級(jí)應(yīng)用程序模板
這篇文章主要介紹了YII2框架學(xué)習(xí)筆記之高級(jí)應(yīng)用程序模板,深入淺出從安裝,配置到使用方法都做了介紹,希望對(duì)大家有所幫助2014-08-08