Laravel无模板/Markdown下邮件嵌入图片的实现疑问

一、公共链接vs直接嵌入的优劣对比 #

• 公共链接方式
  • 优点：邮件体积小、加载速度快，图片可缓存，后续更新图片无需重新发送邮件；
  • 缺点：多数邮件客户端默认屏蔽外部图片，用户需手动点击"显示图片"才能看到，依赖外部服务器稳定性。
• 直接嵌入方式
  • 优点：图片随邮件发送，无需依赖外部资源，用户打开邮件即可直接看到；
  • 缺点：邮件体积增大，发送/加载速度变慢，图片无法后续更新，部分老旧客户端可能存在兼容性问题（主流客户端如Gmail、Outlook均已支持）。

二、HTML字符串场景下使用$message->embed()实现图片嵌入 #

你当前用Mail::send()结合HTML字符串生成邮件的场景，可通过闭包中获取$message对象生成图片CID，再替换HTML中的占位符来实现：

具体代码示例 #

Mail::send([], [], function ($message) {
    // 1. 生成嵌入图片的CID（Content-ID）
    $logoCid = $message->embed(public_path('images/your-logo.png'));
    // 若图片存在storage，改用storage_path('app/public/images/your-logo.png')
    
    // 2. 原始HTML正文，用占位符标记图片位置
    $htmlContent = <<<HTML
    <div style="padding: 20px;">
        <h1>邮件标题</h1>
        <p>这是邮件正文内容</p>
        <img src="LOGO_PLACEHOLDER" alt="网站Logo" style="width: 150px;">
    </div>
HTML;
    
    // 3. 将占位符替换为生成的CID
    $finalHtml = str_replace('LOGO_PLACEHOLDER', $logoCid, $htmlContent);
    
    // 4. 设置邮件信息
    $message->to('recipient@example.com')
            ->subject('测试嵌入图片的邮件')
            ->setBody($finalHtml, 'text/html');
});

关键说明 #

• $message->embed()方法会自动将图片以MIME附件形式添加到邮件中，并返回cid:xxx格式的标识符，直接作为<img>的src属性即可；
• 多张图片的话，只需为每张图片生成独立的CID，替换对应占位符即可；
• 避免使用base64编码嵌入图片，Gmail等主流客户端会过滤这类图片，导致无法显示，Laravel的embed()是标准的兼容方案。

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