使用PHPMailer发送邮件时如何即时获取Message-Id？

PHPMailer在执行发送流程时会自动生成符合RFC规范的Message-Id，不需要等待服务器额外返回，调用send()方法成功后可以直接从实例属性读取，完全满足邮件追踪的需求。

具体实现步骤 #

• 不需要手动给MessageID属性赋值，保持默认让PHPMailer自动生成即可，手动生成的ID如果不符合RFC规范可能会被邮件服务商拦截或者覆写。
• 必须在->send()方法执行完成且返回true（发送成功）之后，再读取实例的MessageID公共属性，注意属性名大小写敏感，ID两个字母均为大写，调用过早会拿到空值。

代码示例 #

// 初始化PHPMailer实例
$mail = new PHPMailer(true);
// 省略SMTP配置、发件人/收件人设置、邮件内容组装等常规逻辑

try {
    $mail->send();
    // 发送成功后直接读取生成的Message-Id
    $savedMessageId = $mail->MessageID;
    // 此处执行数据库入库逻辑，存储$savedMessageId用于后续发送状态追踪
} catch (Exception $e) {
    // 发送失败的错误处理逻辑
    echo "邮件发送失败，错误信息：{$mail->ErrorInfo}";
}

特殊场景兼容 #

绝大多数邮件服务商不会修改PHPMailer生成的Message-Id，上面拿到的值和后续从IMAP已发送文件夹拉取到的邮件头中的Message-Id完全一致，可以直接做匹配校验。
如果遇到极少数服务商强制覆写Message-Id的情况，可以在发送完成后读取SMTP会话日志，从服务器返回的成功应答中提取服务商生成的最终ID：

// 发送成功后获取SMTP日志
$smtpLogs = $mail->getSMTPInstance()->getLogs();
// 正则匹配250应答中返回的Message-Id
preg_match('/250.*?<([^>]+)>/i', implode('', $smtpLogs), $matches);
$finalMessageId = $matches[1] ?? $mail->MessageID;

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