[李景山php]thinkphp核心源碼注釋-Disaptcher.class.php

2020-03-22 19:30:26
字體：大中小
來源：轉載
供稿：網友
<?php// +----------------------------------------------------------------------// | ThinkPHP [ WE CAN DO IT JUST THINK IT ]// +----------------------------------------------------------------------// | Copyright (c) 2006-2014 http://thinkVeVb.com All rights reserved.// +----------------------------------------------------------------------// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )// +----------------------------------------------------------------------// | Author: liu21st <liu21st@gmail.com>// +----------------------------------------------------------------------namespace Think;/** * ThinkPHP內置的Dispatcher類 * 完成URL解析、路由和調度 * 此處先留下一個問號，route 是干什么的呢？ * 很長了，解析的不好，抽空重新解析一下 */html' target='_blank'>class Dispatcher {    /**     * URL映射到控制器     * @access public     * @return void     */    static public function dispatch() {        $varPath        =   C('VAR_PATHINFO');// 路徑        // 'VAR_PATHINFO'          =>  's',    // 兼容模式PATHINFO獲取變量例如 ?s=/module/action/id/1 后面的參數取決于URL_PATHINFO_DEPR        $varAddon       =   C('VAR_ADDON');// 插件        // 'VAR_ADDON'             =>  'addon',     // 默認的插件控制器命名空間變量        $varModule      =   C('VAR_MODULE');// 模塊        // 'VAR_MODULE'            =>  'm',     // 默認模塊獲取變量        $varController  =   C('VAR_CONTROLLER');// 控制器        // 'VAR_CONTROLLER'        =>  'c',    // 默認控制器獲取變量        $varAction      =   C('VAR_ACTION');// 方法        // 'VAR_ACTION'            =>  'a',    // 默認操作獲取變量        $urlCase        =   C('URL_CASE_INSENSITIVE');// url 類型        // 'URL_CASE_INSENSITIVE'  =>  true,   // 默認false 表示URL區分大小寫 true則表示不區分大小寫        if(isset($_GET[$varPath])) { // 判斷URL里面是否有兼容模式參數            $_SERVER['PATH_INFO'] = $_GET[$varPath];            unset($_GET[$varPath]);        }elseif(IS_CLI){ // CLI模式下 index.php module/controller/action/params/...            $_SERVER['PATH_INFO'] = isset($_SERVER['argv'][1]) ? $_SERVER['argv'][1] : '';        }        // 這里 介紹了 里面 PATH_INFO的信息        // 開啟子域名部署        if(C('APP_SUB_DOMAIN_DEPLOY')) {            // 'APP_SUB_DOMAIN_DEPLOY' =>  false,   // 是否開啟子域名部署            // 默認這里是不存在的            $rules      = C('APP_SUB_DOMAIN_RULES'); // 默認是空            // 'APP_SUB_DOMAIN_RULES'  =>  array(), // 子域名部署規則            if(isset($rules[$_SERVER['HTTP_HOST']])) { // 完整域名或者IP配置                // 默認運行這里是沒有的                define('APP_DOMAIN',$_SERVER['HTTP_HOST']); // 當前完整域名                $rule = $rules[APP_DOMAIN]; // 當前的規則改成 APP DOMAIN 規則            }else{ // 如果跑到這里了，基本上這個了                if(strpos(C('APP_DOMAIN_SUFFIX'),'.')){ // com.cn net.cn                    // $_SERVER['HTTP_HOST']＝＝'www.baidu.com'                    // 'APP_DOMAIN_SUFFIX'     =>  '', // 域名后綴 如果是com.cn net.cn 之類的后綴必須設置                    $domain = array_slice(explode('.', $_SERVER['HTTP_HOST']), 0, -3);                }else{                    $domain = array_slice(explode('.', $_SERVER['HTTP_HOST']), 0, -2);                                    }                // $_SERVER['HTTP_HOST']  www.baidu.com                // $a = explode('.','www.baidu.com.cn');                // print_r(array_slice($a,0,-3));                // Array ( [0] => www )                // array_slice() 函數在數組中根據條件取出一段值，并返回。                // 總結 ：也就是取到域名了呢， 渠道真實的域名，因為他不知道前面                if(!empty($domain)) {                    // 這里肯定能夠得到了 比如， www                    $subDomain = implode('.', $domain); // 這里拼出來的，更深層的多級域名                    define('SUB_DOMAIN',$subDomain); // 當前完整子域名 找到了這個完成的子域名                    $domain2   = array_pop($domain); // 二級域名 獲取了這個的二級域名                    if($domain) { // 存在三級域名                        $domain3 = array_pop($domain);                    }                    if(isset($rules[$subDomain])) { // 子域名                        $rule = $rules[$subDomain];// 這里 規則                    }elseif(isset($rules['*.' . $domain2]) && !empty($domain3)){ // 泛三級域名                        $rule = $rules['*.' . $domain2];                        $panDomain = $domain3; // 泛三級規則                    }elseif(isset($rules['*']) && !empty($domain2) && 'www' != $domain2 ){ // 泛二級域名                        $rule      = $rules['*'];                        $panDomain = $domain2;                    }                }                // 分別進行規則的處理            }            if(!empty($rule)) { // 一般情況下應該是為空的                // 子域名部署規則 '子域名'=>array('模塊名[/控制器名]','var1=a&var2=b');                if(is_array($rule)){                    list($rule,$vars) = $rule;                }// 這里的范式，簡直就是太多了， 規則一下了                $array      =   explode('/',$rule); // 還要區分 控制器，模塊                // 模塊綁定                define('BIND_MODULE',array_shift($array)); // 綁定對應的模塊                // 控制器綁定                         if(!empty($array)) { // 如果存在控制器，就綁定控制器                    $controller  =   array_shift($array);                    if($controller){                        define('BIND_CONTROLLER',$controller);                    }                }                if(isset($vars)) { // 傳入參數                    parse_str($vars,$parms); // parse_str(string,array)                    if(isset($panDomain)){ // 如果需要處理點 東西                        $pos = array_search('*', $parms); //在數組中搜索鍵值 "red"，并返回它的鍵名：                        if(false !== $pos) {                            // 泛域名作為參數                            $parms[$pos] = $panDomain; // 替換泛參數                        }                                             }                                       $_GET   =  array_merge($_GET,$parms); // 合并參數                }            }        }        // 開啟子域名 結束        // 此處位置為 獲取了  $rule 并且 $GET 進行了重新的準備 $rules        // 分析PATHINFO信息        if(!isset($_SERVER['PATH_INFO'])) {            $types   =  explode(',',C('URL_PATHINFO_FETCH'));            // 'URL_PATHINFO_FETCH'    =>  'ORIG_PATH_INFO,REDIRECT_PATH_INFO,REDIRECT_URL', // 用于兼容判斷PATH_INFO 參數的SERVER替代變量列表            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');        // 'URL_PATHINFO_DEPR'     =>  '/', // PATHINFO模式下，各參數之間的分割符號        define('MODULE_PATHINFO_DEPR',  $depr); // 定義了這個        if(empty($_SERVER['PATH_INFO'])) { // 一般情況下，好像現在轉成的都            $_SERVER['PATH_INFO'] = '';            define('__INFO__','');            define('__EXT__','');        }else{ // 這個是含有對應關系的            define('__INFO__',trim($_SERVER['PATH_INFO'],'/'));            // URL后綴            define('__EXT__', strtolower(pathinfo($_SERVER['PATH_INFO'],PATHINFO_EXTENSION)));            $_SERVER['PATH_INFO'] = __INFO__;                 if(!defined('BIND_MODULE') && (!C('URL_ROUTER_ON') || !Route::check())){                if (__INFO__ && C('MULTI_MODULE')){ // 獲取模塊名                    $paths      =   explode($depr,__INFO__,2);                    $allowList  =   C('MODULE_ALLOW_LIST'); // 允許的模塊列表                    $module     =   preg_replace('//.' . __EXT__ . '$/i', '',$paths[0]);                    if( empty($allowList) || (is_array($allowList) && in_array_case($module, $allowList))){                        $_GET[$varModule]       =   $module;                        $_SERVER['PATH_INFO']   =   isset($paths[1])?$paths[1]:'';                    }                }            }                     }        // URL常量        define('__SELF__',strip_tags($_SERVER[C('URL_REQUEST_URI')]));        // 獲取模塊名稱        define('MODULE_NAME', defined('BIND_MODULE')? BIND_MODULE : self::getModule($varModule));        // 準備好了數據、然后開始處理你需要的流程了        // 檢測模塊是否存在        if( MODULE_NAME && (defined('BIND_MODULE') || !in_array_case(MODULE_NAME,C('MODULE_DENY_LIST')) ) && is_dir(APP_PATH.MODULE_NAME)){            // 定義當前模塊路徑            define('MODULE_PATH', APP_PATH.MODULE_NAME.'/');            // 定義當前模塊的模版緩存路徑            C('CACHE_PATH',CACHE_PATH.MODULE_NAME.'/');            // 定義當前模塊的日志目錄            C('LOG_PATH',  realpath(LOG_PATH).'/'.MODULE_NAME.'/'); // 定義了 很多東西了            // 模塊檢測            Hook::listen('module_check'); // 監聽了            // 加載模塊配置文件            if(is_file(MODULE_PATH.'Conf/config'.CONF_EXT))                C(load_config(MODULE_PATH.'Conf/config'.CONF_EXT)); // 加載 不同位置            // 加載應用模式對應的配置文件            if('common' != APP_MODE && is_file(MODULE_PATH.'Conf/config_'.APP_MODE.CONF_EXT))                C(load_config(MODULE_PATH.'Conf/config_'.APP_MODE.CONF_EXT));            // 當前應用狀態對應的配置文件            if(APP_STATUS && is_file(MODULE_PATH.'Conf/'.APP_STATUS.CONF_EXT))                C(load_config(MODULE_PATH.'Conf/'.APP_STATUS.CONF_EXT));            // 加載模塊別名定義            if(is_file(MODULE_PATH.'Conf/alias.php'))                Think::addMap(include MODULE_PATH.'Conf/alias.php'); // 加載了 不同的類型            // 加載模塊tags文件定義            if(is_file(MODULE_PATH.'Conf/tags.php'))                Hook::import(include MODULE_PATH.'Conf/tags.php');            // 加載模塊函數文件            if(is_file(MODULE_PATH.'Common/function.php'))                include MODULE_PATH.'Common/function.php'; // 加載了 各種各樣的東西            $urlCase        =   C('URL_CASE_INSENSITIVE');            // 加載模塊的擴展配置文件            load_ext_file(MODULE_PATH); // 里面的 東西        }else{            E(L('_MODULE_NOT_EXIST_').':'.MODULE_NAME);        }        if(!defined('__APP__')){            $urlMode        =   C('URL_MODEL');            if($urlMode == URL_COMPAT ){// 兼容模式判斷                define('PHP_FILE',_PHP_FILE_.'?'.$varPath.'=');            }elseif($urlMode == URL_REWRITE ) {                $url    =   dirname(_PHP_FILE_);                if($url == '/' || $url == '//')                    $url    =   '';                define('PHP_FILE',$url);            }else {                define('PHP_FILE',_PHP_FILE_);            }            // 當前應用地址            define('__APP__',strip_tags(PHP_FILE));        }        // 處理 __APP__ 里面的 東西        // 模塊URL地址        $moduleName    =   defined('MODULE_ALIAS')? MODULE_ALIAS : MODULE_NAME;        define('__MODULE__',(defined('BIND_MODULE') || !C('MULTI_MODULE'))? __APP__ : __APP__.'/'.($urlCase ? strtolower($moduleName) : $moduleName));        if('' != $_SERVER['PATH_INFO'] && (!C('URL_ROUTER_ON') ||  !Route::check()) ){   // 檢測路由規則 如果沒有則按默認規則調度URL            Hook::listen('path_info');            // 檢查禁止訪問的URL后綴            if(C('URL_DENY_SUFFIX') && preg_match('//.('.trim(C('URL_DENY_SUFFIX'),'.').')$/i', $_SERVER['PATH_INFO'])){                send_http_status(404);                exit;            }            // 去除URL后綴            $_SERVER['PATH_INFO'] = preg_replace(C('URL_HTML_SUFFIX')? '//.('.trim(C('URL_HTML_SUFFIX'),'.').')$/i' : '//.'.__EXT__.'$/i', '', $_SERVER['PATH_INFO']);            $depr   =   C('URL_PATHINFO_DEPR'); // 獲取信息            $paths  =   explode($depr,trim($_SERVER['PATH_INFO'],$depr));            if(!defined('BIND_CONTROLLER')) {// 獲取控制器                if(C('CONTROLLER_LEVEL')>1){// 控制器層次                    $_GET[$varController]   =   implode('/',array_slice($paths,0,C('CONTROLLER_LEVEL')));                    $paths  =   array_slice($paths, C('CONTROLLER_LEVEL'));                }else{                    $_GET[$varController]   =   array_shift($paths);                }            }            // 獲取操作            if(!defined('BIND_ACTION')){                $_GET[$varAction]  =   array_shift($paths);            }            // 解析剩余的URL參數            $var  =  array();            if(C('URL_PARAMS_BIND') && 1 == C('URL_PARAMS_BIND_TYPE')){                // URL參數按順序綁定變量                $var    =   $paths;            }else{                preg_replace_callback('/(/w+)//([^//]+)/', function($match) use(&$var){$var[$match[1]]=strip_tags($match[2]);}, implode('/',$paths));            }            $_GET   =  array_merge($var,$_GET);        }        // 獲取控制器的命名空間（路徑）        define('CONTROLLER_PATH',   self::getSpace($varAddon,$urlCase));        // 獲取控制器和操作名        define('CONTROLLER_NAME',   defined('BIND_CONTROLLER')? BIND_CONTROLLER : self::getController($varController,$urlCase));        define('ACTION_NAME',       defined('BIND_ACTION')? BIND_ACTION : self::getAction($varAction,$urlCase));        // 當前控制器的UR地址        $controllerName    =   defined('CONTROLLER_ALIAS')? CONTROLLER_ALIAS : CONTROLLER_NAME;        define('__CONTROLLER__',__MODULE__.$depr.(defined('BIND_CONTROLLER')? '': ( $urlCase ? parse_name($controllerName) : $controllerName )) );        // 當前操作的URL地址        define('__ACTION__',__CONTROLLER__.$depr.(defined('ACTION_ALIAS')?ACTION_ALIAS:ACTION_NAME));        //保證$_REQUEST正常取值        $_REQUEST = array_merge($_POST,$_GET,$_COOKIE); // -- 加了$_COOKIE.  保證哦..  // 搞了半天什么都有了    }    // 進過了這里的東西，折騰了一圈后發現了，其實，就是里面的 東西 都是 重新定義了 里面的 東西了。    /**     * 獲得控制器的命名空間路徑 便于插件機制訪問     * 獲取 控制器 命名空間     */    static private function getSpace($var,$urlCase) {        $space  =   !empty($_GET[$var])?strip_tags($_GET[$var]):''; // strip_tags() 函數剝去字符串中的 HTML、XML 以及 PHP 的標簽。        unset($_GET[$var]); // 刪除了 里面 變量了        return $space;    }// 這里的 東西 可以變成了    /**     * 獲得實際的控制器名稱     * 這里 控制器     */    static private function getController($var,$urlCase) {        $controller = (!empty($_GET[$var])? $_GET[$var]:C('DEFAULT_CONTROLLER'));        unset($_GET[$var]); // 去掉了 里面的東西了        if($maps = C('URL_CONTROLLER_MAP')) {            if(isset($maps[strtolower($controller)])) {                // 記錄當前別名                define('CONTROLLER_ALIAS',strtolower($controller));                // 獲取實際的控制器名                return   ucfirst($maps[CONTROLLER_ALIAS]);            }elseif(array_search(strtolower($controller),$maps)){// 這里進行了 控制 了                // 禁止訪問原始控制器                return   '';            }        }        if($urlCase) {            // URL地址不區分大小寫            // 智能識別方式 user_type 識別到 UserTypeController 控制器            $controller = parse_name($controller,1); // 解析 里面的 東西        }        return strip_tags(ucfirst($controller));    }    /**     * 獲得實際的操作名稱     * 獲取了 Action 里面的     */    static private function getAction($var,$urlCase) {        $action   = !empty($_POST[$var]) ?            $_POST[$var] :            (!empty($_GET[$var])?$_GET[$var]:C('DEFAULT_ACTION'));        unset($_POST[$var],$_GET[$var]);        if($maps = C('URL_ACTION_MAP')) {            if(isset($maps[strtolower(CONTROLLER_NAME)])) {                $maps =   $maps[strtolower(CONTROLLER_NAME)];                if(isset($maps[strtolower($action)])) {                    // 記錄當前別名                    define('ACTION_ALIAS',strtolower($action));                    // 獲取實際的操作名                    if(is_array($maps[ACTION_ALIAS])){                        parse_str($maps[ACTION_ALIAS][1],$vars);                        $_GET   =   array_merge($_GET,$vars);                        return $maps[ACTION_ALIAS][0];                    }else{                        return $maps[ACTION_ALIAS];                    }                }elseif(array_search(strtolower($action),$maps)){                    // 禁止訪問原始操作                    return   '';                }            }        }        return strip_tags( $urlCase? strtolower($action) : $action );    }    /**     * 獲得實際的模塊名稱     * 獲取模塊名     */    static private function getModule($var) {        $module   = (!empty($_GET[$var])?$_GET[$var]:C('DEFAULT_MODULE'));        unset($_GET[$var]);        if($maps = C('URL_MODULE_MAP')) {            if(isset($maps[strtolower($module)])) {                // 記錄當前別名                define('MODULE_ALIAS',strtolower($module));                // 獲取實際的模塊名                return   ucfirst($maps[MODULE_ALIAS]);            }elseif(array_search(strtolower($module),$maps)){                // 禁止訪問原始模塊                return   '';            }        }        return strip_tags(ucfirst($module));    }}