本教程旨在解决在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.php
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
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标签，包括
或
来创建换行。
邮件通知
您好，{{ $details['name'] }}！
这是一封包含重要信息的邮件。
您的代码是：{{ $details['code'] }}
以下是更多详细信息：
第一行内容。
第二行内容，这里使用了HTML换行符。
第三行内容。
感谢您的关注。
请注意，在Blade模板中，{{ $variable }} 语法会自动对变量进行HTML实体转义，以防止跨站脚本攻击（XSS）。如果您需要输出未转义的HTML，可以使用 {!! $variable !!}，但请务必确保内容是安全的。
步骤四：发送邮件
在您的控制器、服务或任何需要发送邮件的地方，使用 Mail Facade 来发送您创建的Mailable实例：
use App\Mail\MyHtmlMail;
use Illuminate\Support\Facades\Mail;
use Illuminate\Http\Request;
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头部，从而确保您的
标签能够被正确解析和显示。遵循最佳实践，如内容安全、响应式设计和全面测试，将有助于您创建专业且用户体验良好的邮件通知。
