PHP-Eml-Parser不可直接Composer安装，已停止维护且Packagist无有效包；应使用活跃维护的php-mime-mail-parser/php-mime-mail-parser，支持完整MIME解析并兼容PHP 7.4–8.3。
确认 PHP-Eml-Parser 是否仍可直接 Composer 安装
不能。官方 php-eml-parser（由 php-mime-mail-parser 衍生的老版本）早已停止维护，Packagist 上无有效包名，composer require php-eml-parser/php-eml-parser 会报 Package "php-eml-parser/php-eml-parser" not found 错误。
当前实际可用的、活跃维护的替代方案是 php-mime-mail-parser/php-mime-mail-parser —— 它支持完整 MIME 解析（含嵌套 multipart、base64/quoted-printable、附件、HTML/plain 双正文），且兼容 PHP 7.4–8.3。
- 别搜错名字：不是
php-eml-parser，而是php-mime-mail-parser - 别用 GitHub 直链安装（如
composer require "github:php-mime-mail-parser/php-mime-mail-parser"），Packagist 已托管，应走标准源 - 若项目已锁定旧版依赖，需先检查
composer.json是否存在冲突的mailparse或imap扩展要求
安装 php-mime-mail-parser 并验证基础解析能力
执行：
composer require php-mime-mail-parser/php-mime-mail-parser安装后，用一段最小可行代码测试是否能提取主题和发件人：
<?php
use PhpMimeMailParser\Parser;
$parser = new Parser();
$parser->setPath('/path/to/raw.eml'); // 或用 setStream() 传 fopen 资源
echo $parser->getHeader('subject') . "\n";
echo $parser->getHeader('from') . "\n";
?>
-
setPath()接受绝对路径；若用setStream()，务必确保资源为rb模式打开（fopen($file, 'rb')），否则中文头可能乱码 - 默认不解析 HTML 正文中的内联样式或脚本，
getMessageBody('html')返回原始 HTML 字符串，需自行过滤 XSS - 附件列表通过
getAttachments()获取，每个附件是PhpMimeMailParser\Attachment对象，含getFilename()、getContent()等方法
处理嵌套 multipart 和编码异常的原始邮件
真实 EML 常含多层 multipart/mixed → multipart/alternative → multipart/related 结构，且部分字段使用 =?UTF-8?B?... 编码。该库默认调用 iconv_mime_decode_headers()，但某些老旧邮件头会 decode 失败。
立即学习“PHP免费学习笔记（深入）”；
- 遇到
getHeader('subject')返回空或乱码时，改用$parser->getRawHeader('subject')获取原始值，再手动 base64_decode + iconv - 若
getMessageBody('text')为空但邮件明显有纯文本内容，说明正文被包裹在multipart/alternative内层，此时应调用getMessageBody('text', true)（第二个参数true启用递归查找） - 附件名含中文时，
getFilename()可能返回空，需 fallback 到$attachment->getHeader('content-disposition')中正则提取filename\*?=([^;]+)
避免内存溢出和临时文件残留
大附件（如 >50MB）或超长 Base64 正文易触发 PHP 内存限制或临时目录写满。该库默认将附件写入 sys_get_temp_dir()，但不自动清理。
- 用
$parser->setTempDir('/your/safe/tmp')指定独立临时目录，并确保有写权限 - 解析完成后立即调用
$parser->close()（它会清空临时文件），否则下次new Parser()可能复用残留文件导致读取错误 - 对超大邮件，禁用自动附件保存：
$parser->setSaveAttachments(false)，改用$attachment->getContent()流式处理 - 若服务器禁用
exec，php-mime-mail-parser的部分 MIME 类型检测会降级，但不影响核心解析，无需额外扩展
复杂邮件结构和编码变体远比文档示例多，真正卡住时，先 dump $parser->getRawHeaders() 和 $parser->getParts() 看原始分段，再决定用哪个 getter 或手动遍历 part。
