ThinkPHP怎么配置自定义日志处理器_ThinkPHP异步写入日志方法【方法】-ThinkPHP-PHP中文网

thinkphp 6 注册自定义日志处理器需实现 loggerinterface 并在容器中绑定，不可在 config/log.php 中直接配置类名；真异步须用 swoole process 而非队列，且需透传 trace_id 等上下文避免日志失真。

thinkphp怎么配置自定义日志处理器_thinkphp异步写入日志方法【方法】

ThinkPHP 6 如何注册自定义日志处理器

ThinkPHP 6 默认使用 think\log\driver\File，但不支持直接替换为异步写入逻辑；必须通过实现 think\log\LoggerInterface 并在容器中绑定才能生效。

常见错误是试图在 config/log.php 中直接填类名字符串（如 'type' => 'AsyncFile'），这会触发 ClassNotFoundException —— 因为框架只内置了 file、socket、error_log 等有限类型，不识别自定义类名。

正确做法：在 app/provider.php 或服务提供者中调用 Container::getInstance()->bind(LoggerInterface::class, AsyncLogger::class)
自定义处理器类必须实现 write() 方法，接收 $level、$message、$context 三个参数
不要在 write() 内做阻塞操作（如同步 file_put_contents），否则仍会拖慢请求

用 Swoole Process 实现真正异步日志写入

仅靠「把日志内容推到队列再另起进程处理」不算真异步——TP 请求线程仍需等待队列推送完成。Swoole 的 Process 才能脱离 HTTP 生命周期。

关键点在于：主进程 fork 出守护子进程，通过 pipe 或 table 接收日志数据，自身不阻塞。

在 server.php 或命令行启动脚本中创建 Swoole\Process，调用 start() 后立即 detach()
主进程用 process->write() 发送日志，子进程用 process->read() 持续消费
避免在子进程中使用 Log::write()，防止递归调用触发死锁或内存泄漏
子进程需手动处理 SIGTERM 信号，确保平滑退出时 flush 缓存日志

示例片段（子进程核心逻辑）：

btpanel phpsite 宝塔面板PHP网站

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

下载

$process = new Swoole\Process(function ($process) {
    while ($data = $process->read()) {
        [$level, $msg] = json_decode($data, true);
        file_put_contents(RUNTIME_PATH . 'log/async_' . date('Y-m-d') . '.log', 
            date('Y-m-d H:i:s') . " [{$level}] {$msg}\n", FILE_APPEND);
    }
});

为什么不能直接用 think-queue + Redis 做日志异步

表面上可行，实际在高并发下容易丢日志或严重延迟，原因很实在：

TP 的 Log::write() 是同步调用，即使你封装成 Job，也得等 dispatch() 完成才返回，而 Redis LPUSH 在网络抖动时可能耗时几十毫秒
队列消费者若挂掉，日志就卡在 Redis 中，无人消费，且 TP 日志系统无重试机制
Redis 内存占用不可控：突发流量下日志堆积，可能触发 OOM 或被驱逐
日志时间戳变成「入队时间」而非「记录时间」，排查问题时时间线错乱