一、Smarty簡明教程
1.安裝演示
下載最新版本的Smarty-3.1.12,然後解壓下載的文件。接下來演示Smarty自帶的demo例子。
(1)下載地址:http://www.smarty.net/download
(2)在你的WEB服務器根目錄下建立新目錄,這裡我在/var/www下創建yqting/目錄,然後將解壓之後的目錄中的demo/和libs/目錄復制到/var/www/yqting/目錄下。
(3)這裡要特別注意demo/目錄下cache/和template_c/兩個目錄,一定要設置它們 為可讀寫權限。
chmod 777 cache/
chmod 777 template_c/
(4)啟動apache。在浏覽器中輸入http://localhost/yqting/demo/index.php ,這樣一個簡單的Smarty demo就實現了。
2.Smarty目錄結構
(1)以/var/www/yqting目錄開始分析:
yqting/
├── demo
│ ├── cache 緩沖文件存放目錄
│ ├── configs 配置文件目錄
│ ├── index.php
│ ├── plugins 自定義的一些實用插件
│ ├── templates 模板目錄
│ └── templates_c 編譯後的文件存放目錄
└── libs
├── debug.tpl debug模板
├── plugins 自定義的一些實用插件
├── SmartyBC.class.php 支持Smarty 2兼容
├── Smarty.class.php Smarty類定義文件
└── sysplugins Smarty核心功能插件,不需要進行修改
(2)添加自己定義的插件
上述目錄結構中,其實最核心的部分是libs/目錄,同時這部分也是不允許修改的。
而要添加自己的插件,一種方法是將自己定義的插件放在libs/plugins/目錄下,另一種方式是 單獨創建一個自己plugins/目錄,同時還要創建cache/、configs/、templates/和templates _c/目錄,而且要保證cache/和templates_c/目錄的可讀寫權限。
不難發現,其實上述例子中,demo/目錄就是一個包含了自己定義的插件的完整目錄。 我們可以參照demo/目錄來實現自己的程序。
3.實現一個簡單的例子
(1)在/var/www/yqting/下創建目錄weibo/,然後在weibo/目錄下創建cache/、 configs/、templates/和templates_c/目錄,修改cache/和templates_c/目錄的權限為可讀寫。
(2)新建一個模板文件:index.tpl,將此文件放在/var/www/yqting/weibo/templates目錄下,代碼如下:
<html>
<head>
<metahttp-equiv="Content-Type" content="text/html;charset=gb2312">
<title>Smarty</title>
</head>
<body>
username:{$Name}
</body>
</html> 這段代碼很簡單,有什麼不明白的繼續往下看,不要著急!每一個做顯示的.tpl文件都會對應一個處理業務邏輯的.php文件,下面介紹這個.php文件。
(3)新建index.php,將此文件放在/var/www/yqting/weibo/下,代碼如下:
<?php /*sample example */ require '../libs/Smarty.class.php'; $smarty = new Smarty(); $username = "Smarty"; $smarty->assign("Name",$username); $smarty->display('index.tpl'); ?> 其中require使用的路徑一定要正確,可以參照上面的目錄結構看一下!
(4)在Smarty3中,Smarty類的構造函數中已經指定了template_dir、compile_dir 、config_dir和cache_dir,不需要再次指定。
(5) 在浏覽器中輸入http://localhost/yqting/weibo/index.php,就可以看到輸出的信息username:Smarty 了。
二、解釋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中的函數定義難免會使用{},雖然它有自己的解決辦法,但習慣上我們將它重新定義為"{#"與"#}"或是"<!--{"與"}-->"或其它標志符,注意,如果在這裡定義了左右分割符後,在模板文件中相應的要使每一個變量使用與定義相同的符號, 例如在這裡指定為"<{"與"}>",html模板中也要相應的將{$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", $username):
該數的原型為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程序中的一些常用的基本元素介紹了一下,在後邊的例子中你可以看到將它們將被多次的使用。