如何使用Composer引入 PHP-Mime-Mail-Parser 库提取邮件附件与正文内容-composer-PHP中文网

直接 composer require php-mime-mail-parser/php-mime-mail-parser 会失败，因为旧包已被弃用，需用同名新包（由 php-mime-mail-parser 组织维护），并清除 composer 缓存；加载 .eml 文件须读取原始字节，用 setpath() 或 settext() 解析，正文提取用 gethtmlbody()/gettextbody()，附件提取需传 true 参数并手动解码，字符编码和 mime 头需自行处理。

如何使用composer引入 php-mime-mail-parser 库提取邮件附件与正文内容

为什么直接 `composer require php-mime-mail-parser/php-mime-mail-parser` 会失败？

因为该库已停止维护，原作者将项目移交并重命名为 php-mime-mail-parser，但 Packagist 上的旧包名 php-mime-mail-parser/php-mime-mail-parser 已被弃用，直接安装会报 Package "php-mime-mail-parser/php-mime-mail-parser" not found 错误。

实际应使用移交后的新包名：

composer require php-mime-mail-parser/php-mime-mail-parser

注意：这个包名看起来一样，但背后指向的是新维护者（php-mime-mail-parser 组织）托管的版本。如果你用的是 Composer 2.2+，且之前缓存过旧失败记录，建议先运行：

composer clear-cache
确认 composer config -g repo.packagist.org.allow_ssl_downgrade false（避免因 HTTPS 降级导致元数据拉取异常）

如何加载 .eml 文件并提取正文和附件？

该库不支持流式解析大邮件，必须先将完整原始邮件内容（RFC 5322 格式）读入字符串或临时文件。常见错误是传入 HTML 或已解码的 body，导致 ParseException。

正确做法：

用 file_get_contents() 读取 .eml 文件原始字节（保持 CRLF、base64/QP 编码 intact）
实例化 PhpMimeMailParser\Parser 后调用 setPath()（推荐）或 setText()
正文提取优先用 getHtmlBody() 和 getTextBody()，不要依赖 getMessageBody()（它只返回最外层 body，忽略 multipart 结构）

示例：

$parser = new PhpMimeMailParser\Parser();
$parser->setPath('/path/to/email.eml');

$html = $parser->getHtmlBody(); // 可能为 null（无 HTML 部分）
$text = $parser->getTextBody(); // 可能为空字符串（无纯文本部分）

// 若两者都为空，说明邮件结构异常或编码损坏
if ($html === null && $text === '') {
    throw new RuntimeException('No parsable body found');
}

附件提取时为什么 `getAttachments()` 返回空数组？

常见原因不是代码写错，而是邮件本身不含符合 RFC 标准的 Content-Disposition: attachment 头 —— 很多客户端（如 Outlook Web）对内嵌图片用 inline，或根本省略该头，仅靠 Content-Type 和 Content-Transfer-Encoding 推断。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

应对策略：

调用 getAttachments(true)（传 true 表示包含 inline 类型资源）
检查每个附件对象的 getContentDisposition() 返回值，区分 attachment 和 inline
附件内容需手动解码：getBinary() 返回原始 base64/QP 编码内容，getDecodedContent() 才是解码后二进制（注意内存占用）
避免用 saveToDisk() 直接写入——它不会自动创建目录，路径不存在会静默失败

安全提醒：附件文件名来自邮件头，可能含 ../ 路径穿越，务必用 basename() 过滤后再拼接保存路径。

中文乱码、特殊字符显示异常怎么处理？

该库默认不自动转码，所有字符串（包括 headers、body、filename）均以原始编码返回。若邮件声明了 Content-Type: text/plain; charset=gbk，但你用 UTF-8 解释，就会乱码。

关键点：

用 getHeader('content-type') 提取 charset 值，再用 mb_convert_encoding() 转换（例如：mb_convert_encoding($text, 'UTF-8', 'GBK')）
标题（getHeader('subject')）常含 MIME encoded-word（=?UTF-8?B?...?=），需用 iconv_mime_decode() 或 mb_decode_mimeheader() 解码
附件名同理：getFilename() 返回的是未解码原始值，需配合 mb_decode_mimeheader()