thinkphp 8 自定义日志通道必须在 config/log.php 的 'channels' 中显式声明，动态注册（如 log::extend()）不可靠；路径需以 / 结尾且确保写权限；各通道 level 独立生效；多通道写入推荐 stack 驱动但需警惕性能与容错风险。
ThinkPHP 8 自定义日志通道必须改 config/log.php
不改这个文件，光在控制器里调用 Log::channel() 是没用的——通道根本没注册进去。ThinkPHP 日志系统启动时只读一次配置，后续动态注册通道（比如用 Log::extend()）在 CLI 或 FPM 长生命周期下容易失效或错乱。
常见错误现象：Log::channel('pay')->info('xxx') 没输出、日志仍写进 runtime/log/202405/xxx.log 而非预期的 pay.log；或者报错 Channel [pay] is not exists。
- 所有自定义通道必须在
config/log.php的'channels'数组里显式声明 - 不要在中间件或控制器里用
Log::extend()动态注册——它不保证全局可用，尤其在多请求复用进程的 Swoole 场景下会丢通道 - 通道名（如
'pay'）需全小写、无符号，避免和内置通道（'default','error'）冲突
按业务分日志文件：用 single 驱动 + path 指向独立路径
想让支付日志单独写进 runtime/log/pay/，不能只改 filename，得配 path——否则还是落到默认 runtime/log/ 下，只是文件名不同，目录结构没隔离，查日志时依然混在一起。
示例配置（加在 config/log.php 的 'channels' 里）：
'pay' => [
'type' => 'single',
'path' => runtime_path() . 'log/pay/',
'filename' => 'pay.log',
'max_files' => 30,
'level' => 'info',
],
-
path值必须以/结尾，否则 ThinkPHP 会拼错路径（比如写成runtime/log/pay_pay.log） -
runtime_path()返回带末尾/的字符串，所以path拼接时别重复加斜杠 - 确保该目录有写权限，否则日志静默失败（不会报错，但文件就是不生成）
日志级别控制要设在通道层，不是全局 level
全局 'level' => 'error' 不会限制你自定义通道的输出粒度——'pay' 通道设成 'info'，它就真能记 info；设成 'debug'，哪怕全局是 error 也照记不误。这点常被误解，结果发现 debug 日志满天飞，还以为是全局配置没生效。
- 每个通道的
level独立生效，互不影响 - 生产环境慎用
'debug'，尤其对高频操作（如订单回调），I/O 和磁盘压力会明显上升 - 如果某通道只想记录错误，直接设
'level' => 'error'，别依赖代码里手动判断if ($e) Log::channel('xxx')->error(...)
多通道同时写入：用 stack 驱动，但注意性能损耗
需要一条日志既进 pay.log 又进 error.log？别手写两次 Log::channel(...)->info()，用 stack 驱动更可靠。但它本质是循环写入，通道越多，延迟越明显，尤其当某个通道（比如写远程 ES）响应慢时，会拖累整个请求。
示例（将支付日志同时落本地 + 推送到 syslog）：
'pay_all' => [
'type' => 'stack',
'channels' => ['pay', 'syslog'],
'level' => 'info',
],
-
stack本身不存日志，只是调度器，真正写入由子通道完成 - 子通道里任意一个失败（如 syslog 服务宕机），默认会吞掉错误、继续执行其余通道——看起来“成功”，但可能丢数据
- 高并发场景下，避免把 DB 或 HTTP 类通道塞进 stack，I/O 成瓶颈
通道配置看似简单，但路径拼接、权限、级别作用域、stack 的隐式阻塞——这些点一旦漏掉，线上日志就变成“薛定谔的日志”：你以为它在，其实早断了。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
