本教程详细介绍了在 laravel 应用中发送 html 格式邮件的方法，以解决邮件内容换行符（如 `
`）无法正确渲染，导致文本被截断或格式混乱的问题。核心在于确保邮件内容被识别为 html 类型，并通过 laravel 的 mailable 类和 blade 模板实现这一目标，从而保证邮件在各种客户端中都能美观呈现。
解决 Laravel 邮件内容换行与格式问题
在开发 Web 应用时，通过电子邮件发送通知、报告或营销信息是常见需求。然而，开发者经常会遇到一个问题：在邮件正文中插入 HTML 标签（例如
用于换行）时，这些标签未能正确渲染，导致邮件内容显示为纯文本，排版混乱，甚至被邮件客户端截断（如显示 (…)）。这通常是因为邮件被默认当作纯文本处理，而未被识别为 HTML 格式。
理解 HTML 邮件的必要性
为了在邮件中实现丰富的文本格式、图片、链接以及自定义布局，邮件内容必须以 HTML 格式发送。当邮件客户端收到一份 HTML 邮件时，它会解析其中的 HTML 标签并渲染出预期的视觉效果。实现这一点的关键在于在邮件请求的头部明确指定 Content-Type: text/html;。这个头部信息告知邮件客户端，邮件体应作为 HTML 文档进行解析。
在 Laravel 中发送 HTML 邮件的最佳实践
Laravel 提供了一套优雅且功能强大的邮件发送机制，通过 Mailable 类和 Blade 模板，可以轻松构建和发送 HTML 格式的邮件，并自动处理 Content-Type 头部。
1. 使用 Mailable 类和 Blade 模板 (推荐方式)
这是 Laravel 官方推荐且最健壮的方式，它将邮件的构建逻辑与视图分离，易于维护和扩展。
立即学习“前端免费学习笔记（深入）”；
步骤一：创建 Mailable 类
首先，使用 Artisan 命令生成一个新的 Mailable 类。例如，我们创建一个名为 OrderShipped 的 Mailable：
php artisan make:mail OrderShipped
这会在 app/Mail 目录下创建一个 OrderShipped.php 文件。
步骤二：定义邮件内容视图 (Blade 模板)
在 resources/views/emails 目录下创建一个 Blade 模板文件，例如 order-shipped.blade.php。在这个文件中，你可以像构建普通 HTML 页面一样编写邮件内容，包括使用
标签、CSS 样式等。
resources/views/emails/order-shipped.blade.php 示例：
您的订单已发货！ body { font-family: Arial, sans-serif; line-height: 1.6; color: #333; } .container { max-width: 600px; margin: 0 auto; padding: 20px; border: 1px solid #ddd; border-radius: 5px; } .header { background-color: #f8f8f8; padding: 10px; text-align: center; } .content { padding: 20px 0; } .footer { text-align: center; font-size: 0.8em; color: #666; margin-top: 20px; }
步骤三：在 Mailable 类中配置视图和数据
编辑 app/Mail/OrderShipped.php 文件，在 build 方法中指定使用的 Blade 视图，并传递所需的数据。
app/Mail/OrderShipped.php 示例：
name = $name; $this->orderCode = $orderCode; $this->trackingNumber = $trackingNumber; $this->deliveryDate = $deliveryDate; $this->orderUrl = $orderUrl; } /** * 获取消息的信封。 */ public function envelope(): Envelope { return new Envelope( subject: '您的订单已发货！', ); } /** * 获取消息的内容定义。 */ public function content(): Content { return new Content( view: 'emails.order-shipped', // 指定 Blade 视图 with: [ // 传递给视图的数据 'name' => $this->name, 'orderCode' => $this->orderCode, 'trackingNumber' => $this->trackingNumber, 'deliveryDate' => $this->deliveryDate, 'orderUrl' => $this->orderUrl, ], ); } /** * 获取消息的附件。 * * @return array */ public function attachments(): array { return []; }}
步骤四：发送邮件
在你的控制器、服务或任何需要发送邮件的地方，使用 Mail Facade 来发送 Mailable 实例。
控制器发送邮件示例：
send(new OrderShipped( $userName, $orderCode, $trackingNumber, $deliveryDate, $orderUrl )); return response()->json(['message' => '订单发货通知已发送！']); }}
通过这种方式，Laravel 会自动将邮件内容渲染为 HTML，并设置正确的 Content-Type 头部，确保
等 HTML 标签能够被邮件客户端正确解析和显示。
2. 直接构建 HTML 字符串并发送 (非推荐但可行)
如果你确实需要直接构建一个包含 HTML 的字符串作为邮件内容，而不是使用 Blade 模板，Laravel 也提供了方法来处理。但请注意，这种方式可维护性较低，且容易出错。
在 Laravel 10+ 版本中，你可以使用 Mail::html() 方法来发送一个原始的 HTML 字符串。
示例代码：
input('name', '用户'); $code = $request->input('code', 'XYZ123'); // 直接构建包含 HTML 标签的字符串 $mes2 = "这是一段文本，"; $mes3 = "需要新的一行。"; $mes4 = "代码是：" . $code; $mes5 = "姓名是：" . $name; $mes6 = "这是最后一行文本。"; $htmlContent = $mes2 . "
" . $mes3 . "
" . $mes4 . "
" . $mes5 . "
" . $mes6; Mail::to('recipient@example.com') ->subject('原始 HTML 邮件测试') ->html($htmlContent) // 使用 html() 方法发送 HTML 字符串 ->send(); return response()->json(['message' => '原始 HTML 邮件已发送！']); }}
使用 ->html($htmlContent) 方法时，Laravel 会将 $htmlContent 视为 HTML 内容，并自动设置 Content-Type: text/html 头部。
注意事项与最佳实践
邮件客户端兼容性： 不同的邮件客户端（如 Gmail, Outlook, Apple Mail）对 HTML 和 CSS 的支持程度不一。尽量使用简单、标准的 HTML 结构和内联 CSS，以确保最佳兼容性。避免复杂的 JavaScript 或外部样式表。CSS 内联： 许多邮件客户端会剥离 标签中的 CSS。为了确保样式生效，推荐使用工具（如 Juice 或 Laravel 的 CSS Inliner 包）将 CSS 样式内联到 HTML 元素的 style 属性中。测试： 在发送生产环境邮件之前，务必在多种主流邮件客户端（包括桌面、网页和移动端）上进行充分测试，以验证邮件的显示效果。避免直接拼接： 尽管 Mail::html() 可以发送原始 HTML 字符串，但强烈建议优先使用 Mailable 类配合 Blade 模板。这种方式不仅结构清晰、易于管理，还能更好地利用 Laravel 的邮件队列、Markdown 邮件等高级功能。
总结
解决 Laravel 邮件内容中
标签不换行或内容被截断的问题，核心在于确保邮件被正确识别为 HTML 格式。在 Laravel 中，最优雅和推荐的解决方案是利用 Mailable 类和 Blade 模板来构建邮件。通过这种方式，Laravel 会自动处理 Content-Type: text/html 头部，确保你的邮件内容能够以预期的格式呈现在收件人面前。如果特殊情况下需要直接发送 HTML 字符串，可以使用 Mail::html() 方法，但请务必注意其潜在的维护性问题。遵循这些最佳实践，可以显著提升邮件的用户体验和专业性。
以上就是在 Laravel 中发送 HTML 邮件并解决内容换行与格式显示问题的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1335254.html
微信扫一扫 
支付宝扫一扫 
