一、載入中間件
之前寫到的一篇文章分析了應用的初始化,也就是對Http 類別的run() 方法裡面呼叫的runWithRequest () 方法的第一行程式碼$this->initialize() 的展開分析。讓我們再看一眼 runWithRequest () 方法的前幾行:
protected function runWithRequest(Request $request) { $this->initialize(); // 加载全局中间件 $this->loadMiddleware(); . . .
應用初始化後,接下來開始處理中間件。
中間件類別的初始化
loadMiddleware 方法:
protected function loadMiddleware(): void { if (is_file($this->app->getBasePath() . 'middleware.php')) { $this->app->middleware->import(include $this->app->getBasePath() . 'middleware.php'); } }
仍然是百用不厭的套路,透過$this->app->middleware 來實例化中間件並取得其實例。
導入中間件
透過$this->app->middleware 得到Middleware 類別的實例後,接著程式呼叫import 方法,傳入從「app」目錄下的「middleware .php”檔案中讀取的資料。該文件的原始內容如下(原來全部註解掉的):
return [ // 全局请求缓存 // \think\middleware\CheckRequestCache::class, // 多语言加载 \think\middleware\LoadLangPack::class, // Session初始化 // \think\middleware\SessionInit::class, // 页面Trace调试 \think\middleware\TraceDebug::class, ];
這裡為了研究中間件是如何載入的,先去掉兩個註釋,也就是加入兩個中間件。接下來看 import 方法:
public function import(array $middlewares = [], string $type = 'global'): void { foreach ($middlewares as $middleware) { $this->add($middleware, $type); } }
這個方法傳入一個中間件的陣列和一個中間件類型,預設為 global,關鍵是裡面的 add 方法。跳轉到 add 方法:
public function add($middleware, string $type = 'route'): void { if (is_null($middleware)) { return; } $middleware = $this->buildMiddleware($middleware, $type); if ($middleware) { $this->queue[$type][] = $middleware; // 去除重复 $this->queue[$type] = array_unique($this->queue[$type], SORT_REGULAR); } }
實際上真正工作的是 buildMiddleware 方法,直接前往:
protected function buildMiddleware($middleware, string $type): array { // 是否是数组 if (is_array($middleware)) { // 列出中间件及其参数 // 这里说明我们可以给中间件传入参数,且形式为 [中间件, 参数] list($middleware, $param) = $middleware; } // 是否是一个闭包 // 说明中间件可以是一个闭包 if ($middleware instanceof \Closure) { //返回闭包和参数 return [$middleware, $param ?? null]; } // 排除了上面几种类型,且不是字符串,抛出错误 if (!is_string($middleware)) { throw new InvalidArgumentException('The middleware is invalid'); } //中间件别名检查 $alias = $this->app->config->get('middleware.alias', []); if (isset($alias[$middleware])) { $middleware = $alias[$middleware]; } //如果中间件有包含中间件(说明中间件可以嵌套) //再走一遍「import」递归解析 if (is_array($middleware)) { $this->import($middleware, $type); return []; } //返回解析结果 return [[$middleware, 'handle'], $param ?? null]; }
詳細分析見以上程式碼註解。最後傳回的結果,在 add 方法中,執行 $ this->queue\[$type][] = $middleware; 加入到一個佇列。最後的解析結果大概是這樣的(app/middleware.php 去掉部分中間件的註解):
至此,全域中間件就載入完畢。
二、多應用解析
載入完中間件,接下來一步是多應用解析(ThinkPHP 6 開始支援多應用模式)。
if ($this->multi) { $this->parseMultiApp(); }
注意到,Http 類別的建構子:
public function __construct(App $app) { $this->app = $app; //多应用解析,通过判断「app」目录下有无「controller」目录,没有就是多应用模式 $this->multi = is_dir($this->app->getBasePath() . 'controller') ? false : true; }
可以看到,程式是透過判斷「app」目錄下有無「controller」目錄來決定是否是多應用模式的。
接著看主要方法 parseMultiApp:
protected function parseMultiApp(): void { // 虽然在「Http」的构造函数自动判断过是否开启多应用 //如果没有controller目录,$this->multi为true,就会来到本方法 // 接着还要看配置文件是否有配置 if ($this->app->config->get('app.auto_multi_app', false)) { // 自动多应用识别 $this->bindDomain = false; // 获取域名绑定 $bind = $this->app->config->get('app.domain_bind', []); // 如果有域名绑定 if (!empty($bind)) { // 获取当前子域名 $subDomain = $this->app->request->subDomain(); $domain = $this->app->request->host(true); //完整域名绑定 if (isset($bind[$domain])) { $appName = $bind[$domain]; $this->bindDomain = true; //子域名绑定 } elseif (isset($bind[$subDomain])) { $appName = $bind[$subDomain]; $this->bindDomain = true; //二级泛域名绑定 } elseif (isset($bind['*'])) { $appName = $bind['*']; $this->bindDomain = true; } } //如果没有域名绑定 if (!$this->bindDomain) { //获取别名映射 $map = $this->app->config->get('app.app_map', []); //获取禁止URL访问目录 $deny = $this->app->config->get('app.deny_app_list', []); //获取当前请求URL的pathinfo信息(含URL后缀) // 比如 index/index/index $path = $this->app->request->pathinfo(); // 比如,从index/index/index获取得index $name = current(explode('/', $path)); //解析别名映射 if (isset($map[$name])) { //如果这个别名映射到的是一个闭包 //这样不知有啥用 if ($map[$name] instanceof Closure) { $result = call_user_func_array($map[$name], [$this]); $appName = $result ?: $name; //直接取得应用名 } else { $appName = $map[$name]; } //$name不为空且$name在$map数组中作为KEY,或者$name是禁止URL方位的目录 } elseif ($name && (false !== array_search($name, $map) || in_array($name, $deny))) { throw new HttpException(404, 'app not exists:' . $name); } elseif ($name && isset($map['*'])) { $appName = $map['*']; } else { $appName = $name; } if ($name) { $this->app->request->setRoot('/' . $name); $this->app->request->setPathinfo(strpos($path, '/') ? ltrim(strstr($path, '/'), '/') : ''); } } } else { $appName = $this->name ?: $this->getScriptName(); } $this->loadApp($appName ?: $this->app->config->get('app.default_app', 'index')); }
可以看到,「pathinfo」資訊的第一節會被解析成應用程式名稱,例如 index/index/index/ 中的 index。方法的最後也呼叫了 loadApp 方法,執行的操作與前面應用的初始化類似,只是載入的檔案都在該應用的目錄中。
跟之前的版本對比,ThinkPHP 6 看起來把原先的模組改造成了多應用,因為多應用情況下,應用名跟之前的模組名都是從pathinfo 的第一節解析出來的,新的文檔也沒見到模組的內容了。