Laravel源码入门－启动引导过程（五）$kernel->handle($request)

 

上篇：Laravel源码入门－启动引导过程（四）app/Http/Kernel.php

Kernel 做了两件事，第一个是定义 $bootstraps[]，做好了 boot 系统的准备，第二个是定义 各种 middleware，这些都对 $request 进行加工、处理、甄选、判断，最终为可以形成正确的、有效的 $response 做准备，都完成后，进行了 index.php 中的 $kernel->handle($request)，返回 $response。

仔细分析发现，public/index.php 中 $kernel 在make() 时，真的只是做了准备，真正的载入环境变量（.env）、根据配置载入 Service Providers 等，实际在 $kernel->handle($request) 语句中进行。先贴出加入测试 echo 记录下的载入过程结果。

// 开始 public/index.php

$app = require_once __DIR__.'/../bootstrap/app.php' 

$kernel = $app->make(Illuminate\Contracts\Http\Kernel::class); 

start-->$response = $kernel->handle() 

// 进入 Illuminate/Foundation/Http/Kernel.php

Foundation/Http/Kernel::handle() 
Foundation/Http/Kernel::sendRequestThroughRouter() 
Foundation/Http/Kernel::bootstrap() 

// 进入 Illumniate/Foundation/Application.php

Foundation/Application::bootstrapWith($bootstrapWith) 

Illuminate\Foundation\Bootstrap\LoadEnvironmentVariables

Illuminate\Foundation\Bootstrap\LoadConfiguration
reading config/app.php 

Illuminate\Foundation\Bootstrap\HandleExceptions
Illuminate\Foundation\Bootstrap\RegisterFacades
Illuminate\Foundation\Bootstrap\RegisterProviders
Illuminate\Foundation\Bootstrap\BootProviders

// 回到 public/index.php

end<---$response = $kernel->handle() 

下面具体看一下 Illuminate\Foundation\Http\Kernel.php 的 handle() 及相关代码片段。

// Illuminate\Foundation\Http\Kernel.php 片段

    /**
     * The bootstrap classes for the application.
     * 引导类，起引导作用的类
     *
     * @var array
     */
    protected $bootstrappers = [
        // 载入服务器环境变量（.env 文件）
        \Illuminate\Foundation\Bootstrap\LoadEnvironmentVariables::class,
        // 载入配置信息（config 目录）
        \Illuminate\Foundation\Bootstrap\LoadConfiguration::class,
        // 配置如何处理异常
        \Illuminate\Foundation\Bootstrap\HandleExceptions::class,
        // 注册 Facades
        \Illuminate\Foundation\Bootstrap\RegisterFacades::class,
        // 注册 Providers
        \Illuminate\Foundation\Bootstrap\RegisterProviders::class,
        // 启动 Providers
        \Illuminate\Foundation\Bootstrap\BootProviders::class,
    ];

    // 此处省略无关代码

    /**
     * Handle an incoming HTTP request. 处理请求的 handle()
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    public function handle($request)
    {
        echo 'Foundation/Http/Kernel::handle() <br />';
        try {
            $request->enableHttpMethodParameterOverride();

            // 将请求发送至中间件、路由处理。
            $response = $this->sendRequestThroughRouter($request);
        } catch (Exception $e) {
            $this->reportException($e);

            $response = $this->renderException($request, $e);
        } catch (Throwable $e) {
            $this->reportException($e = new FatalThrowableError($e));

            $response = $this->renderException($request, $e);
        }

        event(new Events\RequestHandled($request, $response));

        return $response;
    }

    /**
     * Send the given request through the middleware / router.
     * 将请求发送至中间件、路由处理。
     *
     * @param  \Illuminate\Http\Request  $request
     * @return \Illuminate\Http\Response
     */
    protected function sendRequestThroughRouter($request)
    {
        echo 'Foundation/Http/Kernel::sendRequestThroughRouter() <br />';

        $this->app->instance('request', $request);

        Facade::clearResolvedInstance('request');

        // Kernel 要启动引导
        $this->bootstrap();

        return (new Pipeline($this->app))
                    ->send($request)
                    ->through($this->app->shouldSkipMiddleware() ? [] : $this->middleware)
                    ->then($this->dispatchToRouter());
    }

    /**
     * Bootstrap the application for HTTP requests.
     * 启动引导（requests 驱动）
     *
     * @return void
     */
    public function bootstrap()
    {
        echo 'Foundation/Http/Kernel::bootstrap() <br />';

        if (! $this->app->hasBeenBootstrapped()) {
            // 使用 Application 的 bootstrapWith()方法启动引导
            // 参数是 Kernel 中的 bootstrapers[]。
            $this->app->bootstrapWith($this->bootstrappers());
        }
    }

=== 总结 ===

如先期描述的 handle() 通过 sendRequestThroughtRouter($request) 处理请求，返回 $response，途中进行了 启动引导，$this->bootstrap()，进一步调用 Application 的 bootstrapWith()，将自己定义的 bootstrapper[] 传入，这个 bootstrappers[] 如前定义，包括了载入服务器环境变量、配置信息、服务提供者、异常处理等。一切结束后，没有抛出异常的话，返回 public/index.php，正如开始的 echo 记录一样。

附：Application 中 bootstrapWith() 代码

下篇：Laravel源码入门－启动引导过程（六）LoadEnvironmentVariables

// Illuminate\Foundation\Application.php 代码片段

    /**
     * Run the given array of bootstrap classes.
     *
     * @param  array  $bootstrappers
     * @return void
     */
    public function bootstrapWith(array $bootstrappers)
    {
        echo 'Foundation/Application::bootstrapWith($bootstrapWith) <br />';
        $this->hasBeenBootstrapped = true;

        foreach ($bootstrappers as $bootstrapper) {
            echo $bootstrapper . '<br />';
            
            $this['events']->fire('bootstrapping: '.$bootstrapper, [$this]);

            // 解析每个 $bootstrapper，由调用他们自身的 bootstrap()，引导。
            $this->make($bootstrapper)->bootstrap($this);

            $this['events']->fire('bootstrapped: '.$bootstrapper, [$this]);
        }
    }