首页 > 代码库 > dedecms代码研究五
dedecms代码研究五
上一次留几个疑问:1)DedeTagParse类LoadTemplet方法。2)MakeOneTag到底在搞什么。
从DedeTagParse开始
前面,我们一直在dedecms的外围,被各种全局变量和各种调用所迷惑,我们抓住了一个关键的线索DedeTagParse类,研究明白它,就可以弄清楚很多东西了。
看看这个NB的DedeTagParse类吧。
嗯,先看构造函数,没什么特别的,就是设置了一堆初始化参数。
接下来就找LoadTemplet方法吧。
找到后,我们发现LoadTemplet方法其实是指向LoadTemplate方法的,无语啊,难道作者英文就差到此等地步?
看看那个LoadTemplate方法吧。
function LoadTemplate($filename) { $this->SetDefault(); if(!file_exists($filename)) { $this->SourceString = " $filename Not Found! "; $this->ParseTemplet(); } else { $fp = @fopen($filename, "r"); while($line = fgets($fp,1024)) { $this->SourceString .= $line; } fclose($fp); if($this->LoadCache($filename)) { return ‘‘; } else { $this->ParseTemplet(); } } }
里面先用SetDefault方法设置了几个初始变量:
$this->SourceString = ‘‘;
$this->CTags = ‘‘;
$this->Count=-1;
然后判断模板文件是否存在。然后针对不同情况对$this->SourceString赋值,并调用$this->ParseTemplet();方法。
这块的代码看出来,作者开发功力有待改进啊,都5.6了,代码重构还如此糟糕,唉~为什么不能把$this->ParseTemplet();这句放在if外面呢?
文件不存在时候,很简单,就是把“文件不存在”这句话放到$this->SourceString中,然后调用$this->ParseTemplet();。
文件存在的时候,也很简单,fgets读取文件内容(麻烦,为啥不用file_get_contents呢),然后,又是一个if,通过$this->LoadCache($filename)返回值判断是否有缓存,如果返回true说明读取到缓存的模板了,就返回空字符串(怎么可以这样呢?返回值也太不负责了吧),如果返回false就调用$this->ParseTemplet();重新解析模板。
LoadTemplate大致就是这些,无非是读取模板文件内容,然后看是否有缓存,有就不解析模板,没有就解析模板,仅此而已。
我们接下来看看$this->LoadCache方法吧,找到方法定义的部分,呀喝,代码还不少。
先是通过$this->IsCache判断是否允许缓存(这个属性是在DedeTagParse类实例化的时候设定的,跟dedecms的系统配置中是否加模板缓存的参数$cfg_tplcache有关,这个在DedeTagParse类的构造函数中有所体现,由于安装dedecms后,默认系统配置为true,所以这里默认就为true啦),如果为false的话,$this->LoadCache就返回false而不继续向下走了,在LoadTemplate方法中就会根据这个返回值来决定解析模板。
过了$this->IsCache这关,程序继续。下面就是找当前模板文件对应的缓存了。
dedecms的文件缓存有点特别,我们找到模板缓存目录(data/tplcache),观察一下就会发现,很多名字有点相同的文件,仔细看看还能找出点规律来。我们从代码来印证一下吧。
上面说到LoadCache方法中,我们过了$this->IsCache这关,后面就是找模板文件了,我们看看后面的代码:
$cdir = dirname($filename);$cachedir = DEDEROOT.$cfg_tplcache_dir;$ckfile = str_replace($cdir,‘‘,$filename).substr(md5($filename),0,16).‘.inc‘;$ckfullfile = $cachedir.‘/‘.$ckfile;$ckfullfile_t = $cachedir.‘/‘.$ckfile.‘.txt‘;
前3句是拼缓存文件名字的,方法是取不带目录的模板文件名然后md5进行hash,然后把hash出来的字符串取前16个字符,后面加上“inc”后缀就成了。
第4句是取得完整的缓存文件名。
第5距好像是另一个文件名字,就是在缓存文件名字后面再加个后缀“.txt”
上面就得到了两个文件名字,但是我们不知道第二个文件名字干什么用的,再继续往下看咯啊的代码吧。
$this->CacheFile = $ckfullfile;$this->TempMkTime = filemtime($filename);if(!file_exists($ckfullfile)||!file_exists($ckfullfile_t)){ return false;}
第1句就指定了当前模板的缓存文件
第2句读取了文件的最后修改时间,设置了一个什么时间的属性,现在还不大明白。
接下来的if语句就是如果找不到模板的两个缓存文件(就是上面组合出来的两个文件),就返回false让LoadTemplate方法解析模板去。
我们假设模板的缓存文件都有,继续看代码。下面代码段写了注释,就是检测模板最后更新时间,代码很简单,就是打开我们前面说的那个$ckfullfile_t变量指定的txt文件,读内容,然后把内容和缓存修改时间比较,原来.txt文件是用来保存缓存文件的保存时间的。如果时间不一致则就返回false让LoadTemplate方法解析模板去。
我们假定缓存有效,那么就可以继续了。
缓存有效就会把缓存文件包含进来。
这块就要根据缓存文件来具体分析了,所以,我们这里假定载入的是index.htm模板吧,在tplcache里面找到index.htm开头,后缀为inc的文件,打开。
我们这里节选一部分:
$z[0]=Array("global","",236,264);
$z[0][4][‘name‘]="cfg_soft_lang";
$z[1]=Array("global","",277,303);
$z[1][4][‘name‘]="cfg_webname";
$z[2]=Array("global","",347,377);
$z[2][4][‘name‘]="cfg_description";
$z[3]=Array("global","",414,441);
$z[3][4][‘name‘]="cfg_keywords";
……
再回到我们的LoadCache方法里面。
前面说到include了模板缓存文件,然后,下面的if语句判断的是缓存文件里面的信息数组“$z”是否正常,如果正常就进行来个foreach循环,这个foreach很重要。我们来看看代码。
//把缓冲数组内容读入类 if( isset($z) && is_array($z) ) { foreach($z as $k=>$v) { $this->Count++; $ctag = new DedeTAg(); $ctag->CAttribute = new DedeAttribute(); $ctag->IsReplace = FALSE; $ctag->TagName = $v[0]; $ctag->InnerText = $v[1]; $ctag->StartPos = $v[2]; $ctag->EndPos = $v[3]; $ctag->TagValue = http://www.mamicode.com/‘‘; $ctag->TagID = $k; if(isset($v[4]) && is_array($v[4])) { $i = 0; foreach($v[4] as $k=>$v) { $ctag->CAttribute->Count++; $ctag->CAttribute->Items[$k]=$v; } } $this->CTags[$this->Count] = $ctag; } }
这是个遍历缓存信息数组,然后每个$z数组的元素,都生成一个DedeTAg对象,并把$z数组元素的一些信息赋给DedeTAg对象,我们经过看这段源代码,发现,$z数组元素中,0是标签名称(TagName),1是内部文本(InnerText),2是开始位置(StartPos),3是结束位置(EndPos)。新的DedeTag对象的tagID就是数组下标。
这里面还有个循环,是循环$z数组每个元素的第四个子元素。然后,然后把相关值赋到当前DedeTAg对象的DedeAttribute对象中。
看到这里,我们似乎明白点东西了。
1)tplcache里面存的并不是解析好的模板,而是一堆信息数组。(其实后面会分析到的模板解析方法DedeTagParse类中的ParseTemplet也只是把模板标签信息记录下来)
2)信息数组里保存的都是一个模板页里面包含的所有标签的信息。
3)上面的循环其实是把缓存里面的标签信息读取并写入DedeTAg对象,然后保存到当前DedeParse类的CTags数组中,到目前DedeParse的实例得到了模板内容(在$this->SourceString中),模板上所有标签信息(在 $this->CTags中)。
好了,经过上面的一番操作,LoadCache方法就这些了,缓存读取完成,这样就可以安心回到LoadTemplate方法里面去继续分析了。
dedecms代码研究五