ThinkPHP控制器中在每一个方法的最后都有这样的一句话 ,你确定对这句话非常了解吗?
$this->display();当然你会说这句话是用来解析或显示控制器的方法所对应的模板的。有了这句,模板里的内容才可以正常显示,没有这句话就会抛出错误:模板不存在。但是这句话是怎样实现模板解析的呢?经过我两天的研究分析,对模板的解析过程有一个大致的认识过程,分享给大家。
首先控制器方法里的这句,是调用display方法,由于当前控制器类不含有该方法,并且所有的控制器都是继承基础控制器的,即Controller.class.php,因此其实调用的基础控制器里的方法,于是在基础控制器里。我找到了这样一段代码:
Think::instance 是用来实例化指定的类的,可以去查看具体代码。
通过这段代码发现,调用的display方法其实是View.class.php 里面的方法。于是我又去查看视图类
protected $tVar = array(); /** * 模板主题 * @var theme * @access protected */ protected $theme = ''; /** * 模板变量赋值 * @access public * @param mixed $name * @param mixed $value */ public function assign($name,$value=''){ if(is_array($name)) { $this->tVar = array_merge($this->tVar,$name); }else { $this->tVar[$name] = $value; } }从assign方法可以知道,模板变量赋值其实就是将所有的模板变量放到全局数组变量$this->tVar中。
public function display($templateFile='',$charset='',$contentType='',$content='',$prefix='') { G('viewStartTime'); // 视图开始标签 Hook::listen('view_begin',$templateFile); // 解析并获取模板内容 $content = $this->fetch($templateFile,$content,$prefix); // 输出模板内容 $this->render($content,$charset,$contentType); // 视图结束标签 Hook::listen('view_end'); }可以看到display 方法又调用了fetch 方法
public function fetch($templateFile='',$content='',$prefix='') { if(empty($content)) { //parseTemplate 自动定位模板文件 函数返回模板文件 $templateFile = $this->parseTemplate($templateFile); // 模板文件不存在直接返回 if(!is_file($templateFile)) E(L('_TEMPLATE_NOT_EXIST_').':'.$templateFile); }else{ defined('THEME_PATH') or define('THEME_PATH', $this->getThemePath()); } // 页面缓存 ob_start(); ob_implicit_flush(0); if('php' == strtolower(C('TMPL_ENGINE_TYPE'))) { // 使用PHP原生模板 $_content = $content; // 模板阵列变量分解成为独立变量 extract($this->tVar, EXTR_OVERWRITE); // 直接载入PHP模板 empty($_content)?include $templateFile:eval('?>'.$_content); }else{ // 视图解析标签 $params = array('var'=>$this->tVar,'file'=>$templateFile,'content'=>$content,'prefix'=>$prefix); Hook::listen('view_parse',$params); } // 获取并清空缓存 $content = ob_get_clean(); // 内容过滤标签 Hook::listen('view_filter',$content); // 输出模板文件 return $content; }其中TMPL_ENGINE_TYPE 是可以在配置文件中进行修改的,默认的为“Think”,从代码可以知道,当TMPL_ENGINE_TYPE 配置为“php”时,会采用PHP原生模板,否则解析view_parse 标签(Hook::listen是用来解析行为扩展标签的)
'view_parse' => array( 'Behavior\ParseTemplateBehavior', // 模板解析 支持PHP、内置模板引擎和第三方模板引擎 ),从配置文件中知道,执行了ParseTemplateBehavior这个类。因为所有行为扩展的入口都是run方法,所以只需要看run方法实现即可。
public function run(&$_data){ $engine = strtolower(C('TMPL_ENGINE_TYPE')); $_content = empty($_data['content'])?$_data['file']:$_data['content']; $_data['prefix'] = !empty($_data['prefix'])?$_data['prefix']:C('TMPL_CACHE_PREFIX'); if('think'==$engine){ // 采用Think模板引擎 if((!empty($_data['content']) && $this->checkContentCache($_data['content'],$_data['prefix'])) || $this->checkCache($_data['file'],$_data['prefix'])) { // 缓存有效 //载入模版缓存文件 Storage::load(C('CACHE_PATH').$_data['prefix'].md5($_content).C('TMPL_CACHFILE_SUFFIX'),$_data['var']); }else{ $tpl = Think::instance('Think\\Template'); // 编译并加载模板文件 $tpl->fetch($_content,$_data['var'],$_data['prefix']); } }else{ // 调用第三方模板引擎解析和输出 if(strpos($engine,'\\')){ $class = $engine; }else{ $class = 'Think\\Template\\Driver\\'.ucwords($engine); } if(class_exists($class)) { $tpl = new $class; $tpl->fetch($_content,$_data['var']); }else { // 类没有定义 E(L('_NOT_SUPPORT_').': ' . $class); } } }
从代码中知道第一次解析模板时(即模板文件没有缓存),
$tpl = Think::instance('Think\\Template'); // 编译并加载模板文件 $tpl->fetch($_content,$_data['var'],$_data['prefix']);
这两句代码进行了模板的解析工作,于是我又去看Template类。