endritvs/user-logs

使用此包轻松跟踪用户日志,同时也易于集成到所有Laravel项目中。

1.0.0 2023-09-28 20:50 UTC

This package is auto-updated.

Last update: 2024-10-01 17:29:21 UTC


README

endritvs/user-logs 包为Laravel应用程序提供了一种强大的解决方案,可以轻松跟踪和记录用户活动。通过简单的设置,维护用户交互的日志,以便为调试、监控或审计获得宝贵的见解。

Latest Version on Packagist

功能

  • 🌟 无缝集成:只需插入、播放并跟踪!与现有Laravel应用程序无缝集成。
  • 📂 有序日志:按用户ID组织日志,提供对每个用户操作的清晰可见性。
  • 🛠 可定制:根据您的独特需求调整或扩展默认行为。
  • 🚀 性能优化:设计时考虑最小开销,以确保应用程序性能流畅。

安装

  1. 获取包

    通过Composer安装

    composer require endritvs/user-logs:^dev-main
  2. 配置中间件

    将中间件注册到您的应用程序中。首先,将其添加到您的 app/Http/Kernel.php 文件中的 $routeMiddleware 属性

    protected $routeMiddleware = [
        // ... other middleware ...
        'track.user.log' => \Endritvs\UserLogs\Middleware\TrackUserLogMiddleware::class,
    ];

    现在,您可以在路由文件中使用 track.user.log 中间件将其应用于单个路由或路由组,并且它将记录用户访问的所有路由

    Route::middleware('track.user.log')->group(function () {
        // ... your routes ...
    });
  3. 配置日志通道

    config/logging.php 中注册自定义日志通道

    'user_logs' => [
        'driver' => 'custom',
        'via' => Endritvs\UserLogs\TrackUserLog::class,
    ]
  4. 如需更多信息 - 可选

    您还可以使用Laravel的本地日志系统来记录用户活动

    Log::channel('user_logs')->info('User performed a specific action.');

    默认情况下,日志位于 storage/logs/user_logs。它们按用户ID和相应的控制器操作排序。

贡献

我们欢迎贡献!如果您发现错误、有功能建议或可以增强当前功能,请发送拉取请求。

许可

此包遵循MIT许可证。有关详细信息,请参阅LICENSE 文件。