【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']);
}
}

}