laravel报错怎么排查

在使用Laravel框架进行开发过程中，难免会出现各种错误或异常。如何快速排查错误并解决问题，是基础开发者面临的挑战。本文将为您介绍Laravel报错的排查方法，帮助您在开发过程中事半功倍。

一、日志记录

Laravel会将日志信息按照不同等级（debug、info、notice、warning、error、critical、alert、emergency）分别记录在不同文件中。我们可以通过查看日志文件来快速找出代码中出现的错误。

1.1 查看日志文件

打开项目根目录中的storage/logs目录，可以看到laravel.log文件，这个是系统所有级别日志 的总日志文件，如果想以某种级别来分集日志记录，可在config/logging.php 文件中进行配置；

在日志文件中，可以针对时间、进程、级别等条件进行筛选查看错误信息。具体使用方式如下：

tail -f storage/logs/laravel.log // 监控最新的日志内容，按Ctrl+C停止
cat storage/logs/laravel.log | grep '关键字' // 搜索包含"关键字"的日志内容
tail -n 100 storage/logs/laravel.log | grep '关键字' // 查看最后100行日志是否包含"关键字"

1.2 级别设置

通过 Laravel 自带的目录 app/Exceptions/Handler.php 类，可以看到日志的级别设置在了 report() 函数的第一个参数中，Laravel 默认的日志级别为 error，这意味着，只有 error 级别及以上的日志会被记录在 app/public/storage/logs/laravel.log 日志文件中。

如果想要将 warning 级别及以上的日志都写入日志文件，可以在report() 函数的第一个参数中添加起始级别，如下所示：

public function report(Exception $exception)
{
    if ($this->shouldReport($exception)) {
        Log::channel('daily')->warning('遇到错误啦！', [
            'error' => $exception->getMessage()
        ]);
    }

    parent::report($exception);
}

通过Log::channel('daily')->warning()操作，将错误信息与级别一起写入日志，并通过shouldReport() 方法判断是否需要写入日志。

二、异常处理

在Laravel应用中，抛出自定义异常的方式非常简单，只需进行以下操作即可：

2.1 自定义异常

创建一个新的异常类，并继承Laravel默认的Exception类，如下所示：

namespace AppExceptions;
use Exception;

class CustomException extends Exception
{
    public function __construct($message = null, $code = 0)
    {
        parent::__construct($message, $code); // 调用父类的构造方法
    }
     public function report()
    {
        // 记录错误日志 
        Log::error('CustomException：'.$this->getMessage());
    }

    public function render($request)
    {
        return response()->json(['message' => $this->getMessage()], Response::HTTP_INTERNAL_SERVER_ERROR);
    }
}

在构造方法中，我们可以定义异常信息及状态码，并在 report() 方法中记录错误日志，在 render() 方法中返回JSON格式的异常信息及状态码。

当应用程序中出现了 CustomException时，Laravel会自动执行 report() 方法将错误信息记录到日志文件中，并通过 render() 方法返回异常信息给前端显示。

2.2 触发异常

在代码中使用 throw new CustomException ()方法即可抛出异常，如下所示：

public function test(Request $request)
{
    // ...
    if (! check_validate($request->all())) {
        throw new CustomException('请求参数不正确');
    } 
}

三、错误调试

在进行开发或测试时，有时需要在代码中打出调试信息来方便查找问题所在，而在 Laravel 中，我们可以通过 dump() 和 dd() 两个函数来快速输出调试信息和中断程序执行结果。

3.1 dump()和dd()

dump() 函数用于打印变量或者数组的内容，不会中断程序的运行。类似于PHP内置的var_dump()函数。

dd() 函数不仅会打印变量或者数组的内容，还会中断程序的执行，并且把处理到当前位置的代码堆栈以及异常的具体信息都显示出来。类似于PHP内置die() 或exit()函数。

Route::get('/test', function () {
    dump('Hello Laravel!');
    return response()->json(['key' => 'value']);
});

Route::get('/test2', function () {
    $array = ['key_one' => 'value_one', 'key_two' => 'value_two'];
    dd($array);
    return response()->json(['key' => 'value']);
});

在上述代码中，我们通过 dump() 和 dd() 方法来打印字符串和数组的内容，使用方式类似于PHP原生函数，非常方便。

四、结语

在Laravel开发过程中，由于各种原因，总会出现各种各样的报错信息。如何高效地排查并解决这些错误，是每个开发者必须面对的问题。本文中我们介绍了Laravel日志记录、异常处理、错误调试等几个常用的排查方式，希望对您在Laravel中开发有所帮助。

以上是laravel报错怎么排查的详细内容。更多信息请关注PHP中文网其他相关文章！