【thinkphp3.x】ThinkPHP/Lib/Core/Think.class.php文件分析

<?php
// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006-2012 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
// | Author: liu21st <liu21st@gmail.com>
// +----------------------------------------------------------------------

/**
 * ThinkPHP Portal类
 * @category   Think
 * @package  Think
 * @subpackage  Core
 * @author    liu21st <liu21st@gmail.com>
 */
class Think {

    private static $_instance = array();

    /**
     * 应用程序初始化
     * @access public
     * @return void
     */
    static public function start() {
        // 设定错误和异常处理
        //给当前类注册一个函数，此函数能够在脚本终止前回调注册的函数
        register_shutdown_function(array('Think','fatalError'));
        //设置用户自定义的错误处理函数
        set_error_handler(array('Think','appError'));
       	//设置用户自定义的异常处理函数
        set_exception_handler(array('Think','appException'));
        // 注册AUTOLOAD方法
        //将函数注册到SPL __autoload函数栈中
        spl_autoload_register(array('Think', 'autoload'));//自动加载autoload函数到系统中
        //[RUNTIME]
        Think::buildApp();         	// 读取配置信息，编译项目
        //[/RUNTIME]
        // 运行应用
        App::run();					//ThinkPHP/Lib/Core/App.class.php 主要作用就是调度
        return ;
    }

    //[RUNTIME]
    /**
     * 读取配置信息 编译项目
     * @access private
     * @return string
     */
    static private function buildApp() {
        // 加载底层惯例配置文件，include THINK_PATH.'Conf/convention.php'返回一个数组，	此数组会传递给C($name=null,$value=null)中的$name参数，主要用来将convention.php文件中的配置信息置入static $_config=array()静态数组变量中，以便于后续调用											//加载底层惯例配置文件
        C(include THINK_PATH.'Conf/convention.php');
        // 读取运行模式
        if(defined('MODE_NAME')) { // 模式的设置并入核心模式
            $mode   = include MODE_PATH.strtolower(MODE_NAME).'.php';
        }else{
            $mode   =  array();												//默认执行这里
        }

        // 加载模式配置文件
        if(isset($mode['config'])) {
            C( is_array($mode['config'])?$mode['config']:include $mode['config'] );
        }

        // 加载项目配置文件													//加载项目配置文件
        if(is_file(CONF_PATH.'config.php'))
            C(include CONF_PATH.'config.php');

        // 加载框架底层语言包													//加载框架底层语言包
        L(include THINK_PATH.'Lang/'.strtolower(C('DEFAULT_LANG')).'.php');
        
        // 加载模式系统行为定义
        if(C('APP_TAGS_ON')) {												//系统标签扩展的开关,默认值为true
            if(isset($mode['extends'])) {
                C('extends',is_array($mode['extends'])?$mode['extends']:include $mode['extends']);
            }else{ // 默认加载系统行为扩展定义
            	//给静态变量数组：$_config['extends']赋值
                C('extends', include THINK_PATH.'Conf/tags.php');
            }
        }

        // 加载应用行为定义
        if(isset($mode['tags'])) {
            C('tags', is_array($mode['tags'])?$mode['tags']:include $mode['tags']);
        }elseif(is_file(CONF_PATH.'tags.php')){								//项目配置目录下的tags.php文件
            // 默认加载项目配置目录的tags文件定义								//项目配置目录下的tags.php文件
            C('tags', include CONF_PATH.'tags.php');						//项目中也可以编写自己的tags.php文件
        }

        $compile   = '';													//要编译的内容变量，初始化为空
        
        // 读取核心编译文件列表
        if(isset($mode['core'])) {											//默认不执行if中代码段
            $list   =  $mode['core'];
        }else{																//$list数组中的文件内容会被编译
            $list  =  array(
                THINK_PATH.'Common/functions.php', // 标准模式函数库
                CORE_PATH.'Core/Log.class.php',    // 日志处理类
                CORE_PATH.'Core/Dispatcher.class.php', // URL调度类
                CORE_PATH.'Core/App.class.php',   // 应用程序类
                CORE_PATH.'Core/Action.class.php', // 控制器类
                CORE_PATH.'Core/View.class.php',  // 视图类
            );
        }
        // 项目追加核心编译列表文件，即：项目中也可以有自己编写的核心编译列表文件
        if(is_file(CONF_PATH.'core.php')) {									// 项目追加核心编译列表文件
            $list  =  array_merge($list,include CONF_PATH.'core.php');		// 将系统核心编译文件列表与项目核心编译列表文件合并
        }
        
        foreach ($list as $file){
            if(is_file($file))  {											//$list数组中的文件内容会被编译
                require_cache($file);										//将当前文件置入静态数组变量$_importFiles[$filename]中
                //compile()函数在common.php文件中定义
                if(!APP_DEBUG)   $compile .= compile($file);				//在调试模式未开启的情况下，循环将各个文件中的内容拼接到$compile变量后面
            }
        }

        // 加载项目公共文件，即：项目中也可以有自己编写的公共文件
        if(is_file(COMMON_PATH.'common.php')) {								//项目的公共文件common.php中的内容会被编译
            include COMMON_PATH.'common.php';
            // 在调试模式未开启的情况下，将项目中自己编写的公共文件的内容追加到$compile变量后面
            if(!APP_DEBUG)  $compile   .= compile(COMMON_PATH.'common.php');
        }

        // 加载模式别名定义
        if(isset($mode['alias'])) {
            $alias = is_array($mode['alias'])?$mode['alias']:include $mode['alias'];
            alias_import($alias);
            if(!APP_DEBUG) $compile .= 'alias_import('.var_export($alias,true).');';
        }
        // 加载项目别名定义，即：项目中也可以有自己编写的别名文件
        if(is_file(CONF_PATH.'alias.php')){ 								//项目别名文件被编译
            $alias = include CONF_PATH.'alias.php';
            alias_import($alias);
            //在调试模式未开启的情况下，会执行此行代码
            if(!APP_DEBUG) $compile .= 'alias_import('.var_export($alias,true).');';
        }

        if(APP_DEBUG) {
            // 调试模式加载系统默认的配置文件
            C(include THINK_PATH.'Conf/debug.php');
            // 读取调试模式的应用状态，默认值为'debug'
            $status  =  C('APP_STATUS');
            // 加载对应的项目配置文件
            if(is_file(CONF_PATH.$status.'.php'))
                // 允许项目增加开发模式配置定义
                C(include CONF_PATH.$status.'.php');
        }else{
        	//在调试模式开启的情况下，不会执行此函数
            //部署模式下面生成编译文件，在runtime.php文件中定义
            build_runtime_cache($compile);									//这行代码最为关键，将要编译的内容编译到~runtime.php文件中
        }
        return ;
    }
    //[/RUNTIME]

    /**
     * 系统自动加载ThinkPHP类库，行为类、模型类、控制器类 都是在autoload函数中被自动加载
     * 并且支持配置自动加载路径
     * @param string $class 对象类名
     * @return void
     */
    public static function autoload($class) {
        // 检查是否存在别名定义
        if(alias_import($class)) return ;

        if(substr($class,-8)=='Behavior') { // 加载行为
            if(require_cache(CORE_PATH.'Behavior/'.$class.'.class.php') 
                || require_cache(EXTEND_PATH.'Behavior/'.$class.'.class.php') 
                || require_cache(LIB_PATH.'Behavior/'.$class.'.class.php')
                || (defined('MODE_NAME') && require_cache(MODE_PATH.ucwords(MODE_NAME).'/Behavior/'.$class.'.class.php'))) {
                return ;
            }
        }elseif(substr($class,-5)=='Model'){ // 加载模型
            if((defined('GROUP_NAME') && require_cache(LIB_PATH.'Model/'.GROUP_NAME.'/'.$class.'.class.php'))
                || require_cache(LIB_PATH.'Model/'.$class.'.class.php')
                || require_cache(EXTEND_PATH.'Model/'.$class.'.class.php') ) {
                return ;
            }
        }elseif(substr($class,-6)=='Action'){ // 加载控制器
            if((defined('GROUP_NAME') && require_cache(LIB_PATH.'Action/'.GROUP_NAME.'/'.$class.'.class.php'))
                || require_cache(LIB_PATH.'Action/'.$class.'.class.php')
                || require_cache(EXTEND_PATH.'Action/'.$class.'.class.php') ) {
                return ;
            }
        }

        // 根据自动加载路径设置进行尝试搜索
        $paths  =   explode(',',C('APP_AUTOLOAD_PATH'));
        foreach ($paths as $path){
            if(import($path.'.'.$class))
                // 如果加载类成功则返回
                return ;
        }
    }

    /**
     * 取得对象实例 支持调用类的静态方法
     * @param string $class 对象类名
     * @param string $method 类的静态方法名
     * @return object
     */
    static public function instance($class,$method='') {
        $identify   =   $class.$method;//标识
        if(!isset(self::$_instance[$identify])) {
            if(class_exists($class)){//如果类存在
                $o = new $class();//创建一个类的实例
                if(!empty($method) && method_exists($o,$method))//类中是否存在某个方法
                	//call_user_func_array(array(&$o, $method))：调用 $o类的$method方法
                    self::$_instance[$identify] = call_user_func_array(array(&$o, $method));
                else
                    self::$_instance[$identify] = $o; 
            }
            else
                halt(L('_CLASS_NOT_EXIST_').':'.$class);
        }
        return self::$_instance[$identify];
    }

    /**
     * 自定义异常处理
     * @access public
     * @param mixed $e 异常对象
     */
    static public function appException($e) {
        halt($e->__toString());
    }

    /**
     * 自定义错误处理
     * @access public
     * @param int $errno 错误类型
     * @param string $errstr 错误信息
     * @param string $errfile 错误文件
     * @param int $errline 错误行数
     * @return void
     */
    static public function appError($errno, $errstr, $errfile, $errline) {
      switch ($errno) {
          case E_ERROR:
          case E_PARSE:
          case E_CORE_ERROR:
          case E_COMPILE_ERROR:
          case E_USER_ERROR:
            ob_end_clean();
            if(!ini_get('zlib.output_compression') && C('OUTPUT_ENCODE')) ob_start('ob_gzhandler');
            $errorStr = "$errstr ".$errfile." 第 $errline 行.";
            if(C('LOG_RECORD')) Log::write("[$errno] ".$errorStr,Log::ERR);
            function_exists('halt')?halt($errorStr):exit('ERROR:'.$errorStr);
            break;
          case E_STRICT:
          case E_USER_WARNING:
          case E_USER_NOTICE:
          default:
            $errorStr = "[$errno] $errstr ".$errfile." 第 $errline 行.";
            trace($errorStr,'','NOTIC');
            break;
      }
    }
    
    // 致命错误捕获
    static public function fatalError() {
        if ($e = error_get_last()) {
            Think::appError($e['type'],$e['message'],$e['file'],$e['line']);
        }
    }

}