Laravel 如何使用Laravel Logger实现按用户ID与日期生成自定义日志文件
Laravel自定义分用户/按日期存储操作日志实现方案
核心实现逻辑
基于Laravel内置的Monolog自定义扩展机制实现,不需要引入第三方依赖,即可完成动态拼接文件名、指定存储路径的需求。
第一步:配置自定义日志通道
打开config/logging.php,在channels数组中新增独立的用户操作日志通道,原有系统日志配置不做改动:
'channels' => [ // 原有stack、single等系统日志配置保持不变 'user_activity' => [ 'driver' => 'custom', 'via' => \App\Logging\UserActivityLogger::class, 'path' => storage_path('log'), // 严格匹配要求的storage/log/存储目录 ], ],
第二步:创建自定义日志处理类
在app/Logging/目录下新建UserActivityLogger.php,实现动态获取当前登录用户、按规则拼接文件名的逻辑:
<?php namespace App\Logging; use Monolog\Handler\StreamHandler; use Monolog\Logger; use Illuminate\Support\Facades\Auth; class UserActivityLogger { public function __invoke(array $config): Logger { // 兜底处理未登录场景的标识 $userIdentity = Auth::check() ? Auth::id() : 'guest'; // 严格按要求拼接文件名格式:用户标识_日_月_年.log,匹配示例26_02_2021 $datePart = now()->format('d_m_Y'); $logFileName = "{$userIdentity}_{$datePart}.log"; $fullLogPath = rtrim($config['path'], '/') . '/' . $logFileName; // 自动创建存储目录,避免路径不存在时报错 if (!is_dir(dirname($fullLogPath))) { mkdir(dirname($fullLogPath), 0755, true); } // 初始化日志实例,设置写入等级 $logger = new Logger('user_activity'); $handler = new StreamHandler( $fullLogPath, config('logging.level', 'debug') ); // 自定义日志输出格式,可按需调整 $handler->setFormatter(new \Monolog\Formatter\LineFormatter( "[%datetime%] %level_name%: %message% | 上下文: %context%\n" )); $logger->pushHandler($handler); return $logger; } }
第三步:业务中调用日志记录
在需要跟踪用户操作的位置,指定使用自定义通道记录日志即可,不需要额外封装:
// 示例:记录用户更新资料的操作 \Log::channel('user_activity')->info('更新个人资料', [ 'client_ip' => request()->ip(), 'request_route' => request()->path(), 'modify_fields' => ['nickname', 'avatar'] ]);
实际落地的注意事项
- 禁止在
config/logging.php配置阶段直接获取Auth用户信息,配置文件是应用启动阶段缓存加载的,此时请求上下文还未初始化,获取到的用户值永远为空 - 如果使用非默认的认证Guard(比如admin后台、API接口的独立Guard),需要在获取用户标识时指定对应Guard实例,避免用户取值错误
- 队列任务、计划任务中没有HTTP请求上下文,无法自动获取Auth用户,需要在任务执行时主动传入用户标识,否则日志会被归类到
guest用户的文件中 - 文件名占位符中的
{Auth::user()->}不能直接拼接整个用户模型对象,实际落地时需取用户的唯一属性(比如用户ID、登录用户名)作为文件前缀,否则会触发类型转换报错 - 调整完日志配置后,需要执行
php artisan config:clear清除配置缓存,否则自定义通道不会生效
内容的提问来源于stack exchange,提问作者B L Praveen
相关产品推荐
相关产品推荐

