laravel-logger安装指南：Laravel与Lumen双端安装的3个关键注意事项

laravel-logger安装指南Laravel与Lumen双端安装的3个关键注意事项【免费下载链接】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本文是一份 laravel-logger 安装指南。laravel-logger 是一款面向 Laravel 和 Lumen 应用的开箱即用活动日志包activity logger通过一行中间件即可记录用户登录、登出、登录失败、页面访问等行为并自带一个可视化的活动日志仪表盘。下面带你一步步完成双端安装并重点讲解 3 个最容易被忽略的注意事项。一、安装前先认识 laravel-logger laravel-logger 的核心能力✅自动记录认证事件登录、登出、登录失败、账号锁定、密码重置全部由内置监听器自动完成位于src/App/Listeners/目录中间件记录访问给路由加一个activity中间件即可记录页面访问内置活动仪表盘访问/activity即可查看日志支持搜索、日期筛选、导出 CSV/JSON/Excel⚙️高度可配置几乎每个功能都可以通过.env环境变量控制服务入口在src/LaravelLoggerServiceProvider.php它负责注册中间件、监听器、路由和迁移文件。二、安装前环境检查30秒搞定⏱️检查项要求PHP 版本7.3 及以上支持 8.x框架版本Laravel 5.1 ~ 9或 Lumen额外依赖jaybizzle/laravel-crawler-detect随包自动安装用于识别爬虫访问三、Laravel 安装步骤4 步完成第 1 步安装 laravel-logger 包在项目根目录的终端中运行composer require jeremykenedy/laravel-logger第 2 步注册服务提供者Laravel 5.5 及以上无需任何操作框架会自动发现并注册Laravel 5.4 及以下需要在config/app.php的providers数组中手动注册LaravelLoggerServiceProvider::class第 3 步执行数据库迁移php artisan migrate这一步会创建活动日志表默认表名为laravel_logger_activity迁移文件位于src/database/migrations/目录。第 4 步可选发布配置文件和语言包php artisan vendor:publish --tagLaravelLogger执行后配置文件、视图模板和多语言文件src/lang/下含 en、de、fr、pt-br、tr 五种语言会复制到你的项目中方便二次修改。四、Lumen 安装步骤无仪表盘版⚠️ 注意Lumen 端安装的是不含图形界面GUI的版本没有可视化仪表盘。运行composer require jeremykenedy/laravel-logger在bootstrap/app.php中手动注册两个服务提供者CrawlerDetect 和 LaravelLogger并注册activity中间件别名将配置文件对应源码中的src/config/laravel-logger.php复制到项目的config/目录在.env文件中设置LARAVEL_LOGGER_DISABLE_ROUTEStrue详见下文注意事项 3运行php artisan migrate创建活动表五、3 个关键注意事项 ⚠️注意事项 1Laravel 与 Lumen 的服务提供者注册方式完全不同这是双端安装差异最大的一点Laravel 5.5零配置包内composer.json已声明自动发现安装即可用Laravel 5.4 及以下必须手动在config/app.php中注册Lumen必须手动在bootstrap/app.php中注册而且容易漏掉LaravelCrawlerDetectServiceProvider——它是爬虫检测依赖漏注册会导致记录访客类型时报错注意事项 2忘记执行迁移日志包将完全无法工作所有活动日志都写入laravel_logger_activity表如果漏掉php artisan migrate日志写入会直接失败。好在默认配置会把写入失败的记录输出到日志文件对应src/config/laravel-logger.php中的logDBActivityLogFailuresToFile但更建议安装完成后立即访问/activity页面验证仪表盘是否正常显示。注意事项 3Lumen 安装必须禁用默认路由Lumen 端不支持包内置的仪表盘如果不禁用默认路由可能会引发路由冲突。务必在.env中设置LARAVEL_LOGGER_DISABLE_ROUTEStrue同样的开关也适用于 Laravel 项目如果你想自定义仪表盘路由比如换一个访问前缀、加上自己的权限中间件也先禁用默认路由再在自己的routes/web.php中声明。默认路由的完整写法可参考src/routes/web.php。六、安装成功后的快速使用体验 ✨方式一中间件记录页面访问在路由文件中给需要记录的路由组加上activity中间件之后每次访问都会自动写入日志中间件实现位于src/App/Http/Middleware/LogActivity.php。方式二Trait 精确记录业务事件在控制器类中引入ActivityLoggertrait位于src/App/Http/Traits/ActivityLogger.php即可在任意业务代码中主动记录一条带自定义描述的日志还能附上关联模型信息适合记录谁删除了哪篇文章这类关键操作。查看日志登录应用后访问/activity即可查看仪表盘点击某条日志可进入详情下钻页面展示 IP 元信息、用户角色、相关事件等。七、常用配置项速查表 环境变量默认值作用LARAVEL_LOGGER_DATABASE_TABLElaravel_logger_activity活动日志表名LARAVEL_LOGGER_DATABASE_CONNECTION跟随DB_CONNECTION指定日志写入的数据库连接LARAVEL_LOGGER_DISABLE_ROUTESfalse禁用内置路由Lumen 必改LARAVEL_LOGGER_MIDDLEWARE_ENABLEDtrue开关 activity 中间件LARAVEL_LOGGER_ENABLE_DATE_FILTERINGtrue仪表盘日期筛选LARAVEL_LOGGER_ENABLE_EXPORTtrue导出 CSV/JSON/ExcelLARAVEL_LOGGER_PAGINATION_PER_PAGE25每页显示条数LARAVEL_LOGGER_USER_MODELApp\Models\User自定义用户模型完整配置项及中文说明都在src/config/laravel-logger.php中按功能分块注释清晰可按需查阅。总结laravel-logger 的安装过程非常轻量Laravel 端 4 步、Lumen 端 5 步核心就是composer 安装 → 注册服务 → 跑迁移三件事。只要记住本文的 3 个关键注意事项——双端注册方式不同、迁移不能忘、Lumen 必须禁用默认路由你就能快速为项目装上一套完整的用户活动审计系统。【免费下载链接】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），仅供参考