You need to enable JavaScript to run this app. Laravel 如何使用Laravel Logger实现按用户ID与日期生成自定义日志文件
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.02 16:36:07