ThinkPHP(3.1.2)源码分析

这周活比较轻松，正好过一遍thinkphp源码(3.1.2版)，弄清楚该框架内部实现的流程，增长些知识。

第一步，见博客在Windows上和Linux上安装xdebug。

第二步，打开netbeans，在工具-选项-php-调试框内，把调试器端口写成和php.ini内xdebug.remote_port一致，点击应用-确定。

第三步，新建项目，也就是把thinkphp创建的项目导入进去，进入项目内，点击调试项目，之后会弹出一个会话框，在项目URL和索引文件填入正确的信息，之后便可以调试了。

第四步，开始调试。进入项目的一个具体页面，点击调试文件或是调试项目，之后调试便开始了，按F7键进行调试。下面，我便把调试后的的心得写下来。

1） 由于thinkphp是单入口的文件，因此调试界面首先便跳到index.php中，该页面主要负责定义项目名称、项目路径、thinkphp所在路径、是否开启调试模式，之后便引入ThinkPHP.php。

2）在ThinkPHP.php页面里，主要是定义了项目开始运行时间、开始时的内存使用情况、重新检测了是否定义项目路径、缓存目录路径、项目是否开始调试模式、~runtime.php存放地址，若是项目开启调试，则进入THINK_PATH.'Common/runtime.php'，没有开启则直接进入已编译好的~runtime.php.，这里属于调试模式，即APP_DEBUG为TRUE。

3）runtime.php文件主要负责检测是否定义thinkphp路径，没有的话就退出，这应该是阻止恶意链接吧，定义版本信息，检测php的版本，定义系统常量、URL的4种模式、目录常量（tp系统的和项目的），加载运行所需文件，记录加载文件文件时间，执行Think::Start()。这里着重解释下load_runtime_file()函数。

// 加载运行时所需要的文件 并负责自动目录生成function load_runtime_file() {    // 加载系统基础函数库    // require_cache函数所在文件，要先引入，才能正确执行    require THINK_PATH.'Common/common.php';    // 读取核心文件列表    // 因为接下来便是进入Think.class.php文件，因此要引入该文件    // 同时由于在执行过程中可能会遇到错误或是异常，便引入ThinkException.class.php异常处理类    // 在App::run()方法内会执行tag函数，会用Behavior.class.php类，于是也被一同引入    $list = array(        CORE_PATH.'Core/Think.class.php',        CORE_PATH.'Core/ThinkException.class.php',  // 异常处理类        CORE_PATH.'Core/Behavior.class.php',    );    // 加载模式文件列表    foreach ($list as $key=>$file){        // require_cache 可以看成是一个优化的require方法        // 实际上是引入了static静态变量，避免文件重复引入        // 在thinkphp中static的思维贯穿其中        if(is_file($file))  require_cache($file);    }    // 加载系统类库别名定义    //alias_import(include THINK_PATH.'Conf/alias.php');    // 检查项目目录结构 如果不存在则自动创建    if(!is_dir(LIB_PATH)) {        // 创建项目目录结构        build_app_dir();    }elseif(!is_dir(CACHE_PATH)){        // 检查缓存目录        check_runtime();    }elseif(APP_DEBUG){        // 调试模式切换删除编译缓存        if(is_file(RUNTIME_FILE))   unlink(RUNTIME_FILE);    }}

4）进入Thinkphp，执行静态方法Start()，该方法重新定义了异常、错误、自动加载机制，执行Think::buildApp()方法

a）Think::buildApp()方法主要实现了thinkphp官方手册中的“惯例配置->项目配置->调试配置->分组配置->扩展配置->动态配置”说明。

// 加载底层惯例配置文件C(include THINK_PATH.'Conf/convention.php');C(include THINK_PATH.'Conf/config.php');// 加载项目配置文件C(include CONF_PATH.'config.php');// 加载框架底层语言包L(include THINK_PATH.'Lang/'.strtolower(C('DEFAULT_LANG')).'.php');// 默认加载系统行为扩展定义C('extends', include THINK_PATH.'Conf/tags.php');// 默认加载项目配置目录的tags文件定义C('tags', include CONF_PATH.'tags.php');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',  // 视图类// 加载项目公共文件include COMMON_PATH.'common.php';// 加载系统别名文件，这里主要在tag函数中利用到include THINK_PATH.'Conf/alias.php';// 加载项目别名文件，如果有的话，若是项目中配置了，可以在项目中的Behavior目录里写相关的行为代码include CONF_PATH.'alias.php';// 调试模式加载系统默认的配置文件C(include THINK_PATH.'Conf/debug.php');// 加载对应的项目配置文件 C( include CONF_PATH . C('APP_STATUS') . '.php');

5）上述方法执行完后，进入App.class.php中执行App::run()方法。

a）tag('app_init')，项目初始化标签，在tag.php文件中可以看到，app_init对应的值为空，因此这个标签是什么也没执行。之后在第九条详细解释tag方法。

6）执行App::init()方法，该方法首先设置时区，默认为PRC，可以通过在项目中配置DEFAULT_TIMEZONE的值来修改，之后加载动态项目公共文件和配置

a）load_ext_file()方法主要是加载动态扩展文件

/** * 加载动态扩展文件 * @return void */function load_ext_file() {    // 通过在项目里配置LOAD_EXT_FILE、LOAD_EXT_CONFIG来动态加载文件    // 加载自定义外部文件    // LOAD_EXT_FILE => 'guest,user';    // 那么便会加载项目公共目录（Common）内的guest.php和user.php文件    if (C('LOAD_EXT_FILE')) {        $files = explode(',', C('LOAD_EXT_FILE'));        foreach ($files as $file) {            $file = COMMON_PATH . $file . '.php';            if (is_file($file))                include $file;        }    }    // 加载自定义的动态配置文件    // LOAD_EXT_CONFIG => 'guest,user';    // 那么便会加载项目配置（Conf）目录内的guest.php和user.php文件    if (C('LOAD_EXT_CONFIG')) {        $configs = C('LOAD_EXT_CONFIG');        if (is_string($configs))            $configs = explode(',', $configs);        foreach ($configs as $key => $config) {            $file = CONF_PATH . $config . '.php';            if (is_file($file)) {                is_numeric($key) ? C(include $file) : C($key, include $file);            }        }    }    // 加载不同的操作系统下的配置    // 以便在不同操作系统执行工具的不同平台的版本    if (C('OS_CONFIG')) {        if (preg_match('/WIN/', PHP_OS)) {            $file = CONF_PATH . 'win.php';        } else {            $file = CONF_PATH . 'linux.php';        }        if (is_file($file))            C(include $file);    }}

7）进入Dispatcher.class.php执行Dispatcher::dispatch()方法。

/** * URL映射到控制器 * @access public * @return void */static public function dispatch() {    // 项目的URL_MODEL为2，也就是define('URL_REWRITE',     2)即REWRITE模式    $urlMode  =  C('URL_MODEL');    // 判断URL里面是否有兼容模式参数    // VAR_PATHINFO的值为s    // 这时$_GET没有接收到参数，而且即使有，参数中也没有s的    if(!empty($_GET[C('VAR_PATHINFO')])) {        $_SERVER['PATH_INFO']   = $_GET[C('VAR_PATHINFO')];        unset($_GET[C('VAR_PATHINFO')]);    }    // 条件不符    if($urlMode == URL_COMPAT ){        // 兼容模式判断        define('PHP_FILE',_PHP_FILE_.'?'.C('VAR_PATHINFO').'=');    // URL_REWRITE在runtime中的定义为2    // 条件符合，定义PHP_FILE常量    }elseif($urlMode == URL_REWRITE ) {        // 当前项目地址        $url    =   dirname(_PHP_FILE_);        if($url == '/' || $url == '\\')            $url    =   '';        define('PHP_FILE',$url);    // 条件不符    }else {        //当前项目地址        define('PHP_FILE',_PHP_FILE_);    }    // 项目没有开启子域名    // 开启子域名部署    if(C('APP_SUB_DOMAIN_DEPLOY')) {        $rules      = C('APP_SUB_DOMAIN_RULES');        $subDomain  = strtolower(substr($_SERVER['HTTP_HOST'],0,strpos($_SERVER['HTTP_HOST'],'.')));        define('SUB_DOMAIN',$subDomain); // 二级域名定义        if($subDomain && isset($rules[$subDomain])) {            $rule =  $rules[$subDomain];        }elseif(isset($rules['*'])){ // 泛域名支持            if('www' != $subDomain && !in_array($subDomain,C('APP_SUB_DOMAIN_DENY'))) {                $rule =  $rules['*'];            }        }        if(!empty($rule)) {            // 子域名部署规则 '子域名'=>array('分组名/[模块名]','var1=a&var2=b');            $array  =   explode('/',$rule[0]);            $module =   array_pop($array);            if(!empty($module)) {                $_GET[C('VAR_MODULE')]  =   $module;                $domainModule           =   true;            }            if(!empty($array)) {                $_GET[C('VAR_GROUP')]   =   array_pop($array);                $domainGroup            =   true;            }            if(isset($rule[1])) { // 传入参数                parse_str($rule[1],$parms);                $_GET   =  array_merge($_GET,$parms);            }        }    }    // 该变量的值不为空，因此条件不成立    // 分析PATHINFO信息    if(empty($_SERVER['PATH_INFO'])) {        $types   =  explode(',',C('URL_PATHINFO_FETCH'));        foreach ($types as $type){            if(0===strpos($type,':')) {// 支持函数判断                $_SERVER['PATH_INFO'] =   call_user_func(substr($type,1));                break;            }elseif(!empty($_SERVER[$type])) {                $_SERVER['PATH_INFO'] = (0 === strpos($_SERVER[$type],$_SERVER['SCRIPT_NAME']))?                    substr($_SERVER[$type], strlen($_SERVER['SCRIPT_NAME']))   :  $_SERVER[$type];                break;            }        }    }    // 分割符为/    $depr = C('URL_PATHINFO_DEPR');    if(!empty($_SERVER['PATH_INFO'])) {        // 在tags.php中path_info的值为空，因此这里不执行操作        tag('path_info');        // 拆分PATH_INFO，具体的可以参照手册中pathinfo函数        $part =  pathinfo($_SERVER['PATH_INFO']);        // 定义__EXT__常量        define('__EXT__', isset($part['extension'])?strtolower($part['extension']):'');        if(C('URL_HTML_SUFFIX')) {            $_SERVER['PATH_INFO'] = preg_replace('/\.('.trim(C('URL_HTML_SUFFIX'),'.').')$/i', '', $_SERVER['PATH_INFO']);        }elseif(__EXT__) {            $_SERVER['PATH_INFO'] = preg_replace('/.'.__EXT__.'$/i','',$_SERVER['PATH_INFO']);        }        // 由于项目中没有采用路由规则，因此条件成立        // 检测路由规则 如果没有则按默认规则调度URL        if(!self::routerCheck()){            // 拆分$_SERVER['PATH_INFO']为数组            $paths = explode($depr,trim($_SERVER['PATH_INFO'],'/'));            // VAR_URL_PARAMS值为_URL_            if(C('VAR_URL_PARAMS')) {                // 把$_SERVER['PATH_INFO']的按/分割成数组，并赋值给$_GET的_URL_变量                $_GET[C('VAR_URL_PARAMS')]   =  $paths;            }            $var  =  array();            // APP_GROUP_LIST为项目中设置的组            // VAR_GROUP置为g，由于$_GET没有接收此参数，因此条件成立            if (C('APP_GROUP_LIST') && !isset($_GET[C('VAR_GROUP')])){                $var[C('VAR_GROUP')] = in_array(strtolower($paths[0]),explode(',',strtolower(C('APP_GROUP_LIST'))))? array_shift($paths) : '';                if(C('APP_GROUP_DENY') && in_array(strtolower($var[C('VAR_GROUP')]),explode(',',strtolower(C('APP_GROUP_DENY'))))) {                    // 禁止直接访问分组                    exit;                }            }            // 还没有定义模块名称            if(!isset($_GET[C('VAR_MODULE')])) {                $var[C('VAR_MODULE')]  =   array_shift($paths);            }            $var[C('VAR_ACTION')]  =   array_shift($paths);            // 解析剩余的URL参数            preg_replace('@(\w+)\/([^\/]+)@e', '$var[\'\\1\']=strip_tags(\'\\2\');', implode('/',$paths));            // 把$var和$_GET合并形成新的$_GET数组，这时URL映射基本完整            $_GET   =  array_merge($var,$_GET);        }        define('__INFO__',$_SERVER['PATH_INFO']);    }    // URL常量    define('__SELF__',strip_tags($_SERVER['REQUEST_URI']));    // 当前项目地址    define('__APP__',strip_tags(PHP_FILE));    // 获取分组 模块和操作名称    if (C('APP_GROUP_LIST')) {        // 默认分组为Home，这里主要依据当前访问的文件的位置        // 如果文件为Home分组下就是Home        define('GROUP_NAME', self::getGroup(C('VAR_GROUP')));        // 分组URL地址        define('__GROUP__',(!empty($domainGroup) || strtolower(GROUP_NAME) == strtolower(C('DEFAULT_GROUP')) )?__APP__ : __APP__.'/'.GROUP_NAME);    }    // 定义项目基础加载路径    define('BASE_LIB_PATH', (defined('GROUP_NAME') && C('APP_GROUP_MODE')==1) ? APP_PATH.C('APP_GROUP_PATH').'/'.GROUP_NAME.'/' : LIB_PATH);    if(defined('GROUP_NAME')) {        if(1 == C('APP_GROUP_MODE')){ // 独立分组模式            $config_path    =   BASE_LIB_PATH.'Conf/';            $common_path    =   BASE_LIB_PATH.'Common/';        }else{ // 普通分组模式            $config_path    =   CONF_PATH.GROUP_NAME.'/';            $common_path    =   COMMON_PATH.GROUP_NAME.'/';        }        // 加载分组配置文件        if(is_file($config_path.'config.php'))            C(include $config_path.'config.php');        // 加载分组函数文件        if(is_file($common_path.'function.php'))            include $common_path.'function.php';    }    // 定义模块名和方法名常量    define('MODULE_NAME',self::getModule(C('VAR_MODULE')));    define('ACTION_NAME',self::getAction(C('VAR_ACTION')));    // 当前模块和分组地址    $moduleName    =   defined('MODULE_ALIAS')?MODULE_ALIAS:MODULE_NAME;    if(defined('GROUP_NAME')) {        define('__URL__',!empty($domainModule)?__GROUP__.$depr : __GROUP__.$depr.$moduleName);    }else{        define('__URL__',!empty($domainModule)?__APP__.'/' : __APP__.'/'.$moduleName);    }    $tmpAppUrl = explode('/', __URL__);    //define('__APPURL__', '/' . $tmpAppUrl[1] . '/' . $tmpAppUrl[2]);    define('__APPURL__', './');    // 当前操作地址    define('__ACTION__',__URL__.$depr.(defined('ACTION_ALIAS')?ACTION_ALIAS:ACTION_NAME));    //保证$_REQUEST正常取值    $_REQUEST = array_merge($_POST,$_GET);}

8）回到App::init()方法，定义当前请求的系统常量、URL调度结束、页面压缩输出支持、系统变量安全过滤（过滤$_GET、$_POST）、设置模板相关信息、动态配置异常界面（若是觉得tp异常界面不友好的话，可以重新设计下界面，并在放在项目目录内，在配置文件内通过TMPL_EXCEPTION_FILE来设定）

9）回到App::run()方法，执行tag('app_begin')方法，这里详细介绍下tag方法执行机制

/** * 处理标签扩展 * @param string $tag 标签名称 * @param mixed $params 传入参数 * @return mixed */function tag($tag, &$params=NULL) {    // 这里$tag的值为app_begin    // 因为在Think.class.php文件中的静态方法buildapp()中已经将tags.php中    // 关于行为的值赋值给extends键，通过查看文件可知这里的app_begin是有值的    // 值为ReadHtmlCache    // 系统标签扩展    $extends    = C('extends.' . $tag);    // 应用标签扩展    $tags       = C('tags.' . $tag);    // $tags这里没有值,条件不成立    if (!empty($tags)) {        // 合并扩展        if(empty($tags['_overlay']) && !empty($extends)) {            $tags = array_unique(array_merge($extends,$tags));        // 通过设置 '_overlay'=>1 覆盖系统标签        } elseif (isset($tags['_overlay'])){            unset($tags['_overlay']);        }    // 把extends的值赋给$tags    } elseif (!empty($extends)) {        $tags = $extends;    }    if($tags) {        if(APP_DEBUG) {            G($tag.'Start');            trace('[ '.$tag.' ] --START--','','INFO');        }        // 执行扩展        foreach ($tags as $key=>$name) {            // 指定行为类的完整路径 用于模式扩展            if(!is_int($key)) {                $name   = $key;            }            // 执行B方法            B($name, $params);        }        // 记录行为的执行日志        if(APP_DEBUG) {            trace('[ '.$tag.' ] --END-- [ RunTime:'.G($tag.'Start',$tag.'End',6).'s ]','','INFO');        }    // 未执行任何行为 返回false    } else {        return false;    }}/** * 执行某个行为 * @param string $name 行为名称 * @param Mixed $params 传人的参数 * @return void */function B($name, &$params=NULL) {    // 把ReadHtmlCache的值传过来，并重新组合为ReadHtmlCacheBehavior    $class      = $name.'Behavior';    if(APP_DEBUG) {        G('behaviorStart');    }    // 执行ReadHtmlCacheBehavior类，这里就用到了前面的thinkphp自定义的autoload方法    // 因为ReadHtmlCacheBehavior.class.php没有加载进来，因此在new之前要加载进来    // 加载后执行实例化操作，由于ReadHtmlCacheBehavior都是继承Behavior类，因此在实例化时    // 也自动执行了析构函数__construct，该函数类似C方法    $behavior   = new $class();    // 执行ReadHtmlCacheBehavior类的run方法，因为没有设定HTML_CACHE_RULES，因此下面是不执行操作的    $behavior->run($params);    if(APP_DEBUG) { // 记录行为的执行日志        G('behaviorEnd');        trace('Run '.$name.' Behavior [ RunTime:'.G('behaviorStart','behaviorEnd',6).'s ]','','INFO');    }}/** * 系统自动加载ThinkPHP类库 * 并且支持配置自动加载路径 * @param string $class 对象类名 * @return void */public static function autoload($class) {    // 检查是否存在别名定义    if(alias_import($class)) return ;    $libPath    =   defined('BASE_LIB_PATH')?BASE_LIB_PATH:LIB_PATH;    $group      =   defined('GROUP_NAME') && C('APP_GROUP_MODE')==0 ?GROUP_NAME.'/':'';    // 这里的$file变成了ReadHtmlCacheBehavior.class.php    $file       =   $class.'.class.php';    // 加载行为，此条件成立，这里加载多个行为，系统核心的、系统扩展的、项目自身的（后面两个时一样的）    // 加载完后变返回    if(substr($class,-8)=='Behavior') {        if(require_array(array(            CORE_PATH.'Behavior/'.$file,            EXTEND_PATH.'Behavior/'.$file,            LIB_PATH.'Behavior/'.$file,            $libPath.'Behavior/'.$file),true)            || (defined('MODE_NAME') && require_cache(MODE_PATH.ucwords(MODE_NAME).'/Behavior/'.$file))) {            return ;        }    }elseif(substr($class,-5)=='Model'){ // 加载模型        if(require_array(array(            LIB_PATH.'Model/'.$group.$file,            $libPath.'Model/'.$file,            EXTEND_PATH.'Model/'.$file),true)) {            return ;        }    }elseif(substr($class,-6)=='Action'){ // 加载控制器        if(require_array(array(            LIB_PATH.'Action/'.$group.$file,            $libPath.'Action/'.$file,            EXTEND_PATH.'Action/'.$file),true)) {            return ;        }    }elseif(substr($class,0,5)=='Cache'){ // 加载缓存驱动        if(require_array(array(            EXTEND_PATH.'Driver/Cache/'.$file,            CORE_PATH.'Driver/Cache/'.$file),true)){            return ;        }    }elseif(substr($class,0,2)=='Db'){ // 加载数据库驱动        if(require_array(array(            EXTEND_PATH.'Driver/Db/'.$file,            CORE_PATH.'Driver/Db/'.$file),true)){            return ;        }    }elseif(substr($class,0,8)=='Template'){ // 加载模板引擎驱动        if(require_array(array(            EXTEND_PATH.'Driver/Template/'.$file,            CORE_PATH.'Driver/Template/'.$file),true)){            return ;        }    }elseif(substr($class,0,6)=='TagLib'){ // 加载标签库驱动        if(require_array(array(            EXTEND_PATH.'Driver/TagLib/'.$file,            CORE_PATH.'Driver/TagLib/'.$file),true)) {            return ;        }    }    // 根据自动加载路径设置进行尝试搜索    $paths  =   explode(',',C('APP_AUTOLOAD_PATH'));    foreach ($paths as $path){        if(import($path.'.'.$class))            // 如果加载类成功则返回            return ;    }}

接着执行Session初始化操作，记录应用初始化时间

10）前面的准备工作都做完后，接下来便进入执行应用程序App::exec()方法了，到这一步时，基本就是水到渠成的了，利用前面获取的模块和方法通过检测方法是否存在，并通过ReflectionMethod类来获悉当前调试的类的信息，并且判断当前执行方法是否为public属性，不是的话抛出异常，是的话，便调用invoke方法执行类方法，接下里便是自己的代码了，同时注意的是在解析sql语句的时候执行的tp里的方法。

ok，流程跑了一遍，自己感觉清晰多了，以前就是在项目里写代码，从不看tp的源代码的，今天过了下，感觉良好，下次多过几遍，把里面的精髓掌握住，就写到这里。