mailparse_msg_extract_whole_part_file()
从一个 MIME 邮件消息的指定部分中提取出整个部分并将其写入一个文件中
函数名：mailparse_msg_extract_whole_part_file()
适用版本：PHP 4 >= 4.1.0, PECL mailparse >= 0.9.0
用法：mailparse_msg_extract_whole_part_file(string $filename, resource $msg, int $part_number [, bool $options = false])
说明：mailparse_msg_extract_whole_part_file() 函数从一个 MIME 邮件消息的指定部分中提取出整个部分并将其写入一个文件中。
参数：
$filename：要写入的文件的路径和名称。
$msg：一个有效的 mailparse 解析资源。
$part_number：要提取的部分的编号。
$options：一个可选的布尔值参数，用于控制提取过程。默认为 false。
返回值：成功时返回 true，失败时返回 false。
示例：
// 创建一个 mailparse 解析资源
$msg = mailparse_msg_parse_file('/path/to/email.eml');
// 提取邮件消息的第一个部分并将其写入文件
$partNumber = 1;
$filename = '/path/to/output.txt';
if (mailparse_msg_extract_whole_part_file($filename, $msg, $partNumber)) {
echo "成功提取并写入文件。";
} else {
echo "提取并写入文件失败。";
}
// 关闭 mailparse 解析资源
mailparse_msg_free($msg);
注意事项：
在调用该函数之前，需要使用 mailparse_msg_parse_file() 或 mailparse_msg_create() 函数创建一个有效的 mailparse 解析资源。
$part_number 参数指定要提取的部分的编号，可以通过 mailparse_msg_get_part_data() 函数获取部分的编号。
如果指定的部分不是一个完整的部分（例如，它是一个子部分），则该函数将返回 false。
如果指定的文件已经存在，将会被覆盖。
在使用完毕后，应该调用 mailparse_msg_free() 函数来释放 mailparse 解析资源。
该函数需要 PECL mailparse 扩展的支持，因此在使用之前需要确保该扩展已经安装和启用。