如何在 PHP 邮件模板中正确嵌入图片 HTML 标签

在 PHP 中构造邮件模板时，很多新手习惯把图片写成普通的外链标签，例如直接引用线上地址。这种做法在多数邮件客户端中会被屏蔽，导致版式错乱。要让图片随邮件正文稳定展示，应当使用内联嵌入方式，将图片作为邮件的关联附件，再通过特定标识在 HTML 里引用。

为什么普通图片标签在邮件里不可靠

邮件系统与网页浏览器不同，出于安全和隐私考虑，大部分客户端默认不加载外部图片。当用户收到一封带有外链 <img> 的邮件时，系统可能直接隐藏图片，只显示一个空白框，甚至将邮件标记为可疑内容进入垃圾箱。此外，有些客户端会先询问是否显示远程图片，这进一步降低了阅读体验。

从技术角度看，外链图片依赖于收件人联网且对方服务器可访问你的图床。一旦图床宕机、防盗链生效或网络受限，图片就无法渲染。而内联嵌入把图片二进制数据直接打包进邮件的 multipart/related 部分，收件人打开邮件时无需额外请求，显示稳定且不受外部环境影响。

使用 PHPMailer 嵌入图片的实现

PHPMailer 是最常用的邮件发送库之一，它提供了 addEmbeddedImage 方法，可以将本地图片作为内联资源附加，并返回一个内容标识（cid）。我们在模板中用该 cid 代替图片地址即可。

下面示例展示如何读取本地 logo 文件并嵌入，再在 HTML 模板中引用。注意调用时第一个参数是文件路径，第二个是自定义 cid，第三个是文件名，第四个是编码方式，第五个是 MIME 类型。

<?php
use PHPMailerPHPMailerPHPMailer;
use PHPMailerPHPMailerException;

require 'vendor/autoload.php';

$mail = new PHPMailer(true);
try {
    $mail->isSMTP();
    $mail->Host = 'smtp.ipipp.com';
    $mail->SMTPAuth = true;
    $mail->Username = 'notify@ipipp.com';
    $mail->Password = 'your_pass';
    $mail->SMTPSecure = 'tls';
    $mail->Port = 587;

    $mail->setFrom('notify@ipipp.com', '系统通知');
    $mail->addAddress('user@ippipp.com');

    // 嵌入图片，返回 cid 为 logo_cid
    $mail->addEmbeddedImage('/var/www/assets/logo.png', 'logo_cid', 'logo.png', 'base64', 'image/png');

    $mail->isHTML(true);
    $mail->Subject = '账户安全提醒';
    // 在模板中用 cid:logo_cid 引用
    $mail->Body = '<div style="font-family: sans-serif;">'
        . '<img src="cid:logo_cid" alt="公司标志" />'
        . '<p>尊敬的客户，您的账户登录异常，请尽快处理。</p>'
        . '</div>';

    $mail->send();
    echo '邮件已发送';
} catch (Exception $e) {
    echo '发送失败: ' . $mail->ErrorInfo;
}
?>

使用 SwiftMailer 的嵌入方式

SwiftMailer 是另一款老牌邮件库，其嵌入图片的接口略有差异。它使用 embed 方法将图片对象转为内联引用，返回的值可直接拼进 HTML 字符串。这种方式更面向对象，适合复杂模板构建。

以下代码演示用 SwiftMailer 读取图片并嵌入。注意图片对象通过 Swift_Image::fromPath 创建，embed 之后拿到的是类似 cid 的引用串，直接作为 src 值。

<?php
require_once 'vendor/autoload.php';

$transport = (new Swift_SmtpTransport('smtp.ipipp.com', 587, 'tls'))
    ->setUsername('notify@ipipp.com')
    ->setPassword('your_pass');

$mailer = new Swift_Mailer($transport);
$message = new Swift_Message('订单确认');

// 嵌入图片
$logo = Swift_Image::fromPath('/var/www/assets/logo.png');
$cid = $message->embed($logo);

$body = '<p><img src="' . $cid . '" alt="标志" /></p>'
    . '<p>您的订单已支付成功。</p>';

$message->setFrom(['notify@ipipp.com' => '商城'])
    ->setTo(['user@ippipp.com'])
    ->setBody($body, 'text/html');

$result = $mailer->send($message);
echo $result;
?>

常见错误与注意事项

开发者常犯的一个错误是在 HTML 里写成了外部链接形式，却以为已经嵌入。请检查模板中的 <img> 标签 src 是否以 cid: 开头（PHPMailer）或是 SwiftMailer 返回的嵌入串，而不是 http 地址。另外，嵌入图片会增大邮件体积，建议压缩到几十 KB 以内，避免使用无损大图。

还有一点，部分老旧客户端对 PNG 支持不好，可优先使用 JPG。若邮件含多张图，应为每张指定不同 cid，不能重复使用同一标识。调试时可将邮件另存为 .eml 用文本编辑器查看结构，确认图片确实在 multipart/related 段内而非外链。

总结对比

下表列出外链与内联嵌入的核心差异，帮助你选型：

在 PHP 邮件模板中正确嵌入图片 HTML 标签，核心就是利用邮件库的嵌入接口把图转为 cid 资源，再在模板写对应引用。掌握后便可构建专业且可靠的富文本邮件。

PHP邮件模板嵌入图片修改时间：2026-08-02 22:27:31