定義
PHP模板
如何使PHP腳本從設計中獨立出來?這是在PHP郵件列表上所提問的最多的問題之一。雖然PHP被標榜為“HTML嵌入式語言”,在寫過許多PHP和HTML混合式的工程之後,一個分離表單和內容的想法產生了。而且,在許多公司里規劃設計者的角色和程式設計者是分開的。於是,這樣的一個模板解決方案產生了……
例如在一個公司,一個應用程式的開發流程如下:在提交計畫文檔之後,界面設計者[美工]製作了網站的外觀模型,然後把它交給後台程式設計師。程式設計師使用PHP實現商業邏輯,同時使用外觀模型做成基本架構。然後工程被返回到HTML頁面設計者繼續完善。就這樣工程可能在後台程式設計師和頁面設計者之間來來回回好幾次。由於後台程式設計師不喜歡干預任何有關HTML標籤,同時也不需要美工們和PHP代碼混在一起;美工設計者只需要配置檔案,動態區塊和其他的界面部分,不必要去接觸那些錯綜複雜的PHP代碼。因此,這時候有一個很好的模板支持就顯得很重要了。
縱觀現今存在的許多PHP模板解決方案(比如PHPLIB),大多數都只是提供了用模板取代變數和將動態區塊的功能有限的格式化的基本方法。但是我們的需求比這個要高的多。我們完全不想要PHP程式設計師去設計HTML頁面,可是這又是不可避免的。例如:如果美工想要在動態區塊之間交替不同的背景顏色,他就可能得和程式設計師預先說好。同樣,美工們也應該有自己對於頁面設計的配置檔案,這同樣可以通過變數把他們拉到模板裡邊去
優點
1. 速度:採用Smarty編寫的程式可以獲得最大速度的提高,這一點是相對於其它的模板引擎技術而言的。
2. 編譯型:採用Smarty編寫的程式在運行時要編譯成一個非模板技術的PHP檔案,這個檔案採用了PHP與HTML混合的方式,在下一次訪問模板時將WEB請求直接轉換到這個檔案中,而不再進行模板重新編譯(在源程式沒有改動的情況下)
3. 快取技術:Smarty選用的一種快取技術,它可以將用戶最終看到的HTML檔案快取成一個靜態的HTML頁,當設定Smarty的cache屬性為true時,在Smarty設定的cachetime期內將用戶的WEB請求直接轉換到這個靜態的HTML檔案中來,這相當於調用一個靜態的HTML檔案。
4. 外掛程式技術:Smarty可以自定義外掛程式。外掛程式實際就是一些自定義的函式。
5. 模板中可以使用if/elseif/else/endif。在模板檔案使用判斷語句可以非常方便的對模板進行格式重排。
不適合使用Smarty的地方
需要實時更新的內容。例如像股票顯示,它需要經常對數據進行更新,這類型的程式使用smarty會使模板處理速度變慢。
小項目。小項目因為項目簡單而美工與程式設計師兼於一人的項目,使用Smarty會在一定程度上喪失PHP開發迅速的優點。
(PS:不過為了整個項目的規範,請大家嘗試去使用模板引擎。其實習慣了,開發速度會更加快,以上是沒有用習慣模板引擎的開發者遇到的問題)
誕生過程
早在1999年後期,就已經開始為模板引擎寫說明文檔。在完成這個文檔之後,開始嘗試用C寫一個模板引擎,並有希望被包含到PHP里去。在撞上了許多的技術難題的同時,“什麼是模板應該做的,什麼不該做”這個問題,也被熱烈的討論著。從這些經驗決定應該用PHP將模板引擎寫成一個類,讓任何覺得合適的人使用它。所以就有了Smarty。(註:這個類從來沒有公開發表過)。這個類幾乎達到了我們所有的要求:常規變數替換,支持引用其他模板,使用配置檔案集成設定,嵌入PHP代碼,限制'if'語句的作用,還有更多的可以多層嵌套的健壯的動態區塊。它用正則表達式做到這一切,於是代碼變得相當令人費解。在每次調用的時候,都要去解析那些語法和正則表達式,於是在大型套用的時候,它顯然慢了下來。在程式設計師的眼光看來,最大的問題還是使用PHP腳本建立和處理模板和動態區塊的所有必要工作。我們應該如何使它變得更簡單?
我們可以想像Smarty應該有怎樣的最後表現。我們知道PHP代碼如果沒有了模板解析的開銷將有多快,我們也知道從一般的美工看來PHP語言是多么的“恐怖”,然而這一切可以被一種更簡單的模板語法掩飾掉。我們應該怎樣把這兩種方法的長處結合起來?
於是,Smarty誕生了……
簡明教程
一. 安裝
下載最新版本的Smarty。解壓下載的檔案。
接下來演示給大家一個安裝實例,看過應該會舉一反三的。
(1) 在根目錄下建立了新的目錄learn/,再在learn/里建立一個目錄smarty/。將剛才解壓縮出來的目錄的libs/拷貝到smarty/里,再在smarty/里新建templates目錄,templates里新建cache/,templates/,templates_c/, config/。
(2) 新建一個模板檔案:index.tpl,將此檔案放在learn/smarty/templates/templates目錄下,代碼如下:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"此處DOCTYPE
聲明不全,下午糾結了好一會,終於看到了,新手朋友們關注下">
<html>
<head>
<metahttp-equiv="Content-Type" content="text/html;charset=gb2312">
<title>Smarty</title></head>
<body>{#$hello#}</body>
</html>
新建index.php,將此檔案放在learn/下:
<?php
require 'smarty/libs/Smarty.class.php';
$smarty = new Smarty();//設定各個目錄的路徑,這裡是安裝的重點
$smarty->template_dir ="smarty/templates/templates";
$smarty->compile_dir ="smarty/templates/templates_c";
$smarty->config_dir = "smarty/templates/config";
$smarty->cache_dir ="smarty/templates/cache";
//smarty模板有高速快取的功能,如果這裡是true的話即打開caching,但是會造成網頁不立即更新的問題,當然也可以通過其他的辦法解決
$smarty->caching = false;
$smarty->left_delimiter = "{#"; //重新定義邊界,因為默認邊界“{}“符,在html頁面中嵌入js腳本檔案編寫代碼段時使用的就是”{}“符,自定義邊界符還可以是<{ }>, {/ /} 等
$smarty->right_delimiter = "#}";
$hello = "Hello World!";//賦值
$smarty->assign("hello",$hello);//引用模板檔案
$smarty->display('index.tpl');?>
(3) 執行index.php就能看到Hello World!了。
二. 賦值
在模板檔案中需要替換的值用大括弧{}括起來,值的前面還要加$號。例如{$hello}。這裡可以是數組,比如{$hello.item1},{$hello.item2}…
而PHP源檔案中只需要一個簡單的函式assign(var , value)。
簡單的例子:
*.tpl:
*.php:
$hello[name]= “Mr. Green”;
$hello[time]=”morning”;
$smarty->assign(“exp”,$hello);
output:
Hello,Mr.Green!Good morning
三. 引用
網站中的網頁一般header和footer是可以共用的,所以只要在每個tpl中引用它們就可以了。
示例:*.tpl:
{include file="header.tpl"}
{* body of template goes here *}
{include file="footer.tpl"}
判斷
模板檔案中可以使用if else等判斷語句,即可以將一些邏輯程式放在模板里。"eq","ne", "neq", "gt", "lt","lte", "le", "gte" "ge","is even", "is odd", "is not even", "is notodd", "not", "mod", "div by", "evenby", "odd by","==","!=",">","<","<=",">="這些是if中可以用到的比較。看看就能知道什麼意思吧。
eq相等,
ne、neq不相等,
gt大於,
lt小於,
gte、ge大於等於,
lte、le 小於等於,
not非, mod求模。
is [not] div by是否能被某數整除,
,B z M E m I w0 is [not] even是否為偶數,
$a is [not] even by $b即($a / $b) % 2 == 0,
is [not] odd是否為奇,
$a is not odd by $b即($a / $b) % 2 != 0
示例:
{if $name eq "Fred"}
WelcomeSir.
{elseif $name eq "Wilma"}
WelcomeMa'am.
{else}
Welcome,whatever you are.
{/if}
循環
在Smarty里使用循環遍歷數組的方法是section,如何賦值遍歷都是在模板中解決,php源檔案中只要一個assign就能解決問題。
示例:
{* this examplewill print out all the values of the $custid array *}
{section name=‘customer’ loop=$custid}
id: {$custid[customer]}<br>
{/section}
OUTPUT:
id: 1000<br>id: 1001<br>id: 1002<br>
Smarty還可以使用類似PHP的foreach來進行遍歷,在最新版本的Smarty里的語法與PHP更相似。
示例:
{foreach item="article" from=$art} //{foreach $art as $item}
{$article.title}
{$article.author}
{$article.content}<br/>
{/foreach}
常見問題
Smarty將所有大括弧{}里的東西都視為自己的邏輯程式,於是我們在網頁中想插入javascript函式就需要literal的幫忙了,literal的功能就是忽略大括弧{}。
示例:
{literal}
<script language=javascript>
function isblank(field) {
if (field.value == '') { return false;
}else{
document.loginform.submit();
return true;
}
}
</script>
{/literal}
解釋程式
我們可以看到,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程式中的一些常用的基本元素介紹了一下,在後邊的例子中你可以看到將它們將被多次的使用。