手把手带你认识DedeCms模板的勾子技术
时间:2009-04-07
作者:佚名
出处:互联网
勾子技术DedeCms V5.3最大的改变之一,可能大家不大理解勾子这名称,说具体些,在DedeCms里有很多模板调用标签,实际上,这些标签是通过解析后,按不同名称和属性返回不同内容来替代的,在不使用模板引擎的情况下,一个函数调用就可以认为是勾子的一种体现,这也是一些论坛程序的做法,但这种做法始终需要在核心一些文件加入一些代码,即使是最简单的代码,对升级显然是有一定麻烦的,而DedeCms V5.3的勾子技术则改变了这种做法,它的原理与一些框架的MVC机制类似,不过它不是动态产生触发器,而是动态解析标签。
什么是动态解析标签?简单的来说就是模板里存在什么标记就调用什么代码去解析,这样不必要载入一些多余的代码,而且扩展更加灵活,在具体说明前,先用一个例子简单说明DedeCms模板引擎的使用。
以下示例代码可以放在安装了dedecms系统的根目录中使用。
以下为引用的内容:
- <?php
- //引入必须文件
- require_once(dirname(__FILE__)."/include/commin.inc.php");
- require_once(dirname(__FILE__)."/include/channelunit.func.php");
- require_once(dirname(__FILE__)."/include/dedetag.class.php");
- //初始化模板类
- $dtp = new DedeTagParse();
- $dtp->SetNameSpace("dede","{","}");
- //引用当前类([1]这里为空,后面会说明用途)
- $dtp->refObj = null;
- //载入模板
- $dtp->LoadTemplet($filename);
- //动态解析 include/taglib 里的标签 [2]
- MakeOneTag($dtp, null);
- //解析系统标签,显示内容
- $dtp->Display();
- //类似方法:GetResult() 获得解析后的HTML,SaveTo($filename)保存为文件
- ?
|
在以上例子中,比较不好理解的是两个 null,其实如果在类中调用这模板类,通常表示为 $this
具体原因需要分析 channelunit.func.php 里的
MakeOneTag(&$dtp,&$refObj)
这个函数的第一个参数不用说都知道是模板类本身的对象实例,如$refObj就是引入这个模板类的类,在Dedecms中,凡是 include/arc. 开头的文件都是这种文档解析类的具体功能类。
它的具体代码如下:
以下为引用的内容:
- function MakeOneTag(&$dtp,&$refObj)
- {
- $alltags = array();
- //读取自由调用tag列表
- $dh = dir(DEDEINC.'/taglib');
- while($filename = $dh->read())
- {
- if(ereg("\.lib\.",$filename))
- {
- $alltags[] = str_replace('.lib.php','',$filename);
- }
- }
- $dh->Close();
- //遍历tag元素
- if(!is_array($dtp->CTags))
- {
- return '';
- }
- foreach($dtp->CTags as $tagid=>$ctag)
- {
- $tagname = $ctag->GetName();
-
- //解析通用的 field 标签 [1]*
- if($tagname=='field')
- {
- $vname = $ctag->GetAtt('name');
- if(isset($refObj->Fields[$vname]))
- {
- $dtp->Assign($tagid, $refObj->Fields[$vname]);
- }
- else if( isset( $this->TypeLink->TypeInfos[$vname] ) )
- {
- $dtp->Assign($tagid, $this->TypeLink->TypeInfos[$vname]);
- }
- continue;
- }
- //同名标记(兼容旧版)处理
- if(ereg("^(artlist|likeart|hotart|imglist|imginfolist|coolart|specart|autolist)$",$tagname))
- {
- $tagname='arclist';
- }
- if($tagname=='friendlink')
- {
- $tagname='flink';
- }
-
- //给不同的标记调用不同的解析文件 [2]*
- if(in_array($tagname,$alltags))
- {
- $filename = DEDEINC.'/taglib/'.$tagname.'.lib.php';
- include_once($filename);
- $funcname = 'lib_'.$tagname;
- $dtp->Assign($tagid,$funcname($ctag,$refObj));
- }
- }
- }
|