thinkphp 模板解析的流程

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类。