靜態(tài)模板類(lèi)類(lèi)文件織夢(mèng)模板引擎是一種使用XML名字空間形式的模板解析器

使用織夢(mèng)解析器解析模板的最大好處是可以輕松的制定標(biāo)記的屬性，感覺(jué)上就像在用HTML一樣，使模板代碼十分直觀(guān)靈活，新版的織夢(mèng)模板引擎不單能實(shí)現(xiàn)模板的解析還能分析模板里錯(cuò)誤的標(biāo)記。

include/dedetag.class.php這個(gè)文件是dedecms V5.3及之前版本使用的主要的模板類(lèi)，它是解析式模板類(lèi)，并非編譯式的（區(qū)別是前者通過(guò)獲得標(biāo)簽位置進(jìn)行內(nèi)容替換，后者是直接解析式PHP代碼，二次執(zhí)行）

一、模板語(yǔ)法

1、織夢(mèng)模板引擎的代碼樣式有如下幾種形式：

{dede:標(biāo)記名稱(chēng) 屬性='值'/}

{dede:標(biāo)記名稱(chēng) 屬性='值'}{/dede:標(biāo)記名稱(chēng)}

{dede:標(biāo)記名稱(chēng) 屬性='值'}自定義樣式模板(InnerText){/dede:標(biāo)記名稱(chēng)}

提示：

如果使用帶底層模板的標(biāo)記，必須嚴(yán)格用{dede:標(biāo)記名稱(chēng) 屬性='值'}{/dede:標(biāo)記名稱(chēng)} 這種格式，否則會(huì)報(bào)錯(cuò)。

2、織夢(mèng)模板引擎內(nèi)置有多個(gè)系統(tǒng)標(biāo)記，這些系統(tǒng)標(biāo)記在任何場(chǎng)合都是能直接使用的。

(1) global 標(biāo)記，表示獲取一個(gè)外部變量，除了數(shù)據(jù)庫(kù)密碼之外，能調(diào)用系統(tǒng)的任何配置參數(shù)，形式為：

{dede:global name='變量名稱(chēng)'}{/dede:global}

或

{dede:global name='變量名稱(chēng)'/}

其中變量名稱(chēng)不能加 $ 符號(hào)，如變量 $cfg_cmspath ，應(yīng)該寫(xiě)成 {dede:global name='cfg_cmspath'/} 。

(2) foreach 用來(lái)輸出一個(gè)數(shù)組，形式為：

{dede:foreach array='數(shù)組名稱(chēng)'}[field:key/] [field:value/]{/dede:foreach}

(3) include 引入一個(gè)文件，形式為：

{dede:include file='文件名稱(chēng)' ismake='是否為dede板塊模板(yes/no)'/}

對(duì)文件的搜索路徑為順序?yàn)椋航^對(duì)路徑、include文件夾，CMS安裝目錄，CMS主模板目錄

3、織夢(mèng)標(biāo)記允許在任何標(biāo)記中使用函數(shù)對(duì)得到的值進(jìn)行處理，形式為：

{dede:標(biāo)記名稱(chēng) 屬性='值' function='youfunction("參數(shù)一","參數(shù)二","@me")'/}

其中 @me 用于表示當(dāng)前標(biāo)記的值，其它參數(shù)由你的函數(shù)決定是否存在，例如：

{dede:field name='pubdate' function='strftime("%Y-%m-%d %H:%M:%S","@me")'/}

4、織夢(mèng)標(biāo)記允許有限的編程擴(kuò)展。

格式為：

代碼如下:

{dede:tagname runphp='yes'}

$aaa = @me;

@me = "123456";

{/dede:tagname}

@me 表示這個(gè)標(biāo)記本身的值，因此標(biāo)記內(nèi)編程是不能使用echo之類(lèi)的語(yǔ)句的，只能把所有返回值傳遞給@me。

此外由于程序代碼占用了底層模板InnerText的內(nèi)容，因此需編程的標(biāo)記只能使用默認(rèn)的InnerText。

二、解析方式

在 dedetag.class.php 里面有四個(gè)類(lèi)

class DedeAttribute 屬性結(jié)構(gòu)表述

class DedeAttributeParse 屬性解析器

class DedeTag 標(biāo)簽結(jié)構(gòu)表述

class DedeTagParse 標(biāo)簽解析器

使用解析類(lèi)解析模板時(shí)一般經(jīng)過(guò)下面的步驟

1、初始化：

$dtp = new DedeTagParse();

2、載入模板/模板字符串：

$dtp->LoadTemplate(模板文件（絕對(duì)路徑）); //會(huì)生成緩存，第二次不需解析模板

或

$dtp->LoadSource(字符串);

3、給標(biāo)簽賦值

foreach($dtp->CTags as $tid=>$ctag) {

//判斷ctag的名稱(chēng)和屬性，并給賦不同的值，通常用函數(shù)處理

if($ctag->GetName=='mytag') $dtp->Assign($tid, mytagvalue($ctag) );

}

在上面例子中，直接把名稱(chēng)為 mytag的標(biāo)簽轉(zhuǎn)交給 mytagvalue 函數(shù)處理，mytagvalue 里判斷$ctag的各個(gè)屬性，返回不同內(nèi)容即可。

在 V5.3版本中，通常除了field、list等專(zhuān)用標(biāo)簽之外，凡arc.*開(kāi)頭的類(lèi)解析的文件，標(biāo)簽都是對(duì)應(yīng)該 include/taglib 的源碼的，這個(gè)由系統(tǒng)進(jìn)行了自動(dòng)的映射。

4、顯示或保存為HTML

$dtp->display();

或

$dtp->SaveTo(靜態(tài)文件名);

對(duì)于二次開(kāi)發(fā)人員而言，不大需要知道dedecms模板具體解析方式，不過(guò)應(yīng)該十分清楚CTag這個(gè)類(lèi)的結(jié)構(gòu)，從而判斷標(biāo)簽不同屬性進(jìn)行處理。

代碼如下:

class DedeTag

{

var $IsReplace=FALSE; //標(biāo)記是否已被替代，供解析器使用

var $TagName=""; //標(biāo)記名稱(chēng)

var $InnerText=""; //標(biāo)記之間的文本

var $StartPos=0; //標(biāo)記起始位置

var $EndPos=0; //標(biāo)記結(jié)束位置

var $CAttribute=""; //標(biāo)記屬性描述,即是class DedeAttribute

var $TagValue=""; //標(biāo)記的值

var $TagID = 0;

//獲取標(biāo)記的名稱(chēng)和值

function GetName()

{

return strtolower($this->TagName);

}

function GetValue()

{

return $this->TagValue;

}

//下面兩個(gè)成員函數(shù)僅是為了兼容舊版

function GetTagName()

{

return strtolower($this->TagName);

}

function GetTagValue()

{

return $this->TagValue;

}

//獲取標(biāo)記的指定屬性

function IsAttribute($str)

{

return $this->CAttribute->IsAttribute($str);

}

function GetAttribute($str)

{

return $this->CAttribute->GetAtt($str);

}

function GetAtt($str)

{

return $this->CAttribute->GetAtt($str);

}

function GetInnerText()

{

return $this->InnerText;

}

}