Laravel如何记录自定义日志？（Log频道配置）-Laravel-PHP中文网

Laravel如何记录自定义日志？（Log频道配置）

冰火之心

发布： 2025-12-15 04:51:29

原创

346人浏览过

在 Laravel 中记录自定义日志需配置独立 Log Channel，如在 config/logging.php 中新增 'payment' 频道使用 single 驱动写入 storage/logs/payment.log，并通过 Log::channel('payment')->info() 调用，支持结构化数据自动 JSON 化，可结合环境变量动态控制启用。

laravel如何记录自定义日志？（log频道配置）

在 Laravel 中记录自定义日志，核心是通过配置独立的 Log Channel（日志频道），让特定业务逻辑（比如支付回调、爬虫抓取、审计操作）写入专属文件或服务，避免和默认日志混杂，也方便后续排查和监控。

定义一个自定义日志频道

在 config/logging.php 中新增一个 channel 配置，例如叫 payment：

使用 single 驱动写入单独文件（推荐初试）
指定 path 路径，如 storage/logs/payment.log
可选开启 daily 按天轮转，或用 stack 聚合多个通道

示例配置片段：

'payment' => [
    'driver' => 'single',
    'path' => storage_path('logs/payment.log'),
    'level' => 'debug',
],

登录后复制

在代码中使用自定义频道写日志

不用改全局日志行为，直接调用 Log::channel('xxx') 获取实例后记录：

来画数字人直播

来画数字人自动化直播，无需请真人主播，即可实现24小时直播，无缝衔接各大直播平台。

查看详情

Log::channel('payment')->info('支付回调成功', ['order_id' => 123, 'amount' => 99.9]);
支持 debug/info/warning/error 等全部方法
结构化数据会自动 JSON 化写入，便于解析

进阶：按环境或需求动态切换频道

可在配置里结合环境变量控制行为，比如只在生产环境启用审计日志：

在 logging.php 中用 env('AUDIT_LOG_ENABLED', false) 判断是否注册 audit 频道
或在代码中包裹条件：if (app()->environment('production')) { Log::channel('audit')->... }