Dcat Admin Extension 异常报告扩展

依赖

• php | >= 7.4.0
• dcat/laravel-admin | >= ~2.0

安装

composer 拉取代码

composer require weiaibaicai/dcat-exception-reporter

启用插件

后台菜单 -> 开发工具 -> 扩展 -> weiaibaicai.dcat-exception-reporter -> 升级 -> 启用

添加后台路由（routes.php）

use Weiaibaicai\DcatExceptionReporter\Http\Controllers\DcatExceptionReporterController;
use Illuminate\Support\Facades\Route;

Route::resource('weiaibaicai/exception-reporters', DcatExceptionReporterController::class);

添加后台菜单

后台菜单 -> 系统 -> 菜单 -> 新增，路径填写 weiaibaicai/exception-reporters

最后一步，触发

打开 app/Exceptions/Handler.php文件, 在 report 方法中调用 ExceptionReporterService::report()方法

<?php

namespace App\Exceptions;

...
use Weiaibaicai\DcatExceptionReporter\Services\ExceptionReporterService;

class Handler extends ExceptionHandler
{
    ...
    
    public function report($e)
    {
        if (class_exists(ExceptionReporterService::class) &&  $this->shouldReport($e)) {
            ExceptionReporterService::report(request(), $e);
        }
        parent::report($e);
    }
    
    ...
}

安装问题

1. 发布文件时可能存在权限问题，记得给足权限。可在项目根目录执行 chmod -R 755 public/vendor

使用问题

1. 如果怕数据量太大，可以定时执行命令php artisan exception-reporter:clear来清空一周以前的异常
2. 迁移默认生成的数据表名为exception_reporters，可以通过设置 config('admin.extensions.dcat_exception_reporter.table')的值来修改。如需配置，请在安装插件之前配置好
3. 禁用扩展可以实现关闭记录异常，操作 后台菜单 -> 开发工具 -> 扩展 -> weiaibaicai.dcat-exception-reporter -> 禁用

升级说明 1.x -> 2.x

1. 升级理由：1.x 版本需要主动执行迁移，发布到生产环境时不方便
2. 变动内容：实现安装扩展自动执行迁移 + 不在提供预设好的后台路由
3. 升级操作：走一遍 '添加后台路由' 步骤即可

特别感谢

1. 感谢何总（old）的指导