label84 / laravel-logviewer
此包已被废弃,不再维护。没有建议的替代包。
为您的 Laravel 应用程序提供简单的日志查看器。
v3.1.0
2022-08-29 11:35 UTC
Requires
- php: ^8.0
- illuminate/routing: ^8.0|^9.0
- illuminate/support: ^8.0|^9.0
Requires (Dev)
- league/factory-muffin: ^3.3
- league/factory-muffin-faker: ^2.3
- nunomaduro/larastan: ^2.0
- orchestra/testbench: ^6.0|^7.0
- phpunit/phpunit: ^9.5
README
警告
此包不再维护。
我们已决定停止维护此包。我们不再使用此包,也没有时间维护它。
请随意fork我们的代码,并将其适应您的需求。
Laravel LogViewer
LogViewer 允许您在浏览器中查看和过滤 Laravel 日志。
Laravel 支持
| 版本 | 发布 |
|---|---|
| 10.x | ^3.0 |
| 9.x | ^3.0 |
| 8.x | ^2.1 |
安装
1. 需求包
将包添加到您的应用程序中。
composer require label84/laravel-logviewer
您还可以手动更新您的 composer.json。
2. 发布配置文件
将配置文件添加到您的应用程序中。
php artisan vendor:publish --provider="Label84\LogViewer\LogViewerServiceProvider" --tag="config"
2.1 发布视图(可选)
要更改默认视图,可以将视图发布到您的应用程序中。
php artisan vendor:publish --provider="Label84\LogViewer\LogViewerServiceProvider" --tag="views"
用法
在您的应用程序中访问以下 URL: /admin/logviewer
您可以在配置文件中更改 URL。
查询过滤器
您可以使用查询参数在概览中过滤日志 - 例如 /admin/logviewer?date=today&message=kiss。
| 参数 | 值 | 示例 |
|---|---|---|
| level= | 字符串 | DEBUG |
| date= | Carbon | today |
| from= | Carbon | yesterday |
| till= | Carbon | 2021-01-01 |
| logger= | 字符串 | local |
| message= | 字符串 | love |
设置
要将在您的自己的控制器中使用此包,您可以使用以下设置。如果您使用默认包功能和视图,您可能不需要这些设置。
1. 设置通道
动态设置通道
use LogViewer; LogViewer::setChannel(string $channel);
2. 设置路径
动态设置路径
use LogViewer; LogViewer::setPath(string $path);
3. 设置文件
动态设置文件
use LogViewer; LogViewer::setFile(string $file);
4. 可用方法
LogViewerCollection 扩展了 Illuminate\Support\Collection 并提供了以下方法
- whereLevel(int|string $level)
- whereMinLevel(int|string $level)
- whereMaxLevel(int|string $level)
- whereDate(Carbon|string $date)
- whereDateFrom(Carbon|string $date)
- whereDateTill(Carbon|string $date)
- whereDateBetween(Carbon|string $startDate, Carbon|string $endDate)
- whereLogger(string|array $logger)
- whereMessage(string|array $query)
- whereNotMessage(string|array $query)
- whereUser(int $user)
示例
示例 1
列出所有日志。
use LogViewer; public function index(Request $request): View { $items = LogViewer::logs()->paginate(50); return view('dashboard', compact('items')); }
示例 2
列出今天创建的,级别至少为 ERROR 的所有日志。
use Label84\LogViewer\Support\LogViewerLevel; use LogViewer; public function index(Request $request): View { $items = LogViewer::logs() ->whereDate(today()) ->whereMinLevel(LogViewerLevel::ERROR) ->paginate(50); return view('dashboard', compact('items')); }
示例 3
列出级别至少为 DEBUG 且包含单词 'Foo' 和/或 'Bar' 的所有日志。
use Label84\LogViewer\Support\LogViewerLevel; use LogViewer; public function index(Request $request): View { $items = LogViewer::logs() ->whereLevel(LogViewerLevel::DEBUG) ->whereMessage(['Foo', 'Bar']) ->paginate(50); return view('dashboard', compact('items')); }
级别
| 级别 | |
|---|---|
| 紧急 | 600 |
| 警报 | 550 |
| 关键 | 500 |
| 错误 | 400 |
| 警告 | 300 |
| 通知 | 250 |
| 信息 | 200 |
| 调试 | 100 |
测试
composer analyse
composer test
