本文详解如何将图片作为内联内容（而非附件）嵌入 Laravel 邮件通知，通过 Blade 模板 + asset() 辅助函数实现 HTML 内嵌图像渲染，并避免常见路径错误与安全风险。
本文详解如何将图片作为内联内容（而非附件）嵌入 laravel 邮件通知，通过 blade 模板 + `asset()` 辅助函数实现 html 内嵌图像渲染，并避免常见路径错误与安全风险。
在 Laravel 的邮件通知中，直接调用 ->attach() 方法会将图片作为附件发送，用户需手动下载查看，无法在邮件正文中直观展示。要实现「图片作为内容显示」，核心思路是：将图片以 <img> 标签形式嵌入 HTML 邮件正文，并确保其 URL 可被邮件客户端公开访问。
✅ 正确做法：使用自定义 Blade 模板 + 公开可访问的图片路径
首先，在通知类的 toMail() 方法中，放弃 attach()，改用 ->view() 指向一个专用邮件模板，并传入图片路径变量：
public function toMail($notifiable)
{
return (new MailMessage)
->greeting('Dear ' . $this->fullname)
->view('emails.notification-image', [
'image_path' => $this->image_path // 如: 'images/banners/welcome.jpg'
]);
}接着，创建对应 Blade 模板 resources/views/emails/notification-image.blade.php：
@component('mail::message')
# 欢迎加入！
以下是您的专属欢迎图：
<img
src="{{ asset($image_path) }}"
alt="Welcome Banner"
style="max-width: 100%; height: auto; border-radius: 8px;"
>
感谢您的信任！
@endcomponent⚠️ 关键注意事项：
- asset($image_path) 生成的是绝对 URL（如 https://yoursite.com/images/banners/welcome.jpg），要求该路径下的图片必须位于 public/ 目录下（例如 public/images/banners/welcome.jpg），且 Web 服务器已正确配置静态资源访问权限；
- 切勿使用 public_path() 或本地文件路径（如 file:///...），邮件客户端无法读取本地或服务器内部路径；
- 若图片存于云存储（如 S3），应传入完整的公开 CDN URL（如 https://cdn.example.com/...），并直接在模板中使用：<img src="{{ $image_url }}">；
- 为提升兼容性，建议为 <img> 添加 alt 属性与基础内联样式（如 max-width: 100%），适配各类邮件客户端（Outlook、Apple Mail 等）。
? 补充验证建议
- 发送测试邮件后，查看原始 HTML 源码，确认 <img src="..."> 中的 URL 能在浏览器中直接打开；
- 使用 Mailtrap 或 Ethereal 进行安全沙盒测试；
- 对敏感图片路径做白名单校验（如 Str::startsWith($this->image_path, ['images/', 'logos/'])），防止路径遍历风险。
通过以上方式，你即可优雅、可靠地在 Laravel 邮件通知中以内嵌形式呈现图像，显著提升用户体验与信息传达效率。
