如果你正想知道什么是模板,首先去看一下sascha schumann寫的精彩文章《模板-為什么和如何在php3中使用它們(templates - why and how to use them in php3)的前幾段。
一般來說,模板可以讓你完全地把你的php代碼從html中分離出來,這樣使得html的圖形設計者們非常高興,而且可以避免他們搞丟你的寶貴設計。
它不是fasttemplates那么,我們真的需要在phpbuilder上關于模板的另一篇文章嗎?好,是的,因為有不止一種的方法用php來實現模板。sascha的文章講述了如何使用fasttemplates,但是php基本類庫("phplib")有它自已的模板實現。
它們有什么不同呢?fasttemplates最初是從一個perl庫轉變來的。fasttemplates對perl程序工作的很好,但是對php不太理想。kristian koehntopp從頭編寫了phplib模板,作為一個純的php庫,它更好地提供了php的優勢。好處之一是kristian的設計使用了preg_replace()來分析模板,據說比fasttemplate 中使用的ereg_replace()要快。phplib模板的另一個好處是它允許動態的塊實現嵌套,不象fasttemplates。
兩個庫都有著非常相似的特性和能力,但是如果你已經使用了fasttemplates,并且你想學習使用phplib模板,你應該把你所知道的關于fasttemplates 的一切都忘掉。他們的特性可能是相似的,但是phplib模板所做的每件事比fasttemplates只有一點點不同。
使用phplib模板
讓我們從一個簡單的例子開始。我們假設在/home/mydir/mytemplates/下面有一個名為mytemplate的模板,它有一些文本,內容可能是:
祝賀!你贏了一輛{ some_color}honda prelude!
注意"{ some_color}"是用大括號包圍的。大括號指明some_color是一個模板變量。我們可能想寫這樣一個腳本,它可以裝入模板,在{ some_color}模板變量的地方插入php變量$my_color的值,然后輸出新的文本。
如果$my_color碰巧被設為"藍色",最后的輸出可能是:
祝賀!你贏了一輛新藍色honda prelude!
下面是上述結果的php腳本:
---------------------------------------
<?php
include "template.inc";
$my_color = "blue";
// 將在后面使用
$t = new template("/home/mydir/mytemplates/");
// 創建一個名為 $t 的模板對象
$t->set_file("myfilehandle","mytemplate.ihtml");
// 設置 myfilehandle = 我們的模板文件
$t->set_var("some_color",$my_color);
// 設置模板變量 some_color = $my_color值
$t->parse("myoutput","myfilehandle");
// 設置模板變量 myoutput = 分析后的文件
$t->p("myoutput");
// 輸出 myoutput 的值(我們的分析后的數據)
?>-------------------------------------------
第一行是一個include 指令,用來提供phplib模板功能。當然phplib做的比模板要多,但是如果你只想使用模板特性,只需要包括tmplate.inc (template.inc是來自于phplib的文件之一)。phplib模板使用面向對象程序設計,所以下一件事情就是創建一個模板對象。代碼 <? $t = new template (
"/home/mydir/mytemplates/" ); ?> 創建一個新的模板對象$t。這個$t對象是一個句柄,將用來處理所有的模板函數,用于php腳本中其它的代碼。如果你愿意,你可能創建其它的模板對象(每一個都有著自已的模板變量名字空間),但是一個就夠用了。在模板的構造函數調用中的路徑("/home/mydir/mytemplates/")用來設置你的模板所在位置的根目錄,但是如果你沒有設它,它將缺省與你的php腳本所在目錄一樣。
然后我們調用set_file()來定義一個名為"myfilehandle"的句柄來與mytemplate.ihtml鏈接(在parse()被調用之前,模板不會真正地裝入)。順便說一下,phplib模板的模板文件名的后綴為.ihtml 是一種習慣,你可以使用.html,.tpl,或其它的后綴。然后調用set_var()來設置模板變量some_color為$my_color的值(值為"藍色"),意味著所有在模板中出現{ some_color}的地方都將被詞"藍色"所替換,一旦我們調用了parse()。
接著我們調用parse(),它會裝入myfilehandle(mytemplate.ihtml)進行分析,并且替換所有模板變量("{ 某變量}")為模板變量的值,分析的結果放在myoutput中。任何結果都不會輸出到web服務器上,除非p("myoutput")被調用,它將輸出最后分析過的文本。
嵌套的模板
parse()函數的一個靈巧的特性是它創建的myoutput句柄是一個真正的模板變量,就象some_color 是一個模板變量。所以如果你有另一個模板,它有一個{ myoutput}標簽,當你分析第二個模板時,所有的{ myoutput}標記將被替換為myoutput中的分析后的文本。這個特性允許你將一個模板文件嵌入到另一個模板中。所以,我們可能有另一個名為wholepage.ihtml的模板,內容如下:
對不起,你沒贏。但是如果你贏了,我們將對你說:{ myoutput}
并且在wholepage.ihtml被分析后,最后的結果將是:
對不起,你沒贏。但是如果你贏了,我們將對你說:祝賀!你贏了一輛新藍色honda prelude!
下面是分析兩個模板的php代碼:
-------------------------------------------------------
<?php
$t = new template("/home/mydir/mytemplates/");
// 這三行同第一個例子一樣$t->set_file("myfilehandle","mytemplate.ihtml");
$t->set_var("some_color",$my_color);
$t->parse("myoutput","myfilehandle");
// 注意我們沒有調用p()// 這里,仍然沒有輸出任何東西
// 現在分析第二個模板
$t->set_file("wholehandle","wholepage.ihtml");
// wholepage.ihtml 有 "{ myoutput}" 在里面$t->parse("myfinaloutput","wholehandle");
// 所有的 { myoutput} 被替換了$t->p("myfinaloutput");
// 輸出 myfinaloutput 的值
?>---------------------------------------------------
最后調用了parse()和p()的兩行語句可以合并成一個簡寫函數pparse():
-------------------------------------------------
<?php
pparse("myfinaloutput","secondhandle");
?>
-------------------------------------------------
另一個phplib模板的特性是set_file()和set_var()函數也能一次接收多組值,通過傳遞一個句柄/數組對數組。這是一個例子:
-----------------------------------------
<?php
$t->set_file(array( "pageonehandle" => "pageone.ihtml",
"pagetwohandle" => "pagetwo.ihtml"));
$t->set_var(array( "last_name" => "gates",
"first_name" => "bill",
"net_worth" => $reallybignumber));
?>
-----------------------------------
添加模板文本
你可以給parse()和pparse()傳遞第三個參數,如果你想給模板變量追加數據而不是替換它。可以簡單的使用true作為第三個參數調用parse()和pparse(),如:
--------------------------------------------
<?php
$t->parse("myoutput","myfilehandle", true);
?>
-----------------------------------------------------
如果myoutput已經包含了數據,myfilehandle將被分析并且被追加到myoutput已經存在的數據上。這個技術非常有用,如果你已經有了一個模板,你想要同一段文本被重復多次,例如列出一個數據庫查詢結果中的多行。你也可能是顯示數組中的變量,如下面的例子:
---------------------------------------------
<?php$t = new template("/home/mydir/mytemplates/"); $t->set_file(array("mainpage" => "mainpage.ihtml", "each_element" => "each_element.ihtml"));reset($myarray);while (list($elementname, $elementvalue) = each($myarray)) {
// 設置 'value' 和 'name' 為每一個元素的值和名字
$t->set_var("name",$elementname); $t->set_var("value",$elementvalue);
// 追加each_element的拷貝
$t->parse("array_elements","each_element",true);}$t->pparse("output","mainpage");?>--------------------------------------
這個例子使用了兩個模板,mainpage.ihtml和each_element.ihtml。mainpage.ihtml模板可能是這樣:
<html>
here is the array:
<table>
{ array_elements}
</table>
</html>
上面的{ array_elements}標簽將被each_element.ihtml的拷貝所替換,它將根據數組($myarray)進行重復。each_element.ihtml模板看上去可能是:
<tr>
<td>{ name}: { value}</td>
</tr>
處理結果是一個包含$myarray元素的格式化很好的表格。但是如果將兩個模板合并成一個模板不是更好嗎?實際上,它們可以使用模板塊來合并使用。模板塊允許從一個模板中取出一塊文本,所以你可以重復很多次,或者在它上面做任何你想做的事情。但是我將在另一篇文章講述這個特性。
新聞熱點
疑難解答