如何在PHP中通过IMAP协议正确解码邮件正文内容

开发者阿泽

2026-10-9

PHP IMAP 邮件正文全兼容解码调整方案

核心问题原因

现有解码逻辑仅覆盖了单结构、特定编码/字符集的邮件，而标准MIME邮件支持多段嵌套结构、多种传输编码、多字符集声明，未做全场景兼容就会出现部分内容乱码、缺失的问题。

具体调整步骤

递归解析MIME多段结构
不要直接读取邮件根内容，先通过imap_fetchstructure()获取整封邮件的结构树，递归遍历所有分段：
- 遇到multipart/*类型的分段，继续遍历其下的子分段，同时记录分段层级编号（如根下第一个子分段为1，第一个子分段下的子分段为1.1，以此类推，后续调用imap_fetchbody需传入正确的层级编号才能获取对应内容）
- 遇到text/plain或text/html类型的分段，进入解码流程
- 遇到multipart/alternative类型时，按需求优先级取对应格式的内容：富文本场景优先取text/html，纯文本场景优先取text/plain
适配全类型传输编码解码
根据每个分段的encoding属性对应做解码处理：

// $rawContent 为 imap_fetchbody 获取到的原始内容
// $encoding 为分段结构的encoding字段值
switch ($encoding) {
    case 3: // ENC_BASE64 编码
        $decodedContent = imap_base64($rawContent);
        break;
    case 4: // ENC_QUOTED_PRINTABLE 编码
        $decodedContent = quoted_printable_decode($rawContent);
        break;
    default: // 7bit/8bit/binary 编码
        $decodedContent = $rawContent;
}

统一字符集转换
先读取当前分段parameters属性中的charset声明，将内容统一转为UTF-8，同时增加不规范字符集命名的容错映射：

$charsetMap = [
    'gb2312' => 'GBK',
    'cp936' => 'GBK',
    'latin1' => 'ISO-8859-1',
];
$originCharset = strtolower($part->parameters[0]->value ?? 'utf-8');
$finalContent = mb_convert_encoding($decodedContent, 'UTF-8', $charsetMap[$originCharset] ?? $originCharset);