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