首頁  >  文章  >  php框架  >  ThinkPHP6載入中間件及多應用解析

ThinkPHP6載入中間件及多應用解析

藏色散人
藏色散人轉載
2021-07-09 14:48:453369瀏覽

一、載入中間件

之前寫到的一篇文章分析了應用的初始化,也就是對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 去掉部分中間件的註解):

ThinkPHP6載入中間件及多應用解析

至此,全域中間件就載入完畢。

二、多應用解析

載入完中間件,接下來一步是多應用解析(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 的第一節解析出來的,新的文檔也沒見到模組的內容了。

相關推薦:最新的10個thinkphp影片教學

以上是ThinkPHP6載入中間件及多應用解析的詳細內容。更多資訊請關注PHP中文網其他相關文章!

陳述:
本文轉載於:segmentfault.com。如有侵權,請聯絡admin@php.cn刪除