本教程旨在解决在laravel应用中发送邮件时，html换行符（
）不生效的问题。核心在于确保邮件内容以html格式发送，而非纯文本。文章将指导您如何利用laravel的mailable系统和blade模板来正确构建和发送包含html格式的邮件，确保换行和其他样式能被邮件客户端正确解析和显示。
理解问题：为何
不生效？
当您在邮件内容中使用HTML标签如
来创建换行时，如果邮件客户端未能将其识别为HTML内容，它会将
视为普通的文本字符串，而不是一个换行指令。这通常发生在邮件被发送为纯文本（text/plain）格式时。在这种情况下，邮件客户端不会解析任何HTML标签，因此您的换行符将直接显示为文本“
”，而不是实际的换行。
为了让邮件客户端正确解析HTML标签并显示预期的换行效果，邮件服务提供商和客户端需要明确知道邮件的内容类型是HTML（text/html），而不是纯文本。
核心解决方案：指定邮件内容类型为HTML
解决此问题的关键在于在邮件请求的头部明确声明Content-Type: text/html。这个HTTP头告诉邮件客户端，邮件体中包含的是HTML标记，需要按照HTML规范进行渲染。
Laravel框架通过其Mailable类和Blade模板系统，极大地简化了HTML邮件的发送过程，通常会自动处理Content-Type的设置。
立即学习“前端免费学习笔记（深入）”；
在Laravel中实现HTML邮件发送
在Laravel中，发送HTML格式邮件并确保换行符正确显示的最佳实践是使用Mailable类结合Blade模板。
1. 推荐方式：使用Mailable类和Blade模板
这是Laravel官方推荐且最强大、最灵活的方式。Mailable类负责封装邮件的构建逻辑，而Blade模板则用于定义邮件的HTML结构和内容。
步骤一：创建Mailable类
使用Artisan命令生成一个新的Mailable类：
php artisan make:mail MyHtmlMail
这会在 app/Mail 目录下创建一个 MyHtmlMail.php 文件。
步骤二：定义Mailable内容
在 MyHtmlMail 类中，您可以定义邮件的主题、发送者以及最重要的——指定用于渲染邮件内容的Blade视图。
// app/Mail/MyHtmlMail.phpnamespace AppMail;use IlluminateBusQueueable;use IlluminateContractsQueueShouldQueue;use IlluminateMailMailable;use IlluminateQueueSerializesModels;class MyHtmlMail extends Mailable{ use Queueable, SerializesModels; public $details; // 用于存储邮件所需的数据 /** * 创建一个新的消息实例。 * * @param array $details 邮件数据 * @return void */ public function __construct(array $details) { $this->details = $details; } /** * 构建消息。 * * @return $this */ public function build() { return $this->subject('您的重要通知') // 设置邮件主题 ->view('emails.my_html_email'); // 指定Blade视图文件 }}
步骤三：创建Blade视图模板
在 resources/views/emails 目录下创建 my_html_email.blade.php 文件，并编写您的HTML邮件内容。在这个模板中，您可以像编写任何网页一样使用HTML标签，包括
或
来创建换行。
邮件通知 /* 您可以在这里添加内联CSS样式 */ body { font-family: Arial, sans-serif; line-height: 1.6; color: #333; } h1 { color: #0056b3; } strong { color: #d9534f; }您好，{{ $details['name'] }}！
这是一封包含重要信息的邮件。
您的代码是：{{ $details['code'] }}
以下是更多详细信息：
第一行内容。
第二行内容，这里使用了HTML换行符。
第三行内容。感谢您的关注。
请注意，在Blade模板中，{{ $variable }} 语法会自动对变量进行HTML实体转义，以防止跨站脚本攻击（XSS）。如果您需要输出未转义的HTML，可以使用 {!! $variable !!}，但请务必确保内容是安全的。
步骤四：发送邮件
在您的控制器、服务或任何需要发送邮件的地方，使用 Mail Facade 来发送您创建的Mailable实例：
use AppMailMyHtmlMail;use IlluminateSupportFacadesMail;use IlluminateHttpRequest;class NotificationController extends Controller{ public function sendNotification(Request $request) { $name = '张三'; // 示例数据 $code = $request->input('code', 'ABCDEF'); // 从请求获取或使用默认值 $mailData = [ 'name' => $name, 'code' => $code, 'message_line1' => '这是第一条消息。', 'message_line2' => '这是第二条消息。', ]; Mail::to('recipient@example.com') // 收件人邮箱 ->send(new MyHtmlMail($mailData)); return 'HTML邮件已成功发送！'; }}
当Laravel通过Mailable类发送邮件时，它会自动将邮件的Content-Type设置为text/html，从而确保您的
标签能够被正确解析。
2. 发送纯字符串HTML内容（不推荐但可行）
尽管不推荐用于复杂邮件或长期维护，但如果您确实需要直接发送一个HTML字符串作为邮件内容，Mailable类也提供了html()方法：
// 在Mailable的build方法中public function build(){ $name = $this->details['name']; $code = $this->details['code']; $mes2 = "lorem ipsum dolor sit amet,"; $mes3 = "consectetur adipiscing elit."; $mes4 = "Code: ".$code.""; // 注意这里也使用了HTML标签 $mes5 = "User: ".$name; $mes6 = "Sed do eiusmod tempor incididunt."; // 直接拼接HTML字符串 $msg = $mes2."
".$mes3."
".$mes4."
".$mes5."
".$mes6."
"; return $this->subject('您的通知') ->html($msg); // 直接传入HTML字符串}
注意事项：
这种方法不利于邮件内容的管理和样式化。手动拼接HTML字符串时，您需要特别注意数据安全，确保所有用户输入都经过了适当的HTML实体转义，以防止XSS攻击。Laravel Blade模板的{{ $variable }}会自动处理这一点。
注意事项与最佳实践
内容安全（XSS防护）： 永远不要直接将未经处理的用户输入插入到HTML邮件中。如果使用Blade模板，{{ $variable }}会自动进行HTML实体转义。如果手动拼接HTML字符串，请务必使用e()辅助函数或htmlspecialchars()函数对用户输入进行转义。响应式设计： 邮件客户端的渲染能力和标准差异很大。为了确保邮件在各种设备和客户端上都能良好显示，建议使用内联CSS，并考虑使用表格布局（而非Flexbox或Grid）来构建响应式邮件。全面测试： 在部署之前，务必在多个主流邮件客户端（如Gmail、Outlook、Apple Mail、Thunderbird等）以及移动设备上测试您的HTML邮件，以确保其显示效果符合预期。纯文本备用： 某些邮件客户端可能不支持HTML邮件，或者用户可能偏好纯文本邮件。Laravel的Mailable类允许您通过text()方法或创建.txt后缀的Blade视图来提供纯文本版本的邮件。
// 在Mailable的build方法中return $this->subject('您的通知') ->view('emails.my_html_email') // HTML视图 ->text('emails.my_text_email'); // 纯文本视图
Markdown Mailable： Laravel还提供了Markdown邮件功能，它允许您使用Markdown语法编写邮件内容，Laravel会自动将其渲染为美观的HTML邮件，并自动生成一个纯文本版本。这是一种兼顾易用性和功能性的好方法。
总结
在Laravel中发送带有正确换行符的HTML邮件，关键在于确保邮件客户端将内容识别为HTML格式。通过利用Laravel强大的Mailable类和Blade模板系统，您可以轻松地构建结构清晰、样式丰富的HTML邮件。Mailable类会自动为您处理Content-Type头部，从而确保您的
标签能够被正确解析和显示。遵循最佳实践，如内容安全、响应式设计和全面测试，将有助于您创建专业且用户体验良好的邮件通知。
以上就是解决Laravel邮件内容换行符不生效问题：发送HTML格式邮件指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1332185.html
微信扫一扫 
支付宝扫一扫 
