在 laravel 中添加自定义日志频道需在 config/logging.php 的 'channels' 数组中新增配置项（如 'audit'），指定 type、path、level 等；调用时须显式使用 log::channel('audit')->info()；注意权限、环境配置隔离及 daily 渠道的 locking 和日志清理。
怎么在 Laravel 中添加自定义日志频道
直接改 config/logging.php，加一个新频道配置就行。Laravel 的日志系统基于 Monolog，所有自定义都围绕「channel」展开，不是改底层驱动，而是告诉框架“往哪写、怎么写”。
- 在
config/logging.php的'channels'数组里新增一项，比如叫'audit' - 类型选
'single'（文件）、'daily'（按天轮转）、'stack'（多通道聚合），别用'errorlog'或'syslog'做业务日志，权限和路径不可控 - 必须指定
'path'，比如storage_path('logs/audit.log')；如果目录不存在，Laravel 不会自动创建，会静默失败 - 可以加
'level' => 'info'控制最低记录级别，避免把 debug 日志塞进审计日志里
如何在代码里调用自定义日志频道
不用 Log::info() 这种默认通道写法，得显式指定 channel——否则日志全进 laravel.log，跟你配的频道完全无关。
- 用
Log::channel('audit')->info('User logged in')，'audit'必须和配置里的 key 完全一致 - 也可以用门面别名：在
config/app.php的'aliases'里加'AuditLog' => Illuminate\Support\Facades\Log::class，然后在代码里AuditLog::channel('audit')->info(...)，但没必要，容易混淆 - 控制器或服务类里，更推荐注入
LoggerInterface并通过createLogger('audit')获取，避免全局门面耦合 - 注意：
Log::channel('missing')->info()不会报错，只是日志丢弃——检查配置 key 拼写是最常见的排查点
为什么自定义频道不写入文件或报错 Permission denied
大概率是 storage/logs 目录权限或 SELinux 限制，而不是 Laravel 配置问题。
- 确认
storage/logs/及其子目录由 Web 服务器用户（如 www-data、nginx）可写，运行ls -ld storage/logs看 owner 和 group - 如果用了 Docker，宿主机挂载的 logs 目录权限可能被继承为 root，容器内 PHP 进程写不进去，得在启动时 chown 或用 initContainer 修复
- 某些 CentOS 机器启用了 SELinux，即使权限正确也会拦截写入，临时验证可执行
setenforce 0，长期方案是加chcon -R -t httpd_log_t storage/logs/ - Windows + WSL2 下，若 logs 目录挂载自 Windows 分区，默认无执行权限，需在
/etc/wsl.conf加metadata=true并重启
能否让不同环境用不同自定义频道
能，但别在 config/logging.php 里写 env('APP_ENV') === 'production' 这种判断——配置文件在应用启动早期加载，环境变量可能还没完全解析，尤其用了 config:cache 之后会固化成 false。
- 正确做法是利用 Laravel 的「配置覆盖」机制：在
config/logging.php里定义通用 channel，再在config/logging/{environment}.php（如production.php）中重写该 channel 的'path'或'level' - 或者用
tap闭包动态调整，比如给'audit'加'tap' => [App\Logging\CustomizeAuditLogger::class]，在类里根据app()->environment()修改处理器行为 - 切记：不要在
tap里做耗时操作（如远程 HTTP 请求），Monolog 是同步阻塞的，会影响响应时间
自定义频道最麻烦的不是配置，而是日志路径的生命周期管理——比如 daily 渠道生成的文件名带日期，但没人自动清理旧文件；又比如多个 worker 进程同时写同一个文件，得靠 Monolog 的 FlockHandler 保证原子性，而它默认只在 'single' 下启用，'daily' 要手动加 'locking' => true。
