如何通过ThinkPHP自定义日志记录，调试复杂业务流程中的日志文件？

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

在默认情况下，ThinkPHP的日志可能仅记录错误，或者根本未写入文件——这不是代码错误，而是配置未开启。关键在于 `log.type` 和 `log.level`。

常见错误现象：Log::info('test') 没反应、日志目录空、runtime/log/ 下只有日期文件夹但无内容。

• log.type 必须设为 File（大小写敏感），设成 test 或留空会静默失败
• log.level 默认是 ['error', 'notice']，info 和 debug 不会写入，要手动加进去
• 确保 runtime/log/ 目录可写，且父目录 runtime/ 存在（TP 不会自动创建多级目录）

记录业务流程时用 Log::record() 还是 Log::info()？

别用 Log::record() —— 它是内部方法，只在框架核心流程中被调用，外部调用无效，且文档已标记为“不推荐”。真正该用的是 Log::info()、Log::debug() 等标准接口。

使用场景：下单流程分步骤调试、支付回调链路追踪、多服务协同状态记录。

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

• 用 Log::debug() 记录变量值、中间状态，比如 Log::debug('order_id: ' . $order->id)
• 用 Log::info() 标记关键节点，如 Log::info('payment callback received')
• 避免在循环里高频打日志（如每条订单都 Log::info()），会拖慢响应；改用拼接字符串 + 单次写入

自定义日志通道写入独立文件（如 business.log）

直接往 runtime/log/ 下塞新文件？不行。ThinkPHP 要求所有日志通道必须预先在配置中声明，否则 Log::channel('business')->info() 会报错 Channel not exists。

参数差异：自定义通道不继承全局 log.level，需单独指定；也不走默认的日期分文件逻辑，得靠 file_format 控制。

• 在 config/log.php 中新增通道配置，键名即 channel 名，例如：'business' => ['type' => 'File', 'path' => runtime_path() . 'log/business/', 'file_format' => '{Y-m-d}.log']
• path 值末尾必须带 /，否则文件会生成在 runtime/log/business（无后缀）而非 business/ 目录下
• 首次写入前，确保 runtime/log/business/ 目录存在且可写，TP 不会自动创建它

日志内容含敏感信息？别依赖运行时过滤

很多人想在 Log::info() 前做 str_replace(['password', 'token'], '***', $data)，但容易漏字段、破坏 JSON 结构，还可能误删业务关键词。

更可靠的做法是利用 ThinkPHP 的日志处理器（processor）机制，在写入前统一脱敏。

• 写一个匿名函数作为 processor，放在通道配置里：'processor' => function($data) { return json_encode(array_map(function($v) { return is_string($v) && preg_match('/(token|key|pwd|pass)/i', $v) ? '***' : $v; }, $data)); }
• 注意：这个函数接收的是原始日志数组（含 level, message, context），不是最终字符串，别直接对 $data 做 json_encode 后再塞回去
• 脱敏逻辑不能太重，否则影响请求性能；密码类字段建议在业务层就处理，日志只存 ID 或摘要

复杂点在于：不同业务流程的日志结构不一致，有的传数组，有的传字符串，有的带 trace。没做统一封装的话，context 里的数据很容易裸奔进文件。