laravel-logger快速上手：5个步骤为Laravel应用加上活动日志功能

laravel-logger快速上手5个步骤为Laravel应用加上活动日志功能【免费下载链接】laravel-loggerAn out the box activity logger for your Laravel or Lumen application. Laravel logger is an activity event logger for your laravel application. It comes out the box with ready to use with dashboard to view your activity. Laravel logger can be added as a middleware or called through a trait. This package is easily configurable and customizable. Supports Laravel 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 6, and 7项目地址: https://gitcode.com/gh_mirrors/la/laravel-loggerlaravel-logger 是一个开箱即用的 Laravel / Lumen 活动日志记录器activity logger。它能自动记录用户登录、登出、页面访问等操作并提供一个现成的仪表板来查看这些活动日志。只需 5 个简单步骤就能给你的 Laravel 应用加上完整的活动日志功能。为什么需要活动日志想象一下用户反馈我的密码被重置了不是我操作的——如果没有日志你根本无从查起。laravel-logger 可以帮你记录以下信息记录内容说明登录 / 登出 / 登录失败自动监听认证事件失败登录、账号锁定、密码重置都会记录页面访问路由事件通过中间件即可开启记录 GET/POST 等操作时间戳、操作描述、详细描述支持自定义描述和扩展细节IP 地址、User Agent、浏览器语言便于排查来源和安全问题关联模型可以记录这条活动对应的数据模型和 ID爬虫检测自动识别 Crawler 访问它支持 Laravel 5.3 ~ 9 版本兼容多个主流角色权限包如 spatie/laravel-permissionMIT 协议开源免费。5个步骤快速上手 Laravel Logger步骤 1一键安装 Laravel Logger在你的项目根目录的终端中执行composer require jeremykenedy/laravel-logger✅ Laravel 5.5 及以上版本会自动发现服务提供者见 composer.json 中的extra.laravel.providers配置无需再手动修改config/app.php。Laravel 5.4 及以下版本才需要在providers数组中注册LaravelLoggerServiceProvider。步骤 2运行迁移创建日志表php artisan migrate这一步会自动创建laravel_logger_activity数据表。表结构定义在 2017_11_04_103444_create_laravel_logger_activity_table.php 中包含描述、用户类型、IP、User Agent、请求方法、时间戳等字段还支持软删除cleared 状态可查看和恢复。 提示如果你想使用独立的数据库或自定义表名请在.env文件中配置LARAVEL_LOGGER_DATABASE_CONNECTION和LARAVEL_LOGGER_DATABASE_TABLE。步骤 3给路由加上 activity 中间件这是零代码记录页面访问的关键。在routes/web.php中给路由组加上activity中间件Route::group([middleware [web, activity]], function () { Route::get(/, WelcomeControllerwelcome)-name(welcome); });中间件实现位于 LogActivity.php它会在每个请求时自动记录活动。不传描述时会根据请求方法自动生成例如GET→ viewed /pathPOST→ created /pathPUT/PATCH→ edited /pathDELETE→ deleted /path如果某些路由不想记录可以在.env中配置LARAVEL_LOGGER_MIDDLEWARE_EXCEPT/excluded,path。步骤 4用 Trait 在任意位置手动记录活动除了中间件你还可以用 Trait 在控制器或任意类中主动记录活动并自定义描述。在 ActivityLogger.php 中定义了核心方法在类头部引入use jeremykenedy\LaravelLogger\App\Http\Traits\ActivityLogger;在类中使用use ActivityLogger;调用记录ActivityLogger::activity(Logging this activity.); // 附加详细信息 ActivityLogger::activity(Logging this activity., Additional activity details.); // 关联数据模型 ActivityLogger::activity(Logging this activity., Additional details., [id 1, model App\Models\User]);这样任何业务操作如管理员删除了某篇文章都能留下清晰的审计痕迹。步骤 5打开活动日志仪表板 安装完成后登录你的应用并访问以下路由默认已注册见 web.php路由功能/activity主活动日志仪表板/activity/cleared已清除的日志列表/activity/log/{id}单条活动详情下钻报告/activity/export导出日志支持 CSV、JSON、Excel 格式仪表板还内置了搜索默认支持 description、user、method、route、ip 字段和日期筛选今天、昨天、最近 7/30 天、最近 3/6 个月等预设区间。对于百万级日志数据可开启游标分页LARAVEL_LOGGER_CURSOR_PAGINATION_ENABLEDtrue大幅提升加载速度。日志支持清空clear、恢复restore和彻底删除destroy全部基于 Eloquent 软删除实现误删也不怕。常用 .env 配置速查表 ⚙️完整配置项见 laravel-logger.php新手最常调整的就是下面几个# 数据库与表 LARAVEL_LOGGER_DATABASE_CONNECTIONmysql LARAVEL_LOGGER_DATABASE_TABLElaravel_logger_activity # 中间件开关 LARAVEL_LOGGER_MIDDLEWARE_ENABLEDtrue LARAVEL_LOGGER_MIDDLEWARE_EXCEPT # 角色权限配合 laravel-roles / spatie/laravel-permission 使用 LARAVEL_LOGGER_ROLES_ENABLEDtrue LARAVEL_LOGGER_ROLES_MIDDLWARErole:admin # 搜索 / 日期筛选 / 导出 LARAVEL_LOGGER_ENABLE_SEARCHtrue LARAVEL_LOGGER_SEARCH_FIELDSdescription,user,method,route,ip LARAVEL_LOGGER_ENABLE_DATE_FILTERINGtrue LARAVEL_LOGGER_ENABLE_EXPORTtrue # 分页 LARAVEL_LOGGER_PAGINATION_ENABLEDtrue LARAVEL_LOGGER_PAGINATION_PER_PAGE25 可选操作执行php artisan vendor:publish --tagLaravelLogger可发布视图、配置文件、静态资源和多语言文件到项目中方便深度定制。内置 de、en、fr、pt-br、tr 五种语言包。常见问题 FAQQ1Lumen 项目能用吗可以但 Lumen 安装方式不带 GUI 仪表板需要在bootstrap/app.php中手动注册服务提供者和activity路由中间件并在.env中设置LARAVEL_LOGGER_DISABLE_ROUTEStrue。Q2想自定义仪表板路由怎么办在.env中设置LARAVEL_LOGGER_DISABLE_ROUTEStrue关闭默认路由然后按照 web.php 中的定义把仪表板路由复制到你的routes/web.php里自行定制。Q3登录失败、账号锁定会自动记录吗会的。包内自带一组监听器位于 src/App/Listeners/ 目录包括LogFailedLogin、LogLockout、LogPasswordReset、LogSuccessfulLogin、LogSuccessfulLogout等开箱即用。Q4IP 下钻报告怎么获取地理位置单条活动详情页会使用 GeoPlugin 接口查询 IP 的元信息国家、城市等如需关闭可修改配置。总结只需安装 → 迁移 → 中间件 → Trait → 打开仪表板这 5 个步骤laravel-logger 就能让你的 Laravel 应用拥有完整、可搜索、可导出、可审计的活动日志系统。无论做安全排查、用户行为分析还是操作审计它都是一个简单又强大的选择。如果想深入了解功能细节可以参考项目中的 FEATURES.md 文档。【免费下载链接】laravel-loggerAn out the box activity logger for your Laravel or Lumen application. Laravel logger is an activity event logger for your laravel application. It comes out the box with ready to use with dashboard to view your activity. Laravel logger can be added as a middleware or called through a trait. This package is easily configurable and customizable. Supports Laravel 5.3, 5.4, 5.5, 5.6, 5.7, 5.8, 6, and 7项目地址: https://gitcode.com/gh_mirrors/la/laravel-logger创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考