ThinkPHP如何实现多驱动日志记录_自定义Log驱动开发技巧-ThinkPHP-PHP中文网

thinkphp 6 的 log.channel 配置不生效，因自定义驱动需通过 log::extend() 显式注册且须在日志实例创建前完成；未注册则报 channel not exists 错误。

thinkphp如何实现多驱动日志记录_自定义log驱动开发技巧

ThinkPHP 6 的 `log.channel` 配置不生效？先确认驱动注册方式

ThinkPHP 6 日志系统默认只加载 file 驱动，即使你在 config/log.php 里写了多个 channel，没显式注册就不会被识别。自定义驱动必须通过 Log::extend() 注册，且要在日志实例创建前完成——通常放在 app/common.php 或服务提供者中。

常见错误是把 Log::extend() 写在控制器或中间件里，此时日志门面已初始化，扩展无效，调用时直接报 Channel not exists 错误。

Log::extend('mysql', function($config){ return new MysqlLogDriver($config); }); 必须早于首次调用 Log::channel('mysql')
配置文件中的 default 值只影响未指定 channel 的日志，默认仍是 file，不会自动启用你写的 mysql
若使用 Swoole 或常驻进程，需注意驱动实例是否被复用，避免连接泄漏（如 MySQL 连接未释放）

写自定义 Log 驱动时，`save()` 方法的参数和返回值有硬性约定

ThinkPHP 日志驱动必须实现 think\log\driver\Driver 接口，核心是 save() 方法。它接收一个 $log 数组（含 level、message、time、type 等字段），**必须返回 bool** ——返回 false 会被框架认为写入失败并抛出异常。

容易踩的坑是：在数据库驱动里执行 Db::insert() 后没检查结果，或用了异步写入（如协程/队列）却直接返回 true，导致日志“看似成功”实则丢失。

$log['message'] 是格式化后的完整字符串，已包含上下文和换行，不要二次 print_r 或 json_encode
$log['time'] 是时间戳，不是日期字符串，入库时别直接塞进 DATETIME 字段而不转换
若驱动依赖外部服务（如 Elasticsearch），save() 内应有超时控制和降级逻辑，否则一次网络抖动会让整个请求卡住

多 channel 同时写入时，`Log::write()` 和 `Log::channel()->write()` 行为不同

直接调用 Log::write() 永远走默认 channel（通常是 file），哪怕你在配置里设了 'default' => 'combined'；而 Log::channel('mysql')->write() 才会触发对应驱动的 save()。想让某条日志同时写进文件和数据库，不能靠配置“联动”，得手动调两次。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

性能上，同步多写会显著拖慢响应——比如一条错误日志同时写文件+MySQL+Redis，耗时是三者之和。生产环境慎用。

推荐用「主写 file + 定时脚本导入其他存储」替代实时多写
如果真要多写，封装一个 MultiChannelLogger 类，在 save() 里并发调用各驱动的 save()，但需自行处理部分失败的情况
Log::channel('xxx')->close() 不会关闭底层连接，只是标记该 channel 实例不再接受新日志，连接释放得在驱动内部自己控制

升级到 ThinkPHP 6.3+ 后，`think\log\driver\File` 的 `path` 配置路径解析变了

6.3 开始，File 驱动对 path 配置做了安全加固：不再自动补全 runtime/log/ 前缀，且禁止相对路径回溯（如 ../../etc/passwd）。如果你的自定义驱动继承了 File 并重写了 __construct()，可能因路径拼接逻辑失效导致日志写到错位置甚至失败。

典型现象是日志文件生成在 public/ 下，或者报 Permission denied 却找不到原因。