PHP 7.4 IMAP 获取附件时文件损坏主因是数据提取不完整或污染，需用 imap_fetchstructure 定位 part、imap_fetchbody 精准提取、清洗 base64 字符串并严格解码，再二进制写入校验。
PHP 7.4 使用 IMAP 获取邮件附件时，base64 解码后文件损坏，核心问题通常不在解码函数本身，而在于数据截断、编码不纯、字符集错位或结构解析偏差。只要原始邮件结构完整，解码逻辑正确，损坏几乎都发生在“取数据”环节，而非“解码”环节。
确认附件内容是否被完整提取
很多开发者直接用 imap_body() 或 imap_fetchbody() 提取某一部分，却忽略了 MIME 分段边界（boundary）和编码嵌套层级，导致只取到片段或混入头信息。
- 务必使用
imap_fetchstructure()先解析整封邮件结构，定位到目标附件 part 的encoding（如 3 = BASE64）、type（如 5 = APPLICATION）、subtype（如 pdf / zip）及ifdparameters中的文件名 - 用
imap_fetchbody($mbox, $msgno, $part_number)提取对应 part，注意：part_number 是点号路径（如 "2.1"），不是简单数字索引 - 提取后先检查字符串长度是否为 4 的倍数；若不是，说明已被截断或含非法换行（如 CRLF 被误删），需用
str_replace(["\r\n", "\n", "\r"], '', $data)清理后再补等号
校验 base64 输入是否合法且纯净
邮件中 base64 数据常夹杂空格、换行、HTML 注释或 MIME 头残留（如 Content-Transfer-Encoding: base64 行未剥离），直接传给 base64_decode() 就会失败或解出乱码。
- 用正则过滤：
$clean = preg_replace('/[^A-Za-z0-9\/\+=]/', '', $raw_data); - 强制补齐等号：
$clean = str_pad($clean, ceil(strlen($clean) / 4) * 4, '='); - 再调用
$bin = base64_decode($clean, true);—— 第二个参数true启用严格模式，非法字符直接返回 false，便于快速定位问题
验证解码结果是否为有效二进制
解码成功 ≠ 文件可用。常见陷阱是把二进制流当字符串 echo 或写入时被 PHP 默认编码（如 UTF-8）二次处理，导致头部字节（如 PDF 的 %PDF）被破坏。
立即学习“PHP免费学习笔记（深入）”；
- 写入前禁用输出编码：
mb_internal_encoding('BINARY');或直接用file_put_contents($path, $bin, LOCK_EX); - 检查前 10 字节是否符合预期格式（如 PNG 是
\x89PNG\r\n\x1a\n，ZIP 是\x50\x4b\x03\x04） - 用
finfo_open(FILEINFO_MIME_TYPE)检查解码后数据的真实 MIME 类型，若返回text/plain或application/octet-stream，大概率解码前就已污染
绕过 imap_body 的替代方案（推荐）
避免用 imap_body() 下载整封邮件再搜索附件，既慢又易出错。应结合 imap_fetchstructure() + imap_fetchbody() 精准定位：
- 遍历
$structure->parts，递归查找$part->ifdisposition && strtolower($part->disposition) === 'attachment' - 对每个匹配 part，记录其
$part->encoding和$part->type . '/' . $part->subtype - 仅对该 part 执行
imap_fetchbody()+ 清洗 + 严格 base64_decode - 这样可跳过正文、HTML、文本部分，减少干扰，提升准确率与性能
