如何在Symfony SwiftMailer中实现邮件发送与投递确认？

好问题！要实现SwiftMailer的发送确认和投递确认，得分别处理两种不同的场景——一种是邮件成功提交到邮件服务器（MTA）的确认，另一种是收件人实际收到/读取邮件的确认。结合你提到的后台异步发送需求，我给你分步骤拆解：

一、获取发送确认（邮件成功提交给MTA） #

默认情况下SwiftMailer用Spool（比如FileSpool）后台异步发送，避免阻塞用户流程，但这时候直接调用send()拿不到实时结果。要捕获发送状态，推荐用事件监听+后台队列处理的方式：

1. 注册发送事件监听器 #

SwiftMailer的Transport自带事件调度器，可以监听发送成功/失败的事件，把状态记录到日志或数据库：

// 初始化SMTP Transport
$transport = Swift_SmtpTransport::newInstance('smtp.yourdomain.com', 587, 'tls')
    ->setUsername('your_email@yourdomain.com')
    ->setPassword('your_password');

$mailer = Swift_Mailer::newInstance($transport);

// 获取事件调度器
$dispatcher = $mailer->getTransport()->getDispatcher();

// 监听发送成功事件
$dispatcher->registerListener(Swift_Events_SendEvent::SEND_SUCCESS, function(Swift_Events_SendEvent $event) {
    $message = $event->getMessage();
    // 这里可以把发送成功的信息存入数据库或日志
    error_log("[发送成功] 邮件ID: {$message->getId()} | 收件人: " . implode(',', array_keys($message->getTo())));
});

// 监听发送失败事件
$dispatcher->registerListener(Swift_Events_SendEvent::SEND_FAILED, function(Swift_Events_SendEvent $event) {
    $message = $event->getMessage();
    $failedRecipients = $event->getFailedRecipients();
    // 记录失败信息，方便后续排查
    error_log("[发送失败] 邮件ID: {$message->getId()} | 失败收件人: " . implode(',', $failedRecipients));
});

2. 后台处理Spool队列 #

如果用了FileSpool，你需要通过cron任务或后台脚本定期触发队列刷新，这时候事件监听器会自动捕获每个邮件的发送状态：

// 假设你的Spool是FileSpool实例
$spool = $mailer->getTransport()->getSpool();
// 刷新队列，把缓存的邮件发送出去，同时触发事件
$sentCount = $spool->flushQueue($transport);

如果你不需要完全异步，也可以同步发送直接判断返回值（但会阻塞用户流程）：

$sentCount = $mailer->send($message);
if ($sentCount > 0) {
    // 发送成功逻辑
} else {
    // 发送失败逻辑
}

二、获取投递确认（收件人实际收到/读取邮件） #

这个功能不依赖SwiftMailer本身，而是需要邮件服务器（MTA）和收件人客户端的支持。你可以通过给邮件添加特定头信息，请求投递状态通知（DSN）或已读回执：

1. 添加投递确认请求头 #

在邮件中添加以下头信息，请求MTA在邮件投递成功/失败时发送通知到指定邮箱：

$message = Swift_Message::newInstance()
    ->setSubject('测试投递确认')
    ->setFrom(['sender@yourdomain.com' => '发送者'])
    ->setTo(['recipient@example.com'])
    ->setBody('这是一封请求投递确认的测试邮件');

// 请求投递状态通知（MTA会返回成功/失败的邮件）
$message->getHeaders()->addTextHeader('Disposition-Notification-To', 'sender@yourdomain.com');
// 请求已读回执（收件人可以选择是否发送）
$message->getHeaders()->addTextHeader('Return-Receipt-To', 'sender@yourdomain.com');

// 更规范的DSN请求（部分MTA支持）
$message->getHeaders()->addParameterizedHeader('X-Confirm-Reading-To', 'sender@yourdomain.com');

2. 解析回执邮件 #

这些确认通知会以邮件的形式发送到你指定的邮箱，你需要编写一个脚本（比如用PHP的IMAP扩展）定期检查这个邮箱，解析回执邮件的内容，提取投递状态、收件人是否已读等信息，然后存入系统。

额外注意事项 #

• 发送确认是可靠的：只要SwiftMailer把邮件成功交给MTA，就会触发SEND_SUCCESS事件，这个状态是可以100%捕获的。
• 投递确认不可靠：收件人可以拒绝发送已读回执，部分邮件服务器也可能不支持DSN，所以不能把这个作为唯一的投递依据。
• 如果用第三方邮件服务（比如SendGrid、Mailgun），它们通常会提供Webhook来推送投递状态，这种方式比自己解析邮件更可靠。

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