Monolog如何在产生日志时于整段日志末尾追加附加数据

Monolog原生支持实现你描述的需求，无需使用会给每条日志重复注入参数的Processor，以下两种方案都可以满足「仅当本次请求确实产生日志、整批日志归集完成后在末尾追加全局附加数据」的要求，完全适配你提到的BufferHandler配合SwiftMailerHandler发送邮件日志的场景。

方案1：自定义带追加逻辑的BufferHandler（最适配邮件告警类场景） #

原生BufferHandler的核心作用是把请求周期内产生的日志暂存在内存中，等请求结束或者达到日志数量阈值时，再批量把整组日志交给下游handler处理。你可以继承该类重写close()方法，在批量刷出日志前判断缓冲区是否存在待处理日志，如果有就把附加数据追加到缓冲区末尾，再执行原有的刷出逻辑。

• 核心逻辑：close()方法会在PHP请求结束、对象销毁时自动触发，是天然的请求收尾钩子
• 优势：不会对单条写入的日志通道产生任何影响，仅在缓冲日志要批量输出时才追加内容，和Yii2的附加日志行为完全一致

参考实现代码：

use Monolog\Handler\BufferHandler;
use Monolog\Level;

class AppendRequestContextBufferHandler extends BufferHandler
{
    public function close(): void
    {
        // 仅当缓冲区存在待发送日志时才追加附加数据
        if (count($this->buffer) > 0) {
            $contextText = sprintf(
                "=== 请求附加调试信息 ===\nPOST参数: %s\n请求地址: %s\n请求方法: %s\n请求IP: %s",
                json_encode($_POST, JSON_UNESCAPED_UNICODE),
                $_SERVER['REQUEST_URI'] ?? 'CLI模式',
                $_SERVER['REQUEST_METHOD'] ?? 'CLI',
                $_SERVER['REMOTE_ADDR'] ?? '127.0.0.1'
            );
            // 把附加信息作为一条日志追加到缓冲区末尾
            array_push($this->buffer, $this->getRecord(Level::Error, $contextText));
        }
        parent::close();
    }
}

使用时直接把原来套在SwiftMailerHandler外层的原生BufferHandler替换成这个自定义类即可，其他业务日志写入逻辑不需要任何改动。

方案2：包装最终输出Handler，重写批量处理方法 #

如果你不想修改缓冲层逻辑，也可以直接给最终输出日志的Handler（比如SwiftMailerHandler、本地文件写入的StreamHandler）做一层包装，重写它的handleBatch()方法：

• 当上游批量传入日志数组时，先判断数组是否非空
• 如果存在待输出日志，就把你要追加的请求上下文生成一条日志记录，追加到传入的日志数组末尾
• 再调用原handler的handleBatch()方法完成整组日志的输出/发送

这个方案的适配范围更广，不管上游用什么缓冲策略，只要是批量交付给最终输出端的日志，都会统一在末尾追加附加信息，不会干扰其他单条实时写入的日志通道。

为什么不推荐用Processor实现 #

你提到的Processor缺陷完全符合实际使用情况：Processor的执行时机是单条日志处理阶段，不管是挂载在Logger实例还是单个Handler上，都会给每一条经过的日志重复注入全部请求参数，不仅会浪费日志存储空间，在整批发送邮件的场景下还会导致每一条日志条目都携带一大段重复的参数，大幅降低日志可读性，和你要的「整段日志末尾统一追加」的需求完全不匹配。

注意事项 #

如果在Swoole、Workerman等CLI常驻内存场景下使用，记得在每次请求结束后清空自定义Handler里缓存的请求相关数据，避免出现不同请求间的数据串扰；PHP-FPM场景下请求结束后进程会回收，不需要额外做清理操作。

内容的提问来源于stack exchange，提问作者Robin Schambach