sirajunnasihin/filament-exceptions

为 FilamentPHP 管理面板提供的简单且美观的插件式异常查看器

2.1.2 2024-05-19 01:38 UTC

This package is auto-updated.

Last update: 2024-09-19 02:28:54 UTC


README

filament-exceptions-art

FILAMENT 8.x Packagist Tests Passing Code Style Passing Downloads

Filament 异常查看器

这是从 bezhansalleh/filament-exceptions 分支的

我只更新了访问过滤器,以保护非超级管理员对导航注册的访问

为 FilamentPHP 管理面板提供的简单且美观的异常查看器

  • 对于 FilamentPHP 2.x,使用 1.x 版本

安装

  1. 您可以通过 composer 安装此包
composer require sirajunnasihin/filament-exceptions
  1. 通过以下方式发布和运行迁移
php artisan exceptions:install
  1. 为 Filament 面板注册插件
public function panel(Panel $panel): Panel
{
    return $panel
        ->plugins([
            \BezhanSalleh\FilamentExceptions\FilamentExceptionsPlugin::make()
        ]);
}
  1. 通过以下方式编辑您的应用程序异常处理程序以激活插件
<?php

namespace App\Exceptions;

use BezhanSalleh\FilamentExceptions\FilamentExceptions;

class Handler extends ExceptionHandler
{
    ...

    public function register()
    {
        $this->reportable(function (Throwable $e) {
            if ($this->shouldReport($e)) {
                FilamentExceptions::report($e);
            }
        });

        ...
    }

配置

配置文件 filament-exceptions.php 将自动发布到您的配置目录。

配置文件为您提供了多个选项来自定义插件。

默认情况下,插件不对导航注册进行权限检查,要启用更改此配置

    'can_access' => [
        'role' => [],
    ],

大量修剪

默认情况下,Filament 异常配置为修剪超过 1 周的异常。

要修改您希望存储记录的时间长度,您可以提供如下所示的 Carbon 对象

'period' => now()->subWeek(), // 1 week
'period' => now()->subDay(), // 1 day
'period' => now()->subDays(3), // 3 days

注意 这需要设置并配置 Laravel 调度器才能正常工作。您可以在以下位置查看如何操作 运行调度器

自定义异常模型

对于需要更改模型的人,这可以通过配置文件来实现。

    'exception_model' => Exception::class,

创建您的新异常模型时,应扩展默认模型

<?php

namespace App\Models;

use BezhanSalleh\FilamentExceptions\Models\Exception as BaseException;

class Exception extends BaseException
{

}

主题

默认情况下,插件使用 Filamentphp 的默认主题,但如果您正在使用自定义主题,则将插件的视图路径包含在 tailwind.config.js 文件的内容数组中

export default {
    content: [
        // ...
        './vendor/bezhansalleh/filament-exceptions/resources/views/**/*.blade.php', // Language Switch Views
    ],
    // ...
}

翻译

使用以下方式发布翻译

php artisan vendor:publish --tag=filament-exceptions-translations

测试

composer test

更新日志

有关最近更改的更多信息,请参阅 更新日志

贡献

请参阅 贡献指南 了解详细信息。

安全漏洞

请查阅 我们的安全策略 了解如何报告安全漏洞。

鸣谢

许可证

MIT 许可证 (MIT)。有关更多信息,请参阅 许可证文件