weiaibaicai/dcat-exception-reporter

Dcat Admin Extension 异常报告扩展

2.0.0 2022-11-03 09:23 UTC

This package is auto-updated.

Last update: 2024-03-30 00:24:32 UTC


README

依赖

  • 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)的指导