本教程旨在解决laravel邮件中html标签（如`
`）不被正确渲染的问题，导致邮件内容显示异常。核心在于确保邮件被明确声明为html格式。我们将详细讲解如何在laravel应用中配置和发送html邮件，确保内容结构清晰、换行符正常显示，并提供最佳实践。
理解HTML邮件的渲染机制
当我们在邮件内容中使用
等HTML标签来控制格式时，如果邮件客户端没有将其识别为HTML，这些标签就会被当作普通文本显示出来，或者像某些服务（如Google）那样，因为无法解析而将其视为无效内容并进行截断（例如显示“…”）。
邮件客户端在接收邮件时，会根据邮件头部中的Content-Type字段来判断邮件体的格式。
如果Content-Type是text/plain，则邮件内容将被视为纯文本，所有HTML标签都会直接显示或被忽略。如果Content-Type是text/html，则邮件内容将被视为HTML文档，邮件客户端会尝试解析并渲染其中的HTML标签，包括
、、
等。
因此，问题的核心在于确保我们发送的邮件明确告知接收方，其内容是HTML格式。
解决方案：明确声明邮件内容为HTML
要解决HTML标签不被解析的问题，关键在于在邮件的HTTP头部中添加Content-Type: text/html; charset=utf-8。这会指示邮件客户端将邮件体作为HTML文档进行渲染。
立即学习“前端免费学习笔记（深入）”；
在Laravel中，有多种优雅的方式可以实现这一点，而无需手动管理头部信息。
在Laravel中实现HTML邮件发送
Laravel提供了强大的Mailable类和Blade模板系统，使得发送HTML邮件变得非常简单和高效。
1. 使用Mailable类和Blade模板（推荐方式）
这是Laravel官方推荐的发送HTML邮件的方式。通过Mailable类，您可以将邮件的逻辑、视图和数据封装在一起，Laravel会自动处理Content-Type头部设置。
步骤一：创建Mailable类
使用Artisan命令创建一个新的Mailable类：
php artisan make:mail MyHtmlMail
这会在app/Mail目录下生成MyHtmlMail.php文件。
步骤二：配置Mailable类
在MyHtmlMail.php中，我们将定义邮件的主题和内容。我们通过构造函数传递数据，并在content()方法中指定Blade模板和要传递给模板的数据。
mailData = $mailData; } /** * 获取消息信封。 */ public function envelope(): Envelope { return new Envelope( subject: '您的重要通知', // 邮件主题 ); } /** * 获取消息内容定义。 */ public function content(): Content { return new Content( html: 'emails.my_html_mail', // 指定Blade模板路径 with: [ 'name' => $this->mailData['name'], 'code' => $this->mailData['code'], 'message2' => $this->mailData['message2'], 'message3' => $this->mailData['message3'], ], ); } /** * 对于Laravel 9.x之前的版本，可以使用build方法： * public function build() * { * return $this->view('emails.my_html_mail') * ->with([ * 'name' => $this->mailData['name'], * 'code' => $this->mailData['code'], * 'message2' => $this->mailData['message2'], * 'message3' => $this->mailData['message3'], * ]); * } */}
步骤三：创建Blade邮件模板
在resources/views/emails目录下创建my_html_mail.blade.php文件。在这个模板中，您可以像构建任何其他HTML页面一样构建邮件内容，并使用Blade语法插入数据。
重要通知 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 { font-size: 0.9em; color: #777; text-align: center; margin-top: 20px; }
步骤四：发送邮件
在您的控制器或服务中，使用Mail Facade发送Mailable实例：
use IlluminateSupportFacadesMail;use AppMailMyHtmlMail;use IlluminateHttpRequest;class SomeController extends Controller{ public function sendNotification(Request $request) { $name = $request->input('name', '默认用户'); $code = $request->input('code', 'XYZ789'); $mes2 = "这是一段重要的信息。"; $mes3 = "这是另一段重要的信息。"; $mailData = [ 'name' => $name, 'code' => $code, 'message2' => $mes2, 'message3' => $mes3, ]; Mail::to('recipient@example.com') ->send(new MyHtmlMail($mailData)); return "邮件已成功发送！"; }}
通过这种方式，Laravel会自动将邮件的Content-Type设置为text/html，确保您的HTML标签（包括
）能够正确解析和显示。
2. 直接构建HTML字符串发送（不推荐，但了解原理）
如果您确实需要直接构建一个HTML字符串，并且不使用Blade模板，Laravel也提供了Mail::html()方法。这个方法会确保邮件被发送为HTML格式。
use IlluminateSupportFacadesMail;// ...$name = '示例用户';$code = 'ABC123XYZ';$mes2 = "loretmtext,";$mes3 = "loremtext";// 直接构建HTML字符串$htmlContent = "{$mes2}
{$mes3}
Code: {$code}
e: {$name}
text
";Mail::to('recipient@example.com')->html($htmlContent);
请注意，尽管这种方法能够解决换行问题，但它缺乏Blade模板提供的结构化、可维护性和安全性，因此在实际项目中不建议作为首选。
注意事项与最佳实践
始终使用Blade模板：Mailable类结合Blade模板是Laravel发送HTML邮件的最佳实践。它提供了清晰的结构、数据绑定、布局继承等特性，极大地提高了邮件内容的可维护性和开发效率。内联CSS：邮件客户端对外部样式表和某些高级CSS属性的支持有限。为了确保邮件在各种客户端中显示一致，强烈建议使用内联CSS。可以使用工具（如juice）将外部CSS自动转换为内联样式，或者在Blade模板中直接编写标签内的样式。避免过度复杂：邮件客户端的渲染引擎通常不如现代浏览器强大。避免使用复杂的JavaScript、动画或高级CSS（如flexbox、grid），以确保兼容性。多客户端测试：在发送生产环境邮件之前，务必在主流的邮件客户端（如Gmail、Outlook、Apple Mail、Thunderbird等）中进行测试，以确保显示效果符合预期。提供纯文本替代：为了兼容不支持HTML的客户端或提高可访问性，Mailable类允许您同时提供一个纯文本版本的邮件。例如，在Mailable的content()方法中添加text: ’emails.my_text_mail’。安全考虑：如果邮件内容包含用户输入，务必进行适当的转义，以防止跨站脚本（XSS）攻击。Blade模板默认会对通过{{ $variable }}输出的内容进行HTML实体转义，这有助于提高安全性。
总结
在Laravel中发送HTML格式的邮件并确保换行符及其他HTML标签正确显示，核心在于明确告知邮件客户端邮件内容为HTML格式。通过利用Laravel强大的Mailable类和Blade模板系统，我们可以优雅、高效地实现这一目标。这不仅解决了诸如Google邮件截断内容的问题，还为构建美观、结构清晰且易于维护的邮件提供了最佳实践。遵循上述指南和最佳实践，您将能够创建出在各种邮件客户端中都能良好呈现的专业邮件。
以上就是在Laravel中发送HTML格式邮件：确保换行符和内容正确显示的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1334688.html
微信扫一扫 
支付宝扫一扫 
