一.介紹
現在在開發WEB應用的時候，比較流行的一種做法就是使用“MVC”結構，使用如此方式去開發WEB應用程序，邏輯性強、簡浩明了，使程序設計起來更加方便，快捷。何為“MVC”呢？簡單的來說，它就是“模型（Model）”、“視圖（View）”及“控制器（Controller）”的結合體，也就是所有的“三層”抽象結構，當然這裡所說的“MVC”是針對WEB上應用而言的，“使代碼和頁面設計分開”便是其主導思想，這一思想在使用Java Servlet/JavaServer Pages技術的“Struts”中表現的淋漓盡致，有興趣的可以去http://jakarta.apache.org/struts看看，這種設計模式使的程序設計人員可以專注於代碼的設計、編寫及調試，網頁設計人員可以有更多的時間去投入設計而不用理會具體的功能實現，這種分工方式完全適應大型項目或企業級的分布式應用開發。
從PHP5的推出可以看到，其中的面向對象功能越來越完善，使用PHP來開發大型的商業網站或者分布式企業應用已經成為可能，如果再結合Zend Optimizer，已經實現了代碼的封裝性。
如何在PHP中使用“MVC”設計模式去開發WEB應用呢？記住一點（代碼和頁面設計分開），用一個簡單的例子演示一下，比如要從數據庫中查詢出會員的資料以顯示在網頁上，這裡就需要考慮到兩點：1.連接數據庫並取出會員資料，2.把會員資料顯示在網頁上，連接數據庫我們使用一個數據庫的類，把它叫做“DB”類吧，這個類此時就扮演了“模型（Model）”的角色，接著我們需要編寫一個操作“DB”類的程序以取出數據，這個程序所扮演的角色就是“控制器（Controller）”，它接受客戶端“POST”或“PUT”的數據，然後再調用“DB”類以取出數據，把這些數據都存放在“控制器（Controller）”中，最後把數據傳遞給“視圖（View）”並按照一定的排版格式顯示出來，從上面的分析可以看出，模板在這裡就是扮演了“視圖（View）”的角色，當然僅僅一個模板類是不能說成是MVC的，真正的MVC不是這麼簡單的，具體可以參考一下“JSF”。
“3t”是一個模板類，主要是讀取“控制器（Controller）”的數據並進行一些特殊處理，最後通過一些簡單的模板語法把數據顯示出來，它具有一些什麼樣的特點呢？
解析速度快，可以根據需要選擇使用html方式緩存或php方式緩存，當然你也可以不用緩存，同樣可以實現快速穩定的WEB應用
使用簡單、安裝操作方便，在數據的讀取方面類似著名模板類“SMARTY”，在數據顯示方面即類似“PHP的語法”又類似“JavaBeans”
可擴展性好，你可以根據需要隨時加入你想要的功能，因為它是開源的，在不久的日子裡，將支持插件功能
伸縮性好，支持最新的PHP5，只要你的PHP版本>=4.0.6即可使用，當然你需要有在服務器操作文件的權限
功能強大，支持模板的多級嵌套，數組多級循環等等
當然此模板還需完善的地方很多，有待在各種環境測試使用才能不斷完善，目前僅在LINUX和WINDOWS環境下測試通過.
二.安裝
1.解壓後應該可以看到如下目錄結構:
./3tx.x/cmp/ 編譯後的文件(請確保此文件夾可讀寫)
./3tx.x/tpl/ 模板文件(模板文件都放在這裡，確保此文件夾可讀)
./3tx.x/che/ 緩存文件存放的文件夾(請確保此文件夾可讀寫)
./3tx.x/ttt/ttt.php 3T模板類文件
./3tx.x/ 程序文件(您寫的程序都放在這裡)
2.您的PHP版本不能低於PHP4.0.6,我建議你的PHP版本升級至4.3.0以上,程序的整體性能將得到會大幅度提高
3.運行時如出現變量未定義請在程序前加上"error_reporting(7);"函數
三.語法
模板簡單語法說明:
一般使用左邊大括號"{"和右邊大括號"}"作為模板語法的開始和結束,當然也可以使用自定義的分隔符,如使用"["和"]",以下說明以大括號為分隔符進行說明
(注;下面的[tplCode]和[/tplCode]中間的代碼才是模板語法代碼)
1.在模板文件中使用PHP代碼,如:
[tplCode]
{php}
$i = 3;
echo $i;
{/php}
[/tplCode]
請參考"example6"
2.在模板中使用foreach循環,如:
第一種用法(循環數組$a,相當於PHP中的foreach($a as $k=>$v)....)
[/tplCode]
{foreach:$a,$k,$v}
$v = {$v}<br>
{/foreach}
[/tplCode]
第二種用法(可以設定循環幾次,假如數組$a有15個元素,則下面的循環則只取最前面5個)
[tplCode]
{foreach:$a,$k,$v,5}
$v = {$v}<br>
{/foreach}
[/tplCode]
第三種用法(可以設定循環幾次,假如數組$a有15個元素,則下面的循環則從第3個元素開始,取到第5個元素結束)
[tplCode]
{foreach:$a,$k,$v,3,5}
$v = {$v}<br>
{/foreach}
[/tplCode]
請參考"example1"和"example3",在"foreach"循環中可以使用多維數組,具體請看"example10"
3.在模板中使用IF語句,如:
第一種用法
[tplCode]
{if:$a == "hello"}
變量$a的值是"hello"
{/if}
[/tplCode]
第二種用法
[tplCode]
{if:$a == true}
變量$a為真
{else}
變量$a不為真
{/if}
[/tplCode]
第三種用法
[tplCode]
{if:$a == 2}
變量$a的值為2
{elseif:$a == 3}
變量$a的值為3
{/if}
[/tplCode]
具體使用請參考"example2"及"example6"
4.在模板中包含模板文件,如:
{tplCode}
{includetpl:head.tpl}
{/tplCode}
這裡包含了模板文件"head.tpl",所包含的模板文件必須在同一個目錄下
5.在模板中包含PHP文件,如:
{tplCode}
{includephp:head.php}
{/tplCode}
這裡包含了PHP文件"head.php",文件"head.php"在當前程序目錄下
包含文件請看"example8"
6.在模板中輸出時間,如:
{tplCode}
{date:Y-m-d H:i:s}
{/tplCode}
後面的"Y-m-d H:i:s"字符串是標准的PHP時間標識,具體使用可以參考PHP手冊
具體使用請參考"example7"
7.在模板中使用數學函數
第一種用法,直接輸出結果
{tplCode}
{math:3*2-5}
{/tplCode}
第二種用法,賦值給指定變量
{tplCode}
{math:3*2-5,$result}
{/tplCode}
第三種用法,賦值給指定變量,第三個參數設置是否立即輸出,設為"Y"輸出,"N"不輸出
{tplCode}
{math:3*2-5,$result,Y}
{/tplCode}
具體使用請參考"example4"
8.在模板中使用FOR循環
如下代碼所示
[tplCode]
{for:5,1000,1,$i}
{$i}<br>
{/for}
{/tplCode}
參數說明:
5:表示從5開始循環
1000:表示循環到1000結束
1:表示每次循環的增量為1,相當於$n++
$i:表示得到每次循環的值
(上面的"5","1000","1"之類的常數也可用變量來代替,如:{for:$num,$max,$step,$i},其中的變量是在程序中用"assign()"方法賦值的)
也參考如下代碼(理解一下):
[tplCode]
{for:500,30,-2,$i}
從500開始循環,每次減2,直到30才結束,當前循環的值是:<b>{$i}</b><br>
{/for}
{/tplCode}
具體使用請參考"example2","example11"
9.在模板中使用Email標簽
第一種用法:
[tplCode]
{email:[email protected]}
[/tplCode]
第二種用法:
[tplCode]
{email:[email protected],Redhat的郵箱}
[/tplCode]
第三種用法:
[tplCode]
{email:[email protected],這是"Redhat"的郵箱<-dh->這個是帶樣式的<-dh->class=m,m}
[/tplCode]
具體使用請參考"example5"
10.在模板中定義變量
[tplCode]
{assign:$tplVar,這是我定義的變量<-dh->可以在模板中輸出也可用PHP代碼輸出}
[/tplCode]
具體使用請參考"example6".
11.其它語法及功能尚在開發中......
有好的意見或想法請去http://2002.buyionline.net/2002/gbook.php提一下吧,發現BUG也請及時留言說明一下,謝謝!
注:
1.本模板支持多層嵌套的模板或PHP文件,支持多層foreach或for循環
2.實際使用技巧
在實際使用過程中如果把屬性$cmpCheck設置為true則每次運行都會編譯PHP程序,否則程序會根據編譯後的PHP文件的存在時間長短判斷是否要重新編譯
該屬性默值即為true,一般在正在使用中才設為false(可加快速度)
設置方法如:$tttObj->setCmpCheck(true);
3.本程序最大的缺點就是不能准確的捕捉程序中出現的語法錯誤信息
4.暫不支持緩存功能,如果你有好的想法不妨告訴我:-)
5.由於采用的是混編模式編譯模板為PHP文件,所以請不要輸錯了(當然模板是支持大小寫一致的寫法的,也就是說你寫一個{math:38*7}和{MatH:38*7}的效果是一樣的),如輸入"{foreach:$data,k,$v}"編譯將通過,但運行的時候會導致一個語法錯誤,因為裡面的"k"前面少了一個"$"符號.本來已經寫好了對每一行進行語法分析捕捉錯誤的代碼,但發現代碼達到幾百行的時候占用時間比較長,如果代碼比較少還可以,但如果較多的話會導致性能的下降.而且PHP本身就有很不錯的出錯信息提示,後來想想就沒有去進行每行代碼的分析了.
6.不知大家是否注意到,在以上的標識中,參數都是不帶引號或雙引號的(條件判斷語句除外),希望注意哦:-)
四.使用
1.建立PHP文件(命名為first.php,保存在當前目錄下,即"./"),內容如下:
<?php
require_once "./ttt/ttt.php";//引入類文件
$ttt = new TTT();//初始化3T模板類的實例
$ttt->setTplDir("./tpl/");//需要編譯的模板文件存放目錄
$ttt->setCmpDir("./cmp/");//編譯後文件的存放目錄
$ttt->assign('title','天空的顏色');//設置變量
$ttt->assign('content','藍色,天氣不錯,萬裡無雲,晴');//設置變量
$ttt->assign('foot','歡迎歡迎');//設置變量
$ttt->display('first.tpl');//輸出
?>
2.建立tpl文件(命名為"first.tpl",保存在目錄"./tpl/"下).內容如下:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=gb2312">
<title>{$title}</title>
</head>
<body>
{$content}<br>
<br>
{$foot}
</body>
</html>
3.在浏覽器浏覽http://domain/path/to/3tvx.x/3t/first.php即可看到結果,當然你先要把PHP的運行環境配置好.
4.更多例子請看程序自帶的"example"系列...
五.類屬性(部分)
$tplDir:String,"./tpl/"
模板文件的目錄,需要加載的模板就從此處加載
$cmpDir:String,"./cmp/"
編譯後的PHP文件存放目錄
$cheDir:String,"./che/"
$tplFile:String,""
模板文件,所要解析的模板主文件
$startLeft:String,"{"
模板變量的左邊界符號,可以自己通過setLeft(String $s)方法去設置
$startRight:String,"}"
模板變量的右邊界符號,可以自己通過setRight(String $s)方法去設置
六.類方法(部分)
TTT(String|null)
類構造器,可以在此直接設置需要解析的模板,如:$obj->TTT("head.tpl");
setLeft(String)
設置模板變量"$startLeft"的左邊界,該變量默認為"{"
setRight(String)
設置模板變量"$startRight"的左邊界,該變量默認為"{"
setTplDir(String)
設置模板的存放路徑,此方法的同名方法是"setTemplatesFile()"
setCmpDir(String)
設置模板編譯後的存放路徑,此方法的同名方法是"setCompilesFile()"
setCheFile(String)
設置緩存的模板文件目錄,此方法的同名方法是"setCachesFile()"
setCacheFilter(String|array)
當使用了模板的緩存功能時,使用此方法設置的文件將不被緩存處理
setWordsFilter(array)
設置不宜在網站上顯示的字符或字符串,如:$ttt->setWordsFilter('abc','xyz');,把網頁中的所有"abc"替換成"xyz";
setWordsFile(String|array)
當設置了不宜在網站上顯示的字符或字符串時,用此方法設置的文件中的字符或字符串將會不受"setWordsFilter()"方法影響而直接顯示
setQuery(String)
此方法只在使用了模板的緩存功能時才使用,主要是用來設置唯一的一串字符以使緩存文件不會重復,如果沒有設置的話模板也會自動獲取但會使程序變的不安全，只要不斷的向程序GET不同的參數變會一直生成不同的緩存文件，Ｎ時間後，我想你服務器的硬盤就沒空間了，當然這些只有在你使用了緩存功能並沒有使用此方法設置唯一字符串所造成的，所以正確設置並在程序中處理一些GET或POST的值就顯的很重要。可以像這樣使用此方法"$ttt->setQuery("typeid=$tid&msgid=$sid")"，這裡要注意當惡意用戶提交不同的$tid或$sid時也會導致上述的攻擊事件，所以必須在程序中捕捉到非法的$tid和$sid並停止執行"$ttt->display()"方法。
assign(String,String|array)
設置在模板中要用到的變量,第一個參數為模板中要用到的變量,第二個參數為用戶定義的值,如下:
$obj->assign('webName','主頁名字');
$obj->assign('userID',array(23,37,12,18));
display(String|null)
輸出解析後的模板,參數為要輸出的模板文件名(如果在類的初始化或使用了方法"setTplFile()"已經設置過,在使用本方法時可以不用帶參數)
