- 相關(guān)推薦
PHP的自定義模板引擎使用方法
本文將詳細(xì)介紹PHP中的模板引擎。具有很好的參考價(jià)值。下面跟著小編一起來(lái)看下吧。
在大多數(shù)的項(xiàng)目組中,開(kāi)發(fā)一個(gè)Web程序都會(huì)出現(xiàn)這樣的流程:計(jì)劃文檔提交之后,前端工程師制作了網(wǎng)站的外觀模型,然后把它交給后端工程師,它們使用后端代碼實(shí)現(xiàn)程序邏輯,同時(shí)使用外觀模型做成基本架構(gòu),然后工程被返回到前端工程師繼續(xù)完善。就這樣工程可能在后端工程師和前端工程師之間來(lái)來(lái)回回好幾次。由于后端工程師不干預(yù)任何相關(guān)HTML標(biāo)簽,同時(shí)也不需要前端代碼和后端代碼混合在一起。前端工程師只需要配置文件,動(dòng)態(tài)區(qū)塊和其他的界面部分,不必要去接觸那些錯(cuò)綜復(fù)雜的后端代碼。因此,這時(shí)候有一個(gè)很好的模板支持就顯得很重要了。本文將詳細(xì)介紹PHP中的模板引擎
概述
什么是網(wǎng)站模板?準(zhǔn)確地說(shuō),是指網(wǎng)站頁(yè)面模板,即每個(gè)頁(yè)面僅是一個(gè)板式,包括結(jié)構(gòu)、樣式和頁(yè)面布局,是創(chuàng)建網(wǎng)頁(yè)內(nèi)容的樣板,也可以理解為已有的網(wǎng)頁(yè)框架?梢詫⒛0逯性械膬(nèi)容替換成從服務(wù)器端數(shù)據(jù)庫(kù)中動(dòng)態(tài)內(nèi)容,目的是可以保持頁(yè)面風(fēng)格一致
PHP是一種HTML內(nèi)嵌式的在服務(wù)器端執(zhí)行的腳本語(yǔ)言,所以大部分PHP開(kāi)發(fā)出來(lái)的Web應(yīng)用,初始的開(kāi)發(fā)模板就是混合層的數(shù)據(jù)編程。雖然通過(guò)MVC設(shè)計(jì)模式可以把程序應(yīng)用邏輯與網(wǎng)頁(yè)呈現(xiàn)邏輯強(qiáng)制性分離,但也只是將應(yīng)用程序的輸入、處理和輸出分開(kāi),網(wǎng)頁(yè)呈現(xiàn)邏輯(視圖)還會(huì)有HTML代碼和PHP程序強(qiáng)耦合在一起。PHP腳本的編寫(xiě)者必須既是網(wǎng)頁(yè)設(shè)計(jì)者,又是PHP開(kāi)發(fā)者
現(xiàn)在已經(jīng)有很多解決方案,可以將網(wǎng)站的頁(yè)面設(shè)計(jì)和PHP應(yīng)用程序幾乎完全分離。這些解決方案稱(chēng)為“模板引擎”,它們正在逐步消除由于缺乏層次分離而帶來(lái)的難題。模板引擎的目的,就是要達(dá)到上述提到的邏輯分離的功能。它能讓程序開(kāi)發(fā)者專(zhuān)注于資料的控制或是功能的達(dá)成。因此,模板引擎很適合公司的Web開(kāi)發(fā)團(tuán)隊(duì)使用,使每個(gè)人都能發(fā)揮其專(zhuān)長(zhǎng)
模板引擎技術(shù)的核心比較簡(jiǎn)單。只要將前端頁(yè)面指定為模板文件,并將這個(gè)模板文件中動(dòng)態(tài)的內(nèi)容,如數(shù)據(jù)庫(kù)輸出、用戶(hù)交互等部分,定義成使用特殊“定界符”包含的“變量”,然后放在模板文件中相應(yīng)的位置。當(dāng)用戶(hù)瀏覽時(shí),由PHP腳本程序打開(kāi)該模板文件,并將模板文件中定義的變量進(jìn)行替換。這樣,模板中的特殊變量被替換為不同的動(dòng)態(tài)內(nèi)容時(shí),就會(huì)輸出需要的頁(yè)面
目前,可以在PHP中應(yīng)用的并且比較成熟的模板有很多,例如Smarty、PHPLIB、IPB等幾十種。使用這些通過(guò)PHP編寫(xiě)的模板引擎,可以讓代碼脈絡(luò)更加清晰,結(jié)構(gòu)更加合理化。也可以讓網(wǎng)站的維護(hù)和更新變得更容易,創(chuàng)造一個(gè)更加良好的開(kāi)發(fā)環(huán)境,讓開(kāi)發(fā)和設(shè)計(jì)工作更容易結(jié)合在一起。但是,沒(méi)有哪一個(gè)PHP模板是最合適、最完美的。因?yàn)镻HP模板就是大眾化的東西,并不是針對(duì)某個(gè)人開(kāi)發(fā)的。如果能在對(duì)模板的特點(diǎn)、應(yīng)用有清楚的認(rèn)識(shí)基礎(chǔ)上,充分認(rèn)識(shí)到模板的優(yōu)勢(shì)劣勢(shì),就可以知道是否選擇使用模板引擎或選擇使用哪個(gè)模板引擎
自定義模板引擎類(lèi)
自定義模板引擎,能夠更好的掌握模板引擎的工作機(jī)制,為學(xué)習(xí)Smarty做好準(zhǔn)備。更重要的是,屬于自己的PHP模板引擎永遠(yuǎn)不是固定不變的,可以根據(jù)項(xiàng)目的需要為其量身定制
在下例中,通過(guò)前面介紹的模板引擎概念創(chuàng)建了屬于自己的一個(gè)簡(jiǎn)單模板引擎,可以用來(lái)處理模板的基本功能。例如:變量替換、分支結(jié)構(gòu)、數(shù)組循環(huán)遍歷,以及模板之間相互嵌套等,如下所示:
<?php
/**
file: mytpl.class.php 類(lèi)名為MyTpl是自定義的模板引擎
通過(guò)該類(lèi)對(duì)象加載模板文件并解析,將解析后的結(jié)果輸出
*/
class Mytpl {
public $template_dir = 'templates'; //定義模板文件存放的目錄
public $compile_dir = 'templates_c'; //定義通過(guò)模板引擎組合后文件存放目錄
public $left_delimiter = '<{'; //在模板中嵌入動(dòng)態(tài)數(shù)據(jù)變量的左定界符號(hào)
public $right_delimiter = '}>'; //在模板中嵌入動(dòng)態(tài)數(shù)據(jù)變量的右定界符號(hào)
private $tpl_vars = array(); //內(nèi)部使用的臨時(shí)變量
/**
將PHP中分配的值會(huì)保存到成員屬性$tpl_vars中,用于將模板中對(duì)應(yīng)的變量進(jìn)行替換
@param string $tpl_var 需要一個(gè)字符串參數(shù)作為關(guān)聯(lián)數(shù)組下標(biāo),要和模板中的變量名對(duì)應(yīng)
@param mixed $value 需要一個(gè)標(biāo)量類(lèi)型的值,用來(lái)分配給模板中變量的值
*/
function assign($tpl_var, $value = null) {
if ($tpl_var != '')
$this->tpl_vars[$tpl_var] = $value;
}
/**
加載指定目錄下的模板文件,并將替換后的內(nèi)容生成組合文件存放到另一個(gè)指定目錄下
@param string $fileName 提供模板文件的文件名
*/
function display($fileName) {
/* 到指定的目錄中尋找模板文件 */
$tplFile = $this->template_dir.'/'.$fileName;
/* 如果需要處理的模板文件不存在,則退出并報(bào)告錯(cuò)誤 */
if(!file_exists($tplFile)) {
die("模板文件{$tplFile}不存在!");
}
/* 獲取組合的模板文件,該文件中的內(nèi)容都是被替換過(guò)的 */
$comFileName = $this->compile_dir."/com_".$fileName.'.php';
/* 判斷替換后的文件是否存在或是存在但有改動(dòng),都需要重新創(chuàng)建 */
if(!file_exists($comFileName) || filemtime($comFileName) < filemtime($tplFile)) {
/* 調(diào)用內(nèi)部替換模板方法 */
$repContent = $this->tpl_replace(file_get_contents($tplFile));
/* 保存由系統(tǒng)組合后的腳本文件 */
file_put_contents($comFileName, $repContent);
}
/* 包含處理后的模板文件輸出給客戶(hù)端 */
include($comFileName);
}
/**
內(nèi)部使用的私有方法,使用正則表達(dá)式將模板文件'<{ }>'中的語(yǔ)句替換為對(duì)應(yīng)的值或PHP代碼
@param string $content 提供從模板文件中讀入的全部?jī)?nèi)容字符串
@return $repContent 返回替換后的字符串
*/
private function tpl_replace($content) {
/* 將左右定界符號(hào)中,有影響正則的特殊符號(hào)轉(zhuǎn)義 例如,<{ }>轉(zhuǎn)義\<\{ \}\> */
$left = preg_quote($this->left_delimiter, '/');
$right = preg_quote($this->right_delimiter, '/');
/* 匹配模板中各種標(biāo)識(shí)符的正則表達(dá)式的模式數(shù)組 */
$pattern = array(
/* 匹配模板中變量 ,例如,"<{ $var }>" */
'/'.$left.'\s*\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*'.$right.'/i',
/* 匹配模板中if標(biāo)識(shí)符,例如 "<{ if $col == "sex" }> <{ /if }>" */
'/'.$left.'\s*if\s*(.+?)\s*'.$right.'(.+?)'.$left.'\s*\/if\s*'.$right.'/ies',
/* 匹配elseif標(biāo)識(shí)符, 例如 "<{ elseif $col == "sex" }>" */
'/'.$left.'\s*else\s*if\s*(.+?)\s*'.$right.'/ies',
/* 匹配else標(biāo)識(shí)符, 例如 "<{ else }>" */
'/'.$left.'\s*else\s*'.$right.'/is',
/* 用來(lái)匹配模板中的loop標(biāo)識(shí)符,用來(lái)遍歷數(shù)組中的值, 例如 "<{ loop $arrs $value }> <{ /loop}>" */
'/'.$left.'\s*loop\s+\$(\S+)\s+\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*'.$right.'(.+?)'.$left.'\s*\/loop\s*'.$right.'/is',
/* 用來(lái)遍歷數(shù)組中的鍵和值,例如 "<{ loop $arrs $key => $value }> <{ /loop}>" */
'/'.$left.'\s*loop\s+\$(\S+)\s+\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*=>\s*\$(\S+)\s*'.$right.'(.+?)'.$left.'\s*\/loop \s*'.$right.'/is',
/* 匹配include標(biāo)識(shí)符, 例如,'<{ include "header.html" }>' */
'/'.$left.'\s*include\s+[\"\']?(.+?)[\"\']?\s*'.$right.'/ie'
);
/* 替換從模板中使用正則表達(dá)式匹配到的字符串?dāng)?shù)組 */
$replacement = array(
/* 替換模板中的變量 <?php echo $this->tpl_vars["var"]; */
'<?php echo $this->tpl_vars["${1}"]; ?>',
/* 替換模板中的if字符串 <?php if($col == "sex") { ?> <?php } ?> */
'$this->stripvtags(\'<?php if(${1}) { ?>\',\'${2}<?php } ?>\')',
/* 替換elseif的字符串 <?php } elseif($col == "sex") { ?> */
'$this->stripvtags(\'<?php } elseif(${1}) { ?>\',"")',
/* 替換else的字符串 <?php } else { ?> */
'<?php } else { ?>',
/* 以下兩條用來(lái)替換模板中的loop標(biāo)識(shí)符為foreach格式 */
'<?php foreach($this->tpl_vars["${1}"] as $this->tpl_vars["${2}"]) { ?>${3}<?php } ?>',
'<?php foreach($this->tpl_vars["${1}"] as $this->tpl_vars["${2}"] => $this->tpl_vars["${3}"]) { ?>${4}<?php } ?>',
/*替換include的字符串*/
'file_get_contents($this->template_dir."/${1}")'
);
/* 使用正則替換函數(shù)處理 */
$repContent = preg_replace($pattern, $replacement, $content);
/* 如果還有要替換的標(biāo)識(shí),遞歸調(diào)用自己再次替換 */
if(preg_match('/'.$left.'([^('.$right.')]{1,})'.$right.'/', $repContent)) {
$repContent = $this->tpl_replace($repContent);
}
/* 返回替換后的字符串 */
return $repContent;
}
/**
內(nèi)部使用的私有方法,用來(lái)將條件語(yǔ)句中使用的變量替換為對(duì)應(yīng)的值
@param string $expr 提供模板中條件語(yǔ)句的開(kāi)始標(biāo)記
@param string $statement 提供模板中條件語(yǔ)句的結(jié)束標(biāo)記
@return strin 將處理后的條件語(yǔ)句相連后返回
*/
private function stripvtags($expr, $statement='') {
/* 匹配變量的正則 */
$var_pattern = '/\s*\$([a-zA-Z_\x7f-\xff][a-zA-Z0-9_\x7f-\xff]*)\s*/is';
/* 將變量替換為值 */
$expr = preg_replace($var_pattern, '$this->tpl_vars["${1}"]', $expr);
/* 將開(kāi)始標(biāo)記中的引號(hào)轉(zhuǎn)義替換 */
$expr = str_replace("\\\"", "\"", $expr);
/* 替換語(yǔ)句體和結(jié)束標(biāo)記中的引號(hào) */
$statement = str_replace("\\\"", "\"", $statement);
/* 將處理后的條件語(yǔ)句相連后返回 */
return $expr.$statement;
}
}
?>
在Mytpl類(lèi)中聲明的多個(gè)方法中,除被封裝過(guò)的方法之外,只有兩個(gè)公有方法assign()和display()在創(chuàng)建對(duì)象以后可以被凋用。其中assign()方法用來(lái)將PHP腳本中的數(shù)據(jù)分配給模板中對(duì)應(yīng)的變量,display()方法則用來(lái)將特定的templates目錄下的模板文件加載到PHP腳本中。同時(shí)將模板文件中使用“<{”和“>>”標(biāo)記聲明的自定義模板語(yǔ)句,匹配出來(lái)并替換成相對(duì)應(yīng)的PHP語(yǔ)法格式,然后將替換后的內(nèi)容保存在特定的templates_c目錄下。在運(yùn)行時(shí)還要編譯成一個(gè)非模板技術(shù)的PHP文件,并將其以模板文件名加上“com_”前綴和“.php”的擴(kuò)展名形式保存。再通過(guò)include()函數(shù)將處理后的模板文件包含,并使用PHP解析后發(fā)送給客戶(hù)端
使用模板引擎
使用自定義的模板引擎比較容易,都是自己定義的語(yǔ)法格式。但要記住,所有流行的模板引繁解決方案都遵循同樣的一組相同的核心實(shí)現(xiàn)原則,就是與編程語(yǔ)言一樣,學(xué)習(xí)了一種語(yǔ)言就可以更容易地掌握其他語(yǔ)言。使用模板引擎最主要的原因就是將前端工程師和后端工程師的工作分開(kāi),所以模板引擎不僅后端工程師需要使用,前端工程師也需要使用
1、后端工程師對(duì)模板引擎的使用
在PHP腳本中包含模板引擎類(lèi)所在的文件。如下所示:
require("mytpl.class.php"); //包含模板引擎類(lèi),相當(dāng)于模板引擎安裝
創(chuàng)建模板引擎類(lèi)的對(duì)象并對(duì)一些成員屬性進(jìn)行初始化賦值。如下所示:
$tpl=new MyTpl(); //創(chuàng)建模板引擎類(lèi)的對(duì)象,也可以根據(jù)參數(shù)對(duì)成員初始化
將動(dòng)態(tài)數(shù)據(jù)(包括標(biāo)量和數(shù)組類(lèi)型的數(shù)據(jù),例如從數(shù)據(jù)庫(kù)的表中獲得的數(shù)據(jù)數(shù)組)使用模板引擎對(duì)象中的assign()方法分配給模板文件,這個(gè)方法可以使用多次,將任意多個(gè)變量分配給模板。如下所示:
?
1
2
$tpl->assign("var","this is a value"); //可以分配標(biāo)量類(lèi)型數(shù)據(jù),可以使用多次
$tpl->assign("arr",array(array(1,2),array("a","b"))); //也可以分配數(shù)組包括多維數(shù)組
在PHP腳本中通過(guò)調(diào)用模板對(duì)象中的display()方法,并將模板文件名作為參數(shù)傳入,就會(huì)加載指定目錄中對(duì)應(yīng)的模板文件到PHP腳本中。再通過(guò)模板引擎中的替換方法對(duì)模板中自定義的語(yǔ)法進(jìn)行解析,然后輸出處理后的模板。如下所示:
$tpl->display("test.tpl"); //參數(shù)“test.tpl”為特定目錄下的模板文件
2、前端工程師對(duì)模板引擎的使用
前端工程師需要將編寫(xiě)的模板文件存放到指定的目錄中,這個(gè)目錄是通過(guò)在模板對(duì)象中使用$template_dir屬性指定的,默認(rèn)的設(shè)置是當(dāng)前目錄下的“templates”目錄。另外,模板文件的命名以及后綴名的設(shè)置可以隨意,例如index.tpl、test.htm、header.tp;等
模板文件是通過(guò)使用HTML、CSS以及javascript等Web前臺(tái)語(yǔ)言以編寫(xiě)的純靜態(tài)負(fù)而。但可以在模板文件中使用“<{”和“}>”兩個(gè)分隔符中間定義一個(gè)變量(類(lèi)似PHP中的變量格式),該變量可以接受并輸出由PHP腳本中分配過(guò)來(lái)的動(dòng)態(tài)數(shù)據(jù)。在模板中使用的“<{”和“}>”兩個(gè)分隔符對(duì),也可以根據(jù)個(gè)人愛(ài)好在模板引擎類(lèi)中修改。如下所示:
姓名:<{$name}>,年齡:<{$age}>,性別:<{$sex}> //模板中使用占位符
如果在PHP腳本中是將數(shù)組分配給模板,也可以在模板中進(jìn)行遍歷,還可以通過(guò)嵌套的方式遍歷多維數(shù)組。使用的是在模板引擎中定義的“<{loop}>”標(biāo)記對(duì),使用的方式和PHP中foreach結(jié)構(gòu)的語(yǔ)法格式相似。如下所示:
<{loop $arr $value }> //遍歷數(shù)組$arr中的元素值
數(shù)組中的元素值<{$value}> //每次遍歷輸出元素中的值
<{/loop}> //在模板中遍歷數(shù)組的結(jié)束標(biāo)記
<{loop $arr $key=>$value }> //遍歷數(shù)組$arr中的元素下標(biāo)和元素值
數(shù)組中的元素鍵<{$key}> //每次遍歷輸出元素中的下標(biāo)
數(shù)組中的元素值<{$value}> //每次遍歷輸出元素中的值
<{/loop}> //在模板中遍歷數(shù)組的結(jié)束標(biāo)記
<{loop $arr $value }> //遍歷數(shù)組$arr中的元素值
<{loop $arr $data }> //使用嵌套標(biāo)記遍歷二維數(shù)組
數(shù)組中的元素值<{$value}> //每次遍歷輸出元素中的值
<{/loop}> //在模板中遍歷數(shù)組的內(nèi)層結(jié)束標(biāo)記
<{/loop}> //在模板中遍歷數(shù)組的外層結(jié)束標(biāo)記
模板引擎還可以解析在模板文件中使用特殊標(biāo)記編寫(xiě)的分支結(jié)構(gòu),語(yǔ)法風(fēng)格也是和PHP的分支結(jié)構(gòu)類(lèi)似。是通過(guò)在模板文件中使用“<{if}>”標(biāo)記對(duì)實(shí)現(xiàn)選擇結(jié)構(gòu),也可以實(shí)現(xiàn)多路分支和嵌套分支的選擇結(jié)構(gòu)。如下所示:?
<{if($var=="red")}>
<p style="color:red">這是“紅色”的字</p>
<{elseif($var=="green")}>
<p style="color:green">這是“綠色”的字</p>
<{else}>
<{if($size=20)}>
<p style="font-size:20">這是“20px”大小的字</p>
<{/if}>
<{/if}>
在自定義的模板引擎中,也添加了在模板文件中包含其他模板文件的功能?梢允褂“<{include‘子模板文件名'}>”標(biāo)記將子模板包含到當(dāng)前模板中,還支持在子模板中再次包括另外的子模板。如下所示:
<{include 'other.tpl' }>
使用示例分析
通過(guò)在程序中加載模板引擎可以將前端語(yǔ)言與后端語(yǔ)言的代碼分開(kāi)。首先在PHP程序中獲取數(shù)據(jù)庫(kù)中存儲(chǔ)的數(shù)據(jù),再通過(guò)加載模板引擎將數(shù)據(jù)分配出去,然后將模板文件再通過(guò)模板引擎加載并處理后輸出。所以PHP程序只是創(chuàng)建動(dòng)態(tài)數(shù)據(jù),加載模板引擎并將動(dòng)態(tài)數(shù)據(jù)分配給模板,完成了PHP程序的工作。而模板的設(shè)汁也只需要前端工程師獨(dú)立完成,使用HTML、CSS及javascript等前臺(tái)頁(yè)面設(shè)計(jì)語(yǔ)言編寫(xiě)。另外,在模板文件中還需要使用模板引擎可以解析的標(biāo)記,將PHP中分配過(guò)來(lái)的動(dòng)態(tài)數(shù)據(jù)在模板中引用
1、數(shù)據(jù)庫(kù)的設(shè)計(jì)
假設(shè)數(shù)據(jù)庫(kù)服務(wù)器在“localhost”主機(jī)上,連接的用戶(hù)名和密碼分別為“admin”和“123456”,在該服務(wù)器上創(chuàng)建一個(gè)名為“mydb”的數(shù)據(jù)庫(kù),并在該數(shù)據(jù)庫(kù)中創(chuàng)建一個(gè)名為“User”的用戶(hù)表。創(chuàng)建該表的SQL査詢(xún)語(yǔ)句如下所示:
CREATE TABLE User(
id SMALLINT(3) NOT NULL AUTO_INCREMENT,
name VARCHAR(10) NOT NULL DEFAULT '',
sex VARCHAR(4) NOT NULL DEFAULT '',
age SMALLINT(2) NOT NULL DEFAULT '0',
email VARCHAR(20) NOT NULL DEFAULT '',
PRIMARY KEY (id)
);
用戶(hù)表User創(chuàng)建完成以后,接著可以向該表中插入一些數(shù)據(jù)作為示例演示使用,SQL查詢(xún)語(yǔ)句如下所示:
INSERT INTO User (name,sex,age,email) VALUES
("a","男",27,"a@a.com"),
("b","女",22,"b@b.com"),
("c","女",30,"c@c.com"),
【PHP的自定義引擎使用方法】相關(guān)文章:
PHP構(gòu)建自定義搜索引擎的方法10-24
PHP分頁(yè)自定義函數(shù)09-08
利用PHP自定義多進(jìn)制06-16
PHP中trait的使用方法08-20
php自定義函數(shù)實(shí)現(xiàn)漢字分割替換06-01
PHP引擎全速運(yùn)轉(zhuǎn)的三個(gè)絕招07-22
php-smarty模版引擎中的緩存應(yīng)用04-23
php中iconv函數(shù)使用方法08-23