勾子技术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));
- }
- }
- }
|
以上代码的重点就是 [1] [2] 标注的地方
[1]是解析文档中field标签，这个标签对于文档类中，都必使用 var Fields; 数组来表示这些通用文档字段，但对于不同模板，它的值也是可变的。
[2]就是勾子技术的关键，给field以及系统标记以外的标记调用不同的具体解析代码，这里规定了这些代码必须放在include/taglib文件夹内，名称为“标记名.lib.php”，而这个文件里定义的接口函数格式为：
以下为引用的内容：
- <?php
- if(!defined('DEDEINC'))
- {
- exit("Request Error!");
- }
- function lib_标记名称(&$ctag,&$refObj)
- {
- global $dsql,$envs;
- //属性处理
- $attlist="row|12,titlelen|24";
- FillAttsDefault($ctag->CAttribute->Items,$attlist);
- extract($ctag->CAttribute->Items, EXTR_SKIP);
- $revalue = '';
- //你需编写的代码，不能用echo之类语法，把最终返回值传给$revalue
- //------------------------------------------------------
- $revalue = 'Hello Word!';
- //------------------------------------------------------
- return $revalue;
- }
- ?>
|
到这里就完全揭开了DedeCms V5.3勾子技术的真正面目，上面还有一个没交待清楚的是
“$dtp->refObj = null;” 这个地方，其实对于Dedecms的文档解析类，100%都是面向对象的，它在类里通常是写为
“$this->dtp->refObj = $this;” 这个对象正是 function lib_标记名称(&$ctag,&$refObj) 里的第二个参数，说到这里，有点明白它的作用了吧，简单的来说就是在接口函数里获取当前解析类的一些相关信息，这是相当有用的。