phpMailer内嵌外部图片时Gmail出现无命名附件问题求助

问题根源在于代码未给内嵌图片指定MIME类型和文件名，Gmail无法正确识别图片格式，默认将其标记为text/plain类型的附件；同时存在编码处理和CID规范问题，导致客户端解析异常。以下是修正方案：

关键修正点 #

1. 给addStringEmbeddedImage补充MIME类型和文件名参数，明确告知邮件客户端文件类型
2. 规范CID格式，符合RFC 2392标准（添加域名后缀确保唯一性）
3. 修复HTML编码处理逻辑，避免乱码
4. 用curl替代file_get_contents，更稳定处理远程图片获取

修正后的完整代码 #

$doc = new DOMDocument();
// 强制指定UTF-8编码，避免DomDocument解析乱码
@$doc->loadHTML('<?xml encoding="UTF-8">' . $body);
$tags = $doc->getElementsByTagName('img');

// 初始化MIME类型检测器
$finfo = new finfo(FILEINFO_MIME_TYPE);

foreach ($tags as $tag) {
    $url = $tag->getAttribute('src');
    // 生成符合规范的CID，添加自定义域名后缀
    $cid = md5($url) . '@yourdomain.com';
    
    // 使用curl获取远程图片，支持重定向、HTTPS场景
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_FOLLOWLOCATION, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    $image_data = curl_exec($ch);
    curl_close($ch);
    
    if (!$image_data) continue; // 获取失败则跳过当前图片
    
    // 检测图片实际MIME类型
    $mime_type = $finfo->buffer($image_data);
    // 从URL提取文件名，无有效文件名则用CID替代
    $filename = basename(parse_url($url, PHP_URL_PATH)) ?: $cid;
    
    // 替换img标签的src为CID引用
    $tag->setAttribute('src', 'cid:' . $cid);
    // 添加内嵌图片，明确指定文件名和MIME类型
    $email->addStringEmbeddedImage($image_data, $cid, $filename, 'base64', $mime_type);
}

// 保存处理后的HTML内容
$body = $doc->saveHTML();
// 设置邮件编码为UTF-8，无需转windows-1252
$email->CharSet = 'UTF-8';

说明 #

• 替换yourdomain.com为你的实际域名，确保CID全局唯一
• 若不需要处理远程图片，可保留file_get_contents，但curl的兼容性更强
• 移除了iconv转码逻辑，PHPMailer原生支持UTF-8编码，直接设置CharSet即可

内容的提问来源于stack exchange，提问作者charlie