Laravel Exception处理逻辑解析

Laravel Exception处理逻辑解析

vendor/laravel/framework/src/Illuminate/Foundation/Application.php

  1. app首先继承了container,作为一个容器类存在
  2. 注册了laravel运行过程的需要的基础类进容器,并且生成了运行需要的实例。承担了初始化功能。这里需要额外说一下,app里面说的所谓注册,不是指绑定,应该是直接直接实例化了,并注入到容器。但是,针对provider,实例化了provider,并运行了,并不会生成实际的类,而是将类绑定。

ExceptionHandler的注册就是在Application的__construct方法中。

$this->registerErrorHandling();

接着我们来到定义该方法的trait:RegistersExceptionHandlers找到该方法。看一下该方法实现了什么样的逻辑。便于理解我加上了一些注释。

protected function registerErrorHandling()
    {
        error_reporting(-1);//-1报告所有异常,包括后续新定义的异常级别,作用与E_ALL相同
        
/** set_error_handler,set_exception_handler,register_shutdown_function分别注册不同级别不同类型异常的处理方法。 */

        set_error_handler(function ($level, $message, $file = '', $line = 0) {
            if (error_reporting() & $level) {
                throw new ErrorException($message, 0, $level, $file, $line);
            }
        });//代替标准错误处理方法

        set_exception_handler(function ($e) {
            $this->handleUncaughtException($e);
        });//兜底异常处理方法注册

        register_shutdown_function(function () {
            $this->handleShutdown();
        });//注册一个在脚本正常或非正常情况终止执行时调用的方法。(终极兜底)
    }

我们看到laravel主要通过三个原生方法来实现主要的ExceptionHandler机制。下面我们分开看一下这里都分别注册了哪些函数。

set_error_handler

function ($level, $message, $file = '', $line = 0) {
            if (error_reporting() & $level) {
                throw new ErrorException($message, 0, $level, $file, $line);
            }
        }

这块很简单,set_error_handler注册的函数会代替原生的报错处理逻辑。这里可以看到laravel将执行error作为异常抛出。并且保留了error的主要信息。(level,msg,file,line)

set_exception_handler

/**set_exception_handler(function ($e) {
            $this->handleUncaughtException($e);
});**/
        
protected function handleUncaughtException($e)
    {
    //从容器中实例化一个真正的handler。(使用make方法)
        $handler = $this->resolveExceptionHandler();
    //如果获取到的是Error,通过Error信息实例化一个已定义的“可抛出的致命错误”
        if ($e instanceof Error) {
            $e = new FatalThrowableError($e);
        }
    //记录日志(先判断是否报告)
        $handler->report($e);
    //render错误
        if ($this->runningInConsole()) {
            $handler->renderForConsole(new ConsoleOutput, $e);
        } else {
            $handler->render($this->make('request'), $e)->send();
        }
    }   
  1. resolveExceptionHandler方法从容器中make了一个handler实例,从该方法可以找到laravel实现的handler方法。该方法会判断是否绑定抽象类型来判断使用开发者自行绑定的ExceptionHandler还是系统自带的。handler的作用只有一点,就是解析异常,并将异常处理成我们想要的,更加用户友好的方式展示。(++render方法,可以看“LaravelLumenExceptionsHandler”,该类实现了Laravel的ExceptionHandler接口,想要自定义异常输出的话也可以参考该类++)
  2. report和render方法都是handler中定义的,report会先进行判断,并根据判断结果决定是否记录log。render自然不必多说,formatexception info,并作为一个HTTP response输出。

register_shutdown_function

protected function handleShutdown()
    {
        if (! is_null($error = error_get_last()) && $this->isFatalError($error['type'])) {
            $this->handleUncaughtException(new FatalErrorException(
                $error['message'], $error['type'], 0, $error['file'], $error['line']
            ));
        }
    }

error_get_last()是5.2版本实现的方法,能够很好的配合的register_shutdown_function进行兜底处理。改善了需要自定义变量判断的方法。

error_get_last 返回了一个关联数组,描述了最后错误的信息,以该错误的 "type"、 "message"、"file" 和 "line" 为数组的键。

另外,该方法规定只有致命的错误才会启动。

原文地址:https://www.cnblogs.com/augurG/p/10512541.html