如何在Laravel 9中实现邮件转发功能

核心思路 #

邮件转发的本质是将原邮件的内容、附件、上下文信息重新封装为新邮件，发送给目标收件人，同时保留原邮件的发件人、主题等关键信息，通常会在主题前添加FWD:前缀标识。

步骤实现 #

1. 从数据库读取原邮件数据 #

假设你的邮件数据表包含subject（主题）、from（原发件人）、body（邮件内容）、attachments（附件存储路径）等字段，先查询出需要转发的邮件记录：

$originalMail = YourMailModel::findOrFail($mailId); // 替换为你的实际模型查询逻辑

2. 用laminas/laminas-mail构建转发邮件 #

2.1 初始化邮件实例

use Laminas\Mail\Message;
use Laminas\Mime\Message as MimeMessage;
use Laminas\Mime\Part as MimePart;

$forwardMessage = new Message();

2.2 设置邮件基础信息

配置转发邮件的发件人、收件人、主题：

$forwardMessage->setSubject('FWD: ' . $originalMail->subject)
    ->setFrom(config('mail.from.address')) // 读取Laravel配置的系统发件邮箱
    ->setTo($request->input('recipient')); // 目标收件人邮箱（从表单或请求参数获取）

2.3 拼接转发内容

将原邮件内容作为引用内容插入，同时可添加自定义转发说明：

// 自定义转发提示
$forwardNote = "以下是转发的邮件内容：\n\n";
// 原邮件上下文引用
$originalContext = "> 原发件人: {$originalMail->from}\n> 原主题: {$originalMail->subject}\n\n";
// 完整内容拼接
$fullContent = $forwardNote . $originalContext . $originalMail->body;

// 创建MIME部件，根据原邮件类型设置格式
$contentPart = new MimePart($fullContent);
$contentPart->type = str_contains($originalMail->body, '<html>') ? 'text/html' : 'text/plain';

// 组装MIME消息
$mimeMessage = new MimeMessage();
$mimeMessage->addPart($contentPart);

$forwardMessage->setBody($mimeMessage);

2.4 添加原邮件附件

如果原邮件带有附件，从存储路径读取并添加到转发邮件：

if (!empty($originalMail->attachments)) {
    foreach ($originalMail->attachments as $attachmentPath) {
        $filePath = storage_path('app/' . $attachmentPath); // 替换为你的实际附件存储路径
        $attachmentContent = file_get_contents($filePath);
        
        $attachmentPart = new MimePart($attachmentContent);
        $attachmentPart->type = mime_content_type($filePath);
        $attachmentPart->filename = basename($attachmentPath);
        $attachmentPart->disposition = MimePart::DISPOSITION_ATTACHMENT;
        $attachmentPart->encoding = MimePart::ENCODING_BASE64;

        $mimeMessage->addPart($attachmentPart);
    }
}

3. 发送转发邮件 #

使用laminas的SMTP传输适配器结合Laravel的邮件配置发送：

use Laminas\Mail\Transport\Smtp;
use Laminas\Mail\Transport\SmtpOptions;

// 从Laravel配置中读取SMTP参数
$smtpConfig = config('mail.mailers.smtp');
$smtpOptions = new SmtpOptions([
    'host' => $smtpConfig['host'],
    'port' => $smtpConfig['port'],
    'connection_class' => 'login',
    'connection_config' => [
        'username' => $smtpConfig['username'],
        'password' => $smtpConfig['password'],
        'ssl' => $smtpConfig['encryption'],
    ],
]);

$transport = new Smtp($smtpOptions);
$transport->send($forwardMessage);

4. 集成到管理面板 #

在管理面板控制器中添加转发处理方法：

public function forward(Request $request, $mailId)
{
    $request->validate([
        'recipient' => 'required|email',
    ]);

    // 执行上述读取、构建、发送逻辑
    $originalMail = YourMailModel::findOrFail($mailId);
    // ... 构建转发邮件代码 ...
    $transport->send($forwardMessage);

    return redirect()->back()->with('success', '邮件已成功转发');
}

在邮件详情页添加转发表单：

<form action="{{ route('mail.forward', $mail->id) }}" method="POST">
    @csrf
    <div class="mb-3">
        <label class="form-label">收件人邮箱</label>
        <input type="email" name="recipient" class="form-control" required>
    </div>
    <button type="submit" class="btn btn-primary">转发邮件</button>
</form>

注意事项 #

• 若原邮件为HTML格式，需确保转发时保留HTML结构，避免内容错乱。
• 处理附件时要检查文件权限，确保服务器能读取附件文件。
• 可添加In-Reply-To、References等邮件头，让收件人客户端识别为转发邮件。
• 建议添加异常捕获，处理发送失败的情况并返回友好提示。

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