<p>PHP 7.1 的 IMAP 扩展不自动解析 RFC 2047/2231 编码，附件名乱码主因是 imap_mime_header_decode() 返回 charset 未校验归一化，且 filename* 字段完全不支持；附件内容解码后需手动探测并转码为 UTF-8，不可混用同一逻辑处理名与内容。</p>
PHP 7.1 的 imap 扩展本身不负责解码附件名或内容，乱码根本原因在于：RFC 2047 编码（如 =?UTF-8?B?...）未被主动解析，且 imap_mime_header_decode() 返回的字段未做后续编码归一化处理。
imap_mime_header_decode() 返回数组结构易被忽略
这个函数不返回字符串，而是返回一个对象数组，每个元素含 text 和 charset 两个键。很多人直接 echo $decoded[0]->text，却没检查 $decoded[0]->charset 是否为 UTF-8 或空值——空 charset 表示默认 ASCII，但实际可能是 GBK、BIG5 或 ISO-8859-1。
实操建议：
- 必须遍历解码结果，对每个
$part->charset做判断 - 若
$part->charset === ''或strcasecmp($part->charset, 'us-ascii') === 0，可安全当作 ASCII 处理；否则需转码 - 不要假设所有非空 charset 都是合法值，有些服务器会填
unknown或ISO8859-1（注意中间无短横） - 示例片段：
$decoded = imap_mime_header_decode($header); foreach ($decoded as $part) { $text = $part->text; $charset = strtolower(trim($part->charset)); if ($charset && $charset !== 'utf-8' && $charset !== 'us-ascii') { $text = @iconv($charset, 'UTF-8//IGNORE', $text); } $result .= $text; }
附件文件名中的 RFC 2231 编码未被 imap 支持
当邮件客户端（如 Outlook）用 Content-Disposition: attachment; filename*=UTF-8''%E4%BD%A0%E7%9A%84%E6%96%87%E4%BB%B6.pdf 方式发送附件名时，imap 扩展完全不识别 filename* 字段，仍只读 filename（通常是乱码或空）。这是 PHP 7.1 的硬伤，imap_fetchstructure() 不解析 RFC 2231。
立即学习“PHP免费学习笔记（深入）”；
实操建议：
- 必须手动解析原始 header 字符串，用正则提取
filename\*=(.+?)$后的内容 - 对提取出的 URL 编码部分（如
%E4%BD%A0）调用urldecode()，再用mb_convert_encoding(..., 'UTF-8', 'auto')容错转码 - fallback 到传统
filename字段时，仍要过一遍imap_mime_header_decode()流程 - 别依赖
imap_utf8()：它只对 IMAP 协议内 UTF-7 编码的邮箱名有效，对 MIME header 无效
base64_decode() 后内容未校验编码有效性
附件内容（尤其是 .txt、.csv、.html）经 base64_decode() 后，可能仍是 GBK/Big5 编码的二进制流，直接存盘或 echo 会显示为乱码。PHP 7.1 没有内置 MIME 内容探测机制。
实操建议：
- 对解码后的附件内容，先用
mb_detect_encoding($data, ['UTF-8', 'GBK', 'BIG5', 'EUC-JP'], true)探测（注意第三个参数true表示 strict） - 若检测结果为
GBK，必须显式转成 UTF-8：mb_convert_encoding($data, 'UTF-8', 'GBK') - 避免用
iconv('GBK', 'UTF-8//IGNORE', $data)——//IGNORE会静默丢字，导致中文截断 - 对 PDF、ZIP 等二进制附件，跳过编码检测，直接写入磁盘（它们本就不该被当文本处理）
最常被绕过的点是：附件名和附件内容的编码来源完全不同——前者来自 MIME header 的 RFC 2047 / 2231，后者来自邮件体自身的 Content-Transfer-Encoding 和原始文件编码。混用同一套解码逻辑必然失败。
