PHP通过IMAP获取Gmail邮件时含.ics附件无法获取完整正文

我之前也碰到过类似的Gmail IMAP处理坑，尤其是带日历附件的邮件，Gmail的MIME结构有时候确实不按常规出牌，硬编码imap_fetchbody的部分编号肯定会踩坑。下面是我总结的可行方案：

核心思路：动态解析MIME结构，而非硬编码部分编号 #

Gmail的邮件结构可能是多层嵌套的（比如multipart/mixed包含正文组和附件，正文组又可能是multipart/alternative包含纯文本和HTML正文），所以必须先通过imap_fetchstructure获取完整的MIME结构，再递归遍历找到对应的正文和附件。

步骤1：获取邮件MIME结构并递归解析 #

先写一个递归函数，遍历每个MIME部分，区分正文（text/plain/text/html）和日历附件（text/calendar）：

function parseMimePart($imapStream, $messageNumber, $part, $prefix = '') {
    $result = [
        'text' => '',
        'html' => '',
        'ics' => ''
    ];

    // 处理当前部分
    if ($part->type == 0) { // 文本类型（plain/html）
        $encoding = $part->encoding;
        $body = imap_fetchbody($imapStream, $messageNumber, $prefix ? $prefix : '1');
        
        // 解码内容
        switch ($encoding) {
            case 3: // BASE64
                $body = imap_base64($body);
                break;
            case 4: // QUOTED-PRINTABLE
                $body = imap_qprint($body);
                break;
        }

        if ($part->subtype == 'PLAIN') {
            $result['text'] .= $body;
        } elseif ($part->subtype == 'HTML') {
            $result['html'] .= $body;
        }
    } elseif ($part->type == 1) { // 多部分类型，递归处理子部分
        $count = count($part->parts);
        for ($i = 0; $i < $count; $i++) {
            $newPrefix = $prefix ? $prefix . '.' . ($i + 1) : ($i + 1);
            $subResult = parseMimePart($imapStream, $messageNumber, $part->parts[$i], $newPrefix);
            
            // 合并结果
            $result['text'] .= $subResult['text'];
            $result['html'] .= $subResult['html'];
            $result['ics'] .= $subResult['ics'];
        }
    } elseif ($part->type == 2 && $part->subtype == 'CALENDAR') { // 日历附件（text/calendar）
        $encoding = $part->encoding;
        $icsContent = imap_fetchbody($imapStream, $messageNumber, $prefix ? $prefix : '1');
        
        // 解码ICS内容
        switch ($encoding) {
            case 3:
                $icsContent = imap_base64($icsContent);
                break;
            case 4:
                $icsContent = imap_qprint($icsContent);
                break;
        }
        $result['ics'] = $icsContent;
    }

    return $result;
}

步骤2：调用函数获取内容 #

在主逻辑里，先连接IMAP，然后获取邮件结构，调用上面的函数：

// 连接Gmail IMAP（注意开启Gmail的IMAP权限，或使用应用专用密码）
$imapStream = imap_open('{imap.gmail.com:993/imap/ssl}INBOX', 'your-email@gmail.com', 'your-password');

if (!$imapStream) {
    die('IMAP连接失败: ' . imap_last_error());
}

$messageNumber = 1; // 要获取的邮件编号
$structure = imap_fetchstructure($imapStream, $messageNumber);
$emailContent = parseMimePart($imapStream, $messageNumber, $structure);

// 输出正文
echo '纯文本正文: ' . $emailContent['text'] . PHP_EOL;
echo 'HTML正文: ' . $emailContent['html'] . PHP_EOL;

// 保存ICS附件
if (!empty($emailContent['ics'])) {
    file_put_contents('event.ics', $emailContent['ics']);
    echo 'ICS附件已保存为event.ics' . PHP_EOL;
}

imap_close($imapStream);

关键注意事项 #

• Gmail的特殊处理：Gmail可能会将邮件内容拆分成多个嵌套的MIME部分，比如把签名单独作为一个子部分，递归遍历能确保你收集到所有正文内容。
• 编码处理：一定要根据encoding字段解码，否则拿到的会是乱码或原始编码字符串。
• 权限问题：确保你的Gmail账号开启了IMAP功能，并且如果开启了两步验证，需要使用应用专用密码登录。
• 附件区分：通过type=2（消息类型）和subtype=CALENDAR来识别.ics附件，避免和正文混淆。

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