使用imap_mail_compose创建带多附件邮件并添加至草稿箱遇阻求助

我之前在实现类似功能时也遇到过同样的问题——用imap_mail_compose和imap_append创建带多附件的草稿邮件，核心难点在于正确构建MIME结构、处理附件编码，以及确保草稿箱的配置正确。结合你的代码片段，我整理了一套完整的可运行方案，帮你解决这个问题：

完整实现代码 #

// 1. 配置IMAP服务器和草稿箱路径
$imapServer = '{imap.example.com:993/imap/ssl}'; // 替换为你的IMAP服务器地址（比如Gmail是{imap.gmail.com:993/imap/ssl}）
$draftFolder = $imapServer . 'INBOX.Drafts'; // 普通邮箱草稿箱路径，Gmail请改为[Gmail]/Drafts

// 建立IMAP连接
$conn = imap_open($draftFolder, Auth::user()->email_smtp, Auth::user()->pass_smtp);
if (!$conn) {
    die('IMAP连接失败: ' . imap_last_error());
}

// 2. 构建邮件信封（Envelope）信息
$envelope = [
    'date' => date('r'), // RFC2822格式的日期
    'from' => $data['from'],
    'to' => $data['to'],
    'subject' => $data['subject'] ?? '', // 补充主题字段，必填
    'message_id' => '<' . uniqid('', true) . '@' . parse_url($data['from'], PHP_URL_HOST) . '>', // 生成唯一消息ID
];

// 3. 构建邮件内容部分（MIME Parts）
$parts = [];

// 添加HTML正文（如果是纯文本，把subtype改成plain即可）
$parts[] = [
    'type' => TYPETEXT,
    'subtype' => 'html',
    'encoding' => ENCQUOTEDPRINTABLE,
    'data' => $data['body'] ?? '', // 你的邮件正文内容
];

// 4. 处理上传的图片附件（假设$uploadedImages是多文件上传的数组，比如$_FILES['images']）
$uploadedImages = $_FILES['images'] ?? [];
if (!empty($uploadedImages['tmp_name'])) {
    foreach ($uploadedImages['tmp_name'] as $key => $tmpPath) {
        if (is_uploaded_file($tmpPath)) {
            $fileName = $uploadedImages['name'][$key];
            $fileType = $uploadedImages['type'][$key];
            $fileContent = file_get_contents($tmpPath);

            // 添加图片附件到parts数组
            $parts[] = [
                'type' => TYPEIMAGE,
                'subtype' => str_replace('image/', '', $fileType), // 提取图片子类型（jpeg/png等）
                'encoding' => ENCBASE64,
                'disposition' => 'attachment',
                'filename' => $fileName,
                'data' => imap_binary($fileContent), // 用imap_binary处理内容，确保IMAP兼容
            ];
        }
    }
}

// 5. 生成完整的MIME邮件内容
$mailContent = imap_mail_compose($envelope, $parts);

// 6. 将邮件追加到草稿箱，标记为草稿
$status = imap_append(
    $conn,
    $draftFolder,
    $mailContent . "\r\n", // 必须添加\r\n结尾，否则部分服务器会报错
    "\\Draft" // 标记为草稿，确保邮件显示在草稿箱中
);

// 结果处理
if ($status) {
    echo '草稿邮件创建成功！';
} else {
    echo '草稿创建失败: ' . imap_last_error();
}

// 关闭IMAP连接
imap_close($conn);

关键注意事项 #

• 草稿箱路径验证：不同邮件服务器的草稿箱命名差异很大，你可以通过imap_list($conn, $imapServer, '*')列出所有可用邮箱，找到正确的草稿箱路径：
  • 普通IMAP服务器：INBOX.Drafts
  • Gmail：[Gmail]/Drafts
  • Outlook/Exchange：Drafts
• 唯一消息ID：message_id字段必须是唯一的，否则部分邮件服务器不会将邮件识别为有效草稿。
• 附件编码处理：务必使用imap_binary()处理文件内容，而不是手动base64_encode——imap_mail_compose会根据你设置的encoding参数自动完成编码转换。
• MIME类型配置：图片附件的type要设为TYPEIMAGE，subtype对应具体的图片格式（比如jpeg、png），确保邮件客户端能正确识别并预览附件。
• 草稿标志：imap_append的第四个参数必须添加\\Draft，否则邮件可能会被放到收件箱而不是草稿箱。

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