如何使用ThinkPHP Log的single模式将特定日志独立记录至单独文件？

本文共计966个文字，预计阅读时间需要4分钟。

ThinkPHP的`single`配置并非让日志不按日期分区文件的终结方案——它仅控制是否合并到一个文件，而不控制目录路径**。若要将支付日志单独落在`runtime/log/pay/`下，配置为`single=true`即可。

single=true 为什么没把日志写进你指定的目录？

因为 single 只影响“是否拆分日期子文件”，它不接管路径逻辑。ThinkPHP 默认会 fallback 到全局 log.path（通常是 runtime/log/），哪怕你在 channel 里写了 path，如果没显式声明该 channel 的 path，就会被忽略。

• single => true 时，日志写入 single.log，但这个文件仍落在 path 指向的目录下
• 若 channel 中未定义 path，系统会用默认 log.path，而不是自动拼接 runtime/log/your-channel-name/
• 即使你改了 filename（比如设成 'pay.log'），只要 path 没配，它还是在 runtime/log/ 下，和其它日志混着

如何真正隔离支付日志到 runtime/log/pay/ 目录？

必须在 log.php 的 channels 里定义一个独立 channel，并完整配置 path + single + type：

return [ 'default' => 'file', 'channels' => [ 'pay' => [ 'type' => 'File', 'path' => runtime_path() . 'log' . DIRECTORY_SEPARATOR . 'pay' . DIRECTORY_SEPARATOR, 'single'=> true, 'apart_level' => [], 'file_size' => 1024 * 1024 * 5, // 5MB ], ], ];

• path 值末尾一定要加 DIRECTORY_SEPARATOR（即 / 或 \），否则 ThinkPHP 可能拼错路径，导致日志写入失败或写到上层目录
• 目录需手动创建或确保运行用户有写权限；runtime/log/pay/ 不会自动创建
• 不要依赖 filename 字段来“命名通道”，ThinkPHP 的 File 驱动在 single => true 时固定用 single.log，改 filename 无效

怎么在代码里调用这个 pay 通道写日志？

不能直接用 Log::write()，它走的是默认 channel；必须用 Log::channel() 显式切换：

立即学习“PHP免费学习笔记（深入）”；

Log::channel('pay')->info('订单ID: 123456 支付开始'); Log::channel('pay')->error('微信回调验签失败：签名错误');

• Log::channel('pay') 返回的是一个独立日志实例，后续所有 ->info()、->error() 都只写入 runtime/log/pay/single.log
• 不要混用 Log::record() 和 Log::channel()，前者始终走默认通道；record() 不支持 channel 切换
• 如果用了 realtime_write => true，注意高并发下 I/O 压力，生产环境建议保持 false（靠请求结束自动 save）

为什么不用 Monolog 或自定义 Handler？

对于单业务线隔离（如支付、短信、风控），原生 File + channel + path 已足够轻量稳定。Monolog 虽灵活，但引入额外依赖、增加启动开销，且 ThinkPHP 6+ 的 channel 机制已覆盖绝大多数隔离需求。真正需要 Monolog 的场景是：日志要同时推送到 ES + 邮件 + Slack，或者要做结构化 JSON 输出并带上下文变量——这些都不是 single 模式要解决的问题。

最易被忽略的一点：ThinkPHP 的 path 配置值必须是**绝对路径**，且结尾带斜杠；相对路径、漏掉斜杠、用字符串拼接未转义反斜杠（Windows），都会导致日志静默丢失——查不到文件，也看不到报错。