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

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

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

一、模板語法

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

{dede:標記名稱 屬性='值'/}

{dede:標記名稱 屬性='值'}{/dede:標記名稱}

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

提示：

如果使用帶底層模板的標記，必須嚴格用{dede:標記名稱 屬性='值'}{/dede:標記名稱} 這種格式，否則會報錯。

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

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

{dede:global name='變量名稱'}{/dede:global}

或

{dede:global name='變量名稱'/}

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

(2) foreach 用來輸出一個數(shù)組，形式為：

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

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

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

對文件的搜索路徑為順序為：絕對路徑、include文件夾，CMS安裝目錄，CMS主模板目錄

3、織夢標記允許在任何標記中使用函數(shù)對得到的值進行處理，形式為：

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

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

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

4、織夢標記允許有限的編程擴展。

格式為：

代碼如下:

{dede:tagname runphp='yes'}

$aaa = @me;

@me = "123456";

{/dede:tagname}

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

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

二、解析方式

在 dedetag.class.php 里面有四個類

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

class DedeAttributeParse 屬性解析器

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

class DedeTagParse 標簽解析器

使用解析類解析模板時一般經(jīng)過下面的步驟

1、初始化：

$dtp = new DedeTagParse();

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

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

或

$dtp->LoadSource(字符串);

3、給標簽賦值

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

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

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

}

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

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

4、顯示或保存為HTML

$dtp->display();

或

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

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

代碼如下:

class DedeTag

{

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

var $TagName=""; //標記名稱

var $InnerText=""; //標記之間的文本

var $StartPos=0; //標記起始位置

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

var $CAttribute=""; //標記屬性描述,即是class DedeAttribute

var $TagValue=""; //標記的值

var $TagID = 0;

//獲取標記的名稱和值

function GetName()

{

return strtolower($this->TagName);

}

function GetValue()

{

return $this->TagValue;

}

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

function GetTagName()

{

return strtolower($this->TagName);

}

function GetTagValue()

{

return $this->TagValue;

}

//獲取標記的指定屬性

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;

}

}