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

发布时间:2026/10/24 11:54:58

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),仅供参考
延伸阅读

更多相关文章

2026/10/24 12:59:10

PRML中文版阅读指南:四大主线与最小复现单元

简介:《模式识别和机器学习》中文版(俗称「花书」)是机器学习领域的经典教材,由Chris Bishop撰写,面向具备高等数学与概率统计基础的初学者、研究生及科研人员,帮助读者跨越英文阅读门槛,系统掌…

2026/10/23 22:56:35

金融AI落地指南:从调研报告到技术选型与工程实践

简介:这份PDF报告聚焦2025年金融服务业中国AI现状与趋势,面向金融科技从业者、AI战略规划人员及关注行业数字化转型的研究者,帮助读者把握生成式AI在银行、支付、交易等场景中的落地路径与投资方向。资源包内含1个PDF文件,大小约1…

2026/10/24 0:02:40

MATLAB缩进快捷键与批量格式化实战指南

1. 被自动缩进折磨的那些年如果你写过MATLAB代码,大概率经历过这种场景:从某个文档、网页或者聊天记录里复制了一段代码,粘贴进编辑器之后,每一行前面都带着莫名其妙的空格,有的行首是四个空格,有的是一个T…

2026/10/24 0:02:40

用Poco实现Qt风格信号与槽的跨平台C++方案

简介:本资源是一份面向C中级开发者的技术实践工程,聚焦于在非Qt框架环境下模拟实现Qt核心通信机制——信号与槽,借助Poco网络库的事件系统完成解耦式对象通信。适用于需在跨平台C项目中引入松耦合回调机制、但受限于无法集成Qt依赖的开发场景…

2026/10/24 0:02:40

ESXi裸机虚拟化安装指南:从硬件兼容到虚拟机部署

1. 为什么还要折腾ESXi:从一台闲置机器说起手里攒了几台淘汰下来的迷你主机,配置不算差,i5加16G内存,扔了可惜,装个桌面系统又觉得浪费。这种场景下,ESXi就成了一个绕不开的选择。它是一套裸机虚拟化平台&a…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑