Thinkphp源码分析系列（九）–视图view类

// +----------------------------------------------------------------------

// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]

// +----------------------------------------------------------------------

// | Copyright (c) 2006-2014 http://thinkphp.cn All rights reserved.

// +----------------------------------------------------------------------

// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )

// +----------------------------------------------------------------------

// | Author: liu21st <liu21st@gmail.com>

// +----------------------------------------------------------------------

namespace Think;

/**

 * ThinkPHP 控制器基类 抽象类

 */

abstract class Controller {

    /**

     * 视图实例对象

     * @var view

     * @access protected

     */

    protected $view     =  null;

    /**

     * 控制器参数

     * @var config

     * @access protected

     */

    protected $config   =   array();

   /**

     * 架构函数 取得模板对象实例

     * @access public

     */

    public function __construct() {

        Hook::listen('action_begin',$this->config);

        //实例化视图类

        $this->view     = Think::instance('Think\View');

        //控制器初始化

        if(method_exists($this,'_initialize'))

            $this->_initialize();

}

/**

* 加载模板和页面输出 可以返回输出内容

* @access public

* @param string $templateFile 模板文件名

* @param string $charset 模板输出字符集

* @param string $contentType 输出类型

* @param string $content 模板输出内容

* @param string $prefix 模板缓存前缀

* @return mixed

*/

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');

}

/**

* 自动定位模板文件

* @access protected

* @param string $template 模板文件规则

* @return string

*/

public function parseTemplate($template='') {

//如果$template是一个文件地址的话，那么就直接返回该地址。这是最简单的一种使用方式。

//这里的文件地址是一个相对文件路径地址，要注意模板文件位置是相对于项目的入口文件

if(is_file($template)) {

return $template;

}

//获取模板文件的分隔符，模板文件CONTROLLER_NAME与ACTION_NAME之间的分割符

$depr = C('TMPL_FILE_DEPR');

//将冒号替换成分隔符

$template = str_replace(':', $depr, $template);

// 获取当前主题名称

$theme = $this->getTemplateTheme();

/*

我们来看一下tp的模板侦测逻辑。

首先tp要求我们传入一个地址表达式。格式如下：

[模块@][控制器:][操作]  比如：  m@c:a  表示m模块下的c控制器下的a方法

我们只要给此方法传入模块，控制器和方法三个参数，这个方法就能给我们侦测出对应的模板文件地址。

具体来说，他会先定义出截止到模块这个阶段的目录，然后在得到控制器到最后的模板文件地址，最后组合起来形成最终的文件地址。

1：先定义模块的目录

首先解析地址表达式，如果有@，表示传入了模块地址，解析她，赋值给module变量。

我们的控制器文件夹和方法存放在哪里呢？

如果定义了视图目录，就存放在视图目录中，如果没有定义，就看看是否定义了模板路径，如果定义了就存放在该路径下的对应模块目录下，如果没有定义模板路径，默认就存放在应用文件夹下的对应模块文件夹下的默认视图层下。

最后我们会得到一个THEME_PATH表示控制器模板存放的目录。如果有主题的话加上主题

*/

// 获取当前模块

$module = MODULE_NAME;

if(strpos($template,'@')){ // 跨模块调用模版文件

list($module,$template) = explode('@',$template);

}

// 获取当前主题的模版路径

if(!defined('THEME_PATH')){

if(C('VIEW_PATH')){ // 模块设置独立的视图目录

$tmplPath = C('VIEW_PATH');

}else{ // 定义TMPL_PATH 改变全局的视图目录到模块之外

$tmplPath = defined('TMPL_PATH')? TMPL_PATH.$module.'/' : APP_PATH.$module.'/'.C('DEFAULT_V_LAYER').'/';

}

define('THEME_PATH', $tmplPath.$theme);

}

// 分析模板文件规则

/*

然后分析地址表达式中的模板规则，如果地址表达式为空，或者只是传了一个模块名，那么这里的template就为空，那么默认的地址就是默认控制器下的默认方法

*/

if('' == $template) {

// 如果模板文件名为空 按照默认规则定位

$template = CONTROLLER_NAME . $depr . ACTION_NAME;

}elseif(false === strpos($template, $depr)){

$template = CONTROLLER_NAME . $depr . $template;

}

//最后结合一下得到最后的模板文件地址

$file = THEME_PATH.$template.C('TMPL_TEMPLATE_SUFFIX');

if(C('TMPL_LOAD_DEFAULTTHEME') && THEME_NAME != C('DEFAULT_THEME') && !is_file($file)){

// 找不到当前主题模板的时候定位默认主题中的模板

$file = dirname(THEME_PATH).'/'.C('DEFAULT_THEME').'/'.$template.C('TMPL_TEMPLATE_SUFFIX');

}

return $file;

}