ThinkPHP多通道日志必须在config/log.php的'channels'中显式声明，禁用default通道防冗余，通过中间件早期切换、stack驱动多写入、SQL专用通道绑定Db监听实现业务隔离。
如果您在ThinkPHP项目中需要将不同业务类型或模块的日志写入独立文件，但发现所有日志仍混入runtime/log/下的默认文件，则说明LogChannel通道未被正确配置或未显式启用。以下是实现LogChannel多通道灵活配置的具体步骤：
一、在config/log.php中显式声明全部自定义通道
ThinkPHP 8及5.1+版本要求所有自定义通道必须在config/log.php的channels数组中静态注册，动态调用Log::extend()不可靠，尤其在Swoole常驻进程或CLI模式下易失效。未在此处声明的通道名（如'admin'、'pay'）调用时会静默降级至default通道。
1、打开项目根目录下的config/log.php文件。
2、定位到'channels' => []数组，在其中添加所需通道配置，例如：
立即学习“PHP免费学习笔记（深入）”；
3、为后台模块配置独立通道：'admin' => ['type' => 'file', 'path' => runtime_path('log/admin/') . '/', 'level' => ['info', 'error'], 'max_files' => 30]。
4、为支付回调配置专用通道：'pay' => ['type' => 'single', 'path' => runtime_path('log/pay/') . '/', 'filename' => 'pay.log', 'level' => ['info', 'error']。
5、确保每个path值以斜杠/结尾，且使用runtime_path()函数生成绝对路径，避免相对路径因执行环境差异导致失败。
二、禁用默认通道防止日志冗余写入
若不关闭默认通道，日志可能同时写入default和自定义通道，造成重复记录与磁盘压力。禁用方式不是删除default键，而是将其level设为空数组或切换为无效驱动，确保仅目标通道生效。
1、在config/log.php的'default'通道配置中，将'level'设为[]：'level' => []。
2、或修改'type'为不存在的驱动名（如'type' => 'null'），使默认通道初始化失败。
3、验证是否生效：在控制器中执行Log::channel('default')->info('test')，确认该日志未出现在任何文件中。
三、通过中间件在请求早期动态切换通道
直接在控制器中调用Log::channel()存在风险——框架早期（如路由解析、异常捕获）已触发日志，此时模块上下文尚未建立。必须在生命周期极早阶段介入，确保全请求链路日志归属准确。
1、创建中间件app\common\middleware\InitLogChannel.php。
2、在handle()方法中获取当前模块：$module = $request->module() ?: 'default'。
3、拼接通道名并切换：Log::channel($module)，注意此操作仅影响后续日志调用。
4、将该中间件注册为全局中间件，并设置优先级为-100，确保其在LoadLangPack等内置中间件之前执行。
四、使用stack驱动实现单条日志多通道写入
当需将同一条日志同时记录到多个目标（如既进pay.log又进error.log），不应手动调用多次Log::channel()->xxx()，而应使用stack驱动统一调度，避免并发写冲突与逻辑耦合。
1、在config/log.php的channels中新增stack通道：'combined_pay' => ['type' => 'stack', 'channels' => ['pay', 'error_file']]。
2、确保'pay'与'error_file'已在同一文件中预先声明。
3、在业务代码中统一调用：Log::channel('combined_pay')->info('order processed')。
4、注意stack驱动会按channels数组顺序依次写入，任一通道失败不影响其余通道，但整体性能略低于单通道。
五、为SQL等特殊日志类型配置专用通道
数据库SQL日志需独立于普通业务日志管理，不能依赖apart_level自动分离，因其受app_debug控制且不经过level过滤。必须绑定专属通道并通过Db监听机制注入。
1、在config/log.php中声明sql通道：'sql' => ['type' => 'file', 'path' => runtime_path('log/sql/') . '/', 'level' => ['sql'], 'max_files' => 15]。
2、在数据库连接配置（如database.php）中启用SQL日志钩子：'trigger_sql' => true。
3、在应用初始化位置（如app/common.php）添加Db监听器：Db::listen(function ($sql, $time, $explain) { Log::channel('sql')->info("[{$time}ms] {$sql}"); });。
4、确保runtime/log/sql/目录存在且PHP进程有写权限，ThinkPHP不会自动递归创建多级目录。
