毛毛蟲教你寫一個屬於自己的模板引擎

作者：Eve Cole 更新時間：2009-06-07 14:57:25

#phpchina首發#

Smarty一直被人視為多餘的東西，我覺得認為Smarty多餘的人才是多餘的....不說這些了。今天我就教大家寫個模板引擎，讓大家都可以寫一個屬於自己的模板引擎，而且看完這篇文章之後，你對Smarty的認識會更進一步的。我的模板引擎名叫Stupid（"傻瓜"的意思），我不喜歡太聰明的東西！
Stupid模板引擎是由3個檔案組成，分別是：stupid.class.php，stupid_parser.class.php，stupid_debugger.class.php。
Stupid.class.php的任務是設定變量，模板路徑，和顯示等功能，而stupid_parser.class.php就是編譯模板檔案的，stupid_debugger.class.php是用來偵錯用的。

好了，我們現在就先寫stupid.class.php吧。
1.新建一個PHP檔案名稱：stupid.class.php。
我們的類別叫Stupid，我們先設計一下成員變數吧。
成員變數有：$_tpl_vars, $_tpl_file, $_parser, $_debugger;
$_tpl_vars: 用來保存模板變數的;
$_tpl_file: 用來儲存模板檔案名稱的;
$_parser: 保存StupidParser物件的,就是編譯物件;
$_debugger: 保存StupidDebug物件的,就是偵錯物件;

下面定義了兩個常數，用來存放模板資料夾和編譯資料夾的：
define('TPL_DIR', './templates/');
define('TPL_C_DIR', './templates_c/');

開始編碼了>>>

<?php
define('TPL_DIR', './templates/');
define('TPL_C_DIR', './templates_c/');

class Stupid {
private $_tpl_vars;
private $_tpl_file;
private $_parser;
private $_debugger;
}
?>

開始寫個構造子>>>

public function Stupid() {
if(!is_dir(TPL_DIR) || !is_dir(TPL_C_DIR)) {
exit('錯誤：請正確設定模板資料夾和編譯資料夾');
}
}

在建構器中,我們判斷了模板路徑和編譯路徑是否設定正確.

設計我們的方法我們這個類別中主要有以下方法:
assign(), set_tpl_dir(), set_parsed_dir(), display(), debug().
assign()方法:
assign()的用處是設定模板變數.程式碼如下>>>

public function assign($var, $value) {
if(isset($var) && trim($var) != '') {
$this->_tpl_vars[$var] = $value;
return true;
} else {
exit('錯誤：請設定變數名稱');
}
}
我們先判斷使用者是否設定了變數名稱,用isset($var) && trim($var) != ''來判斷, trim($var) != ''是防止使用者以空格來設定變數名稱.如果設定變數正確,我們就將他儲存到成員變數_tpl_vars中.

display()方法
display()方法是Stupid類別中最重要的方法,他是用來顯示和檢測模板是否更新了,更新了就再編譯,沒有更新就用原來編譯之後的文件.代碼

如下>>>

public function display( $tpl_file) {
$template_file = TPL_DIR.$tpl_file;
if(!file_exists($template_file)) {
exit('錯誤：範本檔案不存在');
}

$parsed_file = TPL_C_DIR.md5($tpl_file).'.php';
if(!file_exists($parsed_file) || filemtime($parsed_file) < filemtime($template_file)) {
require_once './stupid_parser.class.php';
$this->_parser = new StupidParser();
$this->_parser->compile($tpl_file);
}
include $parsed_file;
}

這個方法是根據!file_exists($parsed_file)||filemtime($parsed_file)< filemtime($template_file)這條語句來判斷是否編譯過和模板文件是否更新過, 沒有編譯過和更新過模板文件都要重新編譯.我們就要引入stupid_parser.class.php,並創建StupidParser對象,對模板文件進行編譯.編譯完,我們就引入編譯之後的文件.這個編譯之後的模板文件就是一個普通的PHP文件.

debug()方法
Debugg()方法就比較簡單,就是引入stupid_debugger.class.php檔,建立StupidDebuger物件,呼叫StupidDebuger的start方法進行偵錯.

程式碼如下>>>

public function debug ($tpl_file) {
if (include_once("stupid_debugger.class.php")) {
$this->_debugger = new StupidDebugger(TPL_DIR. $tpl_file);
$this->_debugger->start();
} else {
exit( '錯誤:Debuger類別檔案不存在');
}
}

至此,我們的Stupid類別就寫完了!下次我要介紹StupidParser類別的編寫.請繼續支持.大家有什麼意見或建議可以提出!

show show全相：

<?php
define('TPL_DIR', './templates/');
define('TPL_C_DIR', './templates_c/');
class Stupid {
private $_tpl_vars;
private $_tpl_file;
private $_parser;
private $_debug;

public function Stupid() {
if(!is_dir(TPL_DIR) || !is_dir(TPL_C_DIR)) {
exit('錯誤：請正確設定模板資料夾和編譯資料夾');
}
}

public function assign($var, $value) {
if(isset($var) && trim($var) != '') {
$this->_tpl_vars[$var] = $value;
return true;
} else {
exit('錯誤：請設定變數名稱');
}
}

public function display($tpl_file) {
$template_file = TPL_DIR.$tpl_file;
if(!file_exists($template_file)) {
exit('錯誤：範本檔案不存在');
}

$parsed_file = TPL_C_DIR.md5($tpl_file).'.php';
if(!file_exists($parsed_file) || filemtime($parsed_file) < filemtime($template_file)) {
require_once './stupid_parser.class.php';
$this->_parser = new StupidParser();
$this->_parser->compile($tpl_file);
}
include $parsed_file;
}