新增channel需在config/logging.php的channels数组中明确定义，且LOG_CHANNEL仅影响未指定channel的默认调用；daily驱动必须显式设'lock'=>false防并发卡顿，权限0664需配合属组可写，调用须用Log::channel('name')->info()。
直接在 config/logging.php 里加新 channel 就能实现多通道日志，但多数人配完发现「日志没写进去」或「写进去了却找不到文件」——根本原因是没理解 channel 和 driver 的绑定关系，以及 LOG_CHANNEL 环境变量的优先级覆盖逻辑。
daily 驱动必须显式关掉 lock 才能扛住并发
默认 daily 驱动开启 'lock' => true，每次写日志都调用 flock()。50+ QPS 下就会卡住，strace -e trace=flock php artisan tinker 能看到大量 F_SETLK 等待。
- 务必在 channel 配置里写死
'lock' => false，别依赖默认值 - 关锁后日志行可能交错（比如两行合并成一行），只要不靠行号做日志解析（如 ELK pipeline 不依赖
line_number），这是可接受的权衡 - 如果业务强依赖顺序，改用
stack+syslog或外部服务，别硬扛文件锁
自定义 channel 必须在 channels 数组里声明，且不能只改 LOG_CHANNEL
LOG_CHANNEL=payment 只是告诉 Laravel 默认用哪个 channel，但如果你没在 config/logging.php 的 'channels' 数组里定义 'payment'，启动时会抛 InvalidArgumentException: Log driver [payment] is not defined.
- 新增 channel 示例：
'payment' => [<br> 'driver' => 'daily',<br> 'path' => storage_path('logs/payment.log'),<br> 'level' => 'debug',<br> 'days' => 14,<br> 'max_files' => 30,<br> 'lock' => false,<br> 'permission' => 0664,<br>], - 调用方式固定为
Log::channel('payment')->info(...)，不是Log::payment()->info(...) - 不要在
.env里设LOG_CHANNEL=payment后就以为全局生效了——它只影响未指定 channel 的Log::xxx()调用
formatter 里调用 Request::ip() 会导致性能雪崩
自定义 Formatter 类中每条日志都执行 Request::ip() 或 Request::fullUrl()，等于在日志路径上塞了个完整请求重建流程，开销接近一次数据库查询。
- IP、URL 这类字段，应在中间件里提前提取并存到
$request->attributes，比如：$request->attributes->set('client_ip', $request->ip()) - formatter 中只读缓存值：
$record['context']['ip'] = $request->attributes->get('client_ip') - 时间格式用
'Y-m-d H:i:s.v'，别用'c'；hostname、app name 这种静态值必须用static属性缓存，避免每次 new 都调gethostname()
stack 通道里多个子 channel 的 level 是独立生效的
很多人以为配了 'level' => 'error' 在 stack 上，整个栈就只记录 error 级别以上——其实没这回事。stack 本身不处理 level，每个子 channel 的 level 才是实际过滤点。
- 示例配置：
'stack' => [<br> 'driver' => 'stack',<br> 'channels' => ['daily', 'slack'],<br>],<br>'daily' => [<br> 'driver' => 'daily',<br> 'level' => 'debug', // 文件里记全量<br>],<br>'slack' => [<br> 'driver' => 'slack',<br> 'level' => 'critical', // Slack 只发 critical 及以上<br>],
- 所以
Log::warning('xxx')会写进 daily 文件，但不会触发 Slack 发送 - 别在
stack配置里写'level'，它会被忽略；要控制粒度，必须去每个子 channel 里设
最常被忽略的是：日志通道名大小写敏感，'Payment' 和 'payment' 是两个不同 channel；还有就是 storage/logs/ 目录权限没同步到属组，导致 permission => 0664 失效，Web 进程仍反复 chmod。
