ThinkPHP 8.0如何正确配置日志通道与级别【配置】

ThinkPHP 8.0 日志 level 必须为小写字符串数组，如 [‘debug’,’info’]；单字符串或大小写错误均无效，且通道需在 config/log.php 的 channels 中显式声明，type 首字母大写，path 以 / 结尾并确保目录可写。

config/log.php 里 level 必须是数组，不是字符串

写成 'level' => 'error' 或 'level' => 'debug,info,error' 都无效——ThinkPHP 8.0 只认数组。配置被忽略后，日志会按默认行为（通常是 ['error', 'warning', 'info']）写入，导致 Log::debug() 不落地、Log::info() 却意外刷屏。

• 'level' => ['debug', 'info', 'warning', 'error'] 是开发环境常用写法
• 'level' => ['error', 'critical', 'alert', 'emergency'] 是生产环境底线
• 空数组 [] 表示关闭该通道所有日志，慎用
• 级别名必须小写，'Error' 或 'INFO' 会被跳过

自定义通道必须在 config/log.php 的 channels 里显式声明

调用 Log::channel('pay')->info('xxx') 却没生成文件？大概率是 'pay' 根本没在 config/log.php 的 'channels' 数组里注册。ThinkPHP 启动时只读一次配置，运行时用 Log::extend() 注册的通道在 CLI/FPM/Swoole 下极不稳定，尤其多请求复用进程时会丢通道。

• 通道名全小写，避免和内置 'default'、'error' 冲突
• 'type' 值必须首字母大写：'File' ✅，'file' ❌（静默失败）
• 'path' 必须以 / 结尾，例如 runtime_path() . 'log/pay/'，否则路径拼接出错
• 确保目标目录存在且 PHP 进程有写权限，否则日志静默丢失（不报错）

apart_level 和 level 是两套逻辑，别混用

'apart_level' => ['sql'] 不受 level 控制，但强依赖 app_debug = true。很多人设了 apart_level 却发现 sql.log 没内容，其实是生产环境 APP_DEBUG=false 导致 SQL 日志根本没触发。

• level 是过滤器：决定哪些级别“能进通道”
• apart_level 是分流开关：把指定级别强制导出到独立文件（绕过 level 过滤）
• sql 级别只在调试模式生效，emergency、alert 等标准级别才走 level 判断
• 修改 apart_level 后，必须清空 runtime/cache/，否则旧缓存可能让配置不生效

通道级 level 优先于全局 level

全局 'level' => ['error']，但某个通道单独配了 'level' => ['debug', 'info']，那这个通道真会记 Log::debug() ——哪怕其他通道完全收不到。这是实现“支付日志记 info、错误日志只收 error”的核心机制。

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

• 未定义 level 的通道自动继承全局配置
• 通道级 level 只影响该通道，不影响其他通道或日志分发逻辑
• 不要用 Log::setLevel() 动态改——它只作用于默认通道，且对已初始化的通道无效
• 环境适配推荐写法：'level' => env('APP_DEBUG', false) ? ['debug','info','warning','error'] : ['warning','error']

实际配置生效前，务必执行 php think clear:log 清缓存；路径权限、大小写、数组结构这三处最容易漏查，问题往往不出在代码逻辑，而出在这三个地方。