Symfony Mailer邮件模板图片被显示为附件，如何取消附件仅显示图片

当你使用Symfony Mailer结合Twig模板发送邮件时，内嵌图片被当成附件显示，通常是因为邮件客户端无法正确识别图片的内嵌关联（Content-ID匹配失败），或者MIME资源标记不正确。以下是几种可靠的解决方法：

方法1：显式关联图片的Content-ID #

在Twig模板中先定义图片变量，获取其Content-ID，再通过cid:前缀引用，确保图片和内嵌资源正确绑定：

{% block body %}
    {% apply inky_to_html|inline_css(source('@css/foundation-emails.css')) %}
        <container>
            <row>
                <columns>
                    <h1 class="text-center">Rénisialisation de mot de passe</h1>
                    <p class="text-center">{{ sujet }}</p>
                </columns>
            </row>
            <spacer size="16"></spacer>
            <row>
                <columns>
                    <center>
                        <button class="rounded large" href="https://localhost:8000/user/reset/{{ id }}/{{ reset_token }}">Rénitialiser</button>
                    </center>
                </columns>
            </row>
        </container>
        {% set logoImage = email.image('@images/logo.png') %}
        <img src="cid:{{ logoImage.getContentId() }}" alt="Logo" style="width: 260px">
    {% endapply %}
{% endblock %}

这种方式会明确告诉邮件客户端：这张图片是邮件内容的一部分，不是独立附件。

方法2：使用公网绝对URL（适合可公开访问的图片） #

如果你的图片部署在公网可访问的服务器上，直接使用绝对URL代替内嵌，这样不会生成任何附件：

<img src="https://your-domain.com/images/logo.png" alt="Logo" style="width: 260px">

注意：部分邮件客户端默认会阻止外部图片加载，需要用户手动允许显示，但不会出现附件问题。

方法3：在PHP代码中手动嵌入图片并命名 #

在发送邮件的PHP逻辑里，手动添加内嵌图片并指定名称，再在模板中通过名称引用：

PHP代码： #

use Symfony\Component\Mime\Email;

$email = (new Email())
    ->from('noreply@your-domain.com')
    ->to($user->getEmail())
    ->subject('Rénisialisation de mot de passe')
    ->html($this->renderView('emails/reset_password.html.twig', [
        'sujet' => 'Votre lien de réinitialisation',
        'id' => $user->getId(),
        'reset_token' => $user->getResetToken(),
    ]))
    // 手动嵌入图片，指定名称和MIME类型
    ->embedFromPath('public/images/logo.png', 'email-logo', 'image/png');

Twig模板对应部分： #

<img src="cid:email-logo" alt="Logo" style="width: 260px">

额外注意事项 #

• 避免在模板中重复引用同一张图片，否则会生成多个重复附件
• 检查图片的MIME类型是否正确（比如PNG图片用image/png，JPG用image/jpeg），类型不匹配可能导致客户端识别异常
• 确保inky_to_html和inline_css过滤器没有修改图片的src属性，破坏cid:引用

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