本教程详细阐述了在 laravel 应用程序中发送包含 html 格式内容（如换行符 `
`）的电子邮件时，如何确保邮件客户端正确解析。核心在于通过 laravel 的 mailable 类或直接设置邮件头，明确指定 `content-type: text/html`，从而避免内容被错误解析为纯文本或被截断的问题。
理解邮件内容类型与换行符问题
在构建电子邮件内容时，开发者常常希望通过 HTML 标签（例如
）来实现文本的格式化和换行。然而，如果电子邮件客户端将邮件内容识别为纯文本（text/plain），那么所有 HTML 标签，包括
，都将被视为普通字符串而直接显示出来，或者被邮件客户端忽略，导致内容显示混乱甚至被截断。
例如，以下 PHP 代码片段中直接拼接 HTML 标签：
$mes2 = "loretmtext,"; $mes3 = "loremtext"; $mes4 = "Code:".$code; $mes5 = "e:".$name; $mes6 = "text"; $msg = $mes2."
".$mes3."
".$mes4."
".$mes5."
".$mes6."
"; // 假设 $msg 被直接发送
如果发送此 $msg 时未明确指定邮件的 Content-Type 为 text/html，邮件客户端会将其默认为纯文本，从而无法正确渲染
标签。要解决此问题，关键在于告知邮件客户端邮件体是 HTML 格式。
Laravel Mailable：发送 HTML 邮件的最佳实践
Laravel 提供了一个强大且优雅的 Mailable 系统来构建和发送邮件。使用 Mailable 类和 Blade 模板是发送 HTML 邮件并确保正确渲染的最佳实践，因为它会自动处理 Content-Type: text/html 头部设置。
立即学习“前端免费学习笔记（深入）”；
示例：创建和发送 HTML 邮件
以下步骤将指导您如何在 Laravel 中创建一个包含换行符和其他 HTML 格式的邮件。
步骤一：生成 Mailable 类
首先，使用 Artisan 命令生成一个新的 Mailable 类。
php artisan make:mail MyHtmlMail
这将在 app/Mail 目录下创建一个 MyHtmlMail.php 文件。
步骤二：定义邮件视图 (Blade 模板)
接下来，创建一个 Blade 模板来定义您的 HTML 邮件内容。Blade 模板允许您使用 HTML 标签，并且可以动态插入数据。
在 resources/views/emails/my-html-message.blade.php 创建以下文件：
重要通知
尊敬的 {{ $name }}，您好！
这是一段包含多行内容的通知邮件。
您的操作验证码是：{{ $code }}
请在规定时间内使用此验证码完成操作。此邮件由系统自动发送，请勿直接回复。
感谢您的使用！
在这个模板中，我们使用了
标签实现段落换行，并且通过 {{ $name }} 和 {{ $code }} 动态插入数据。
步骤三：配置 Mailable 类
编辑 app/Mail/MyHtmlMail.php 文件，将其配置为使用您创建的 Blade 模板，并传入所需的数据。
name = $name;
$this->code = $code;
}
/**
* 构建消息。
*
* @return $this
*/
public function build()
{
return $this->subject('您的重要通知') // 设置邮件主题
->view('emails.my-html-message') // 指定使用的 Blade 模板
->with([ // 传递数据到模板
'name' => $this->name,
'code' => $this->code,
]);
}
}在 build() 方法中，->view('emails.my-html-message') 明确告诉 Laravel 使用该 Blade 模板来渲染邮件内容。Laravel 会自动将其渲染为 HTML，并设置正确的 Content-Type: text/html 头部。
步骤四：发送邮件
最后，在您的控制器或任何需要发送邮件的地方，使用 Mail Facade 来发送您的 Mailable 实例。
input('name', '用户');
$verificationCode = $request->input('code', '123456');
$recipientEmail = $request->input('email', 'recipient@example.com'); // 收件人邮箱
try {
Mail::to($recipientEmail)->send(new MyHtmlMail($userName, $verificationCode));
return response()->json(['message' => 'HTML 邮件已成功发送！'], 200);
} catch (\Exception $e) {
return response()->json(['message' => '邮件发送失败：' . $e->getMessage()], 500);
}
}
}通过以上步骤，当 Mail::to(...)->send(new MyHtmlMail(...)) 被调用时，Laravel 会自动渲染 my-html-message.blade.php 模板，将其作为 HTML 邮件体发送，并确保邮件客户端正确解析其中的 HTML 标签，包括换行符。
直接设置邮件头（不推荐在 Laravel 中使用）
虽然 Laravel 的 Mailable 系统是推荐的方式，但了解底层原理有助于理解。如果是在纯 PHP 环境下，或者需要自定义 Laravel Mailable 无法直接满足的特殊头部，则需要手动设置 Content-Type 头部。
// 这是一个纯 PHP 示例，不适用于 Laravel Mailable 的标准用法 $to = 'recipient@example.com'; $subject = 'HTML 邮件测试'; $message = '你好！
这是一段包含HTML内容的邮件。
这是第二行。
'; // 必须设置 Content-Type 头部 $headers = "MIME-Version: 1.0\r\n"; $headers .= "Content-type: text/html; charset=UTF-8\r\n"; $headers .= "From: sender@example.com\r\n"; // 发件人 // 使用 PHP 的 mail() 函数发送 // mail($to, $subject, $message, $headers);
在 Laravel 中，通常不需要手动设置这些头部，因为 Mailable 类会为您处理。
注意事项与最佳实践
- 使用 Blade 模板： 始终优先使用 Blade 模板来构建邮件内容。它们不仅能自动处理 HTML 渲染和 Content-Type 设置，还能提供更好的可维护性、代码结构和安全性（例如防止 XSS 攻击）。
- 内联 CSS： 许多邮件客户端对外部样式表和
- 响应式设计： 考虑到用户可能在手机上查看邮件，设计邮件模板时应考虑响应式布局，以提供良好的用户体验。
- 多客户端测试： 在发送重要邮件之前，务必在不同的邮件客户端（如 Gmail、Outlook、Apple Mail、Thunderbird 等）进行测试，以确保显示效果符合预期。
- 纯文本备用： 对于那些不支持 HTML 的邮件客户端或出于辅助功能考虑，Mailable 允许您通过 ->text('emails.my-plain-text-message') 方法提供一个纯文本版本。这会创建一个多部分邮件，其中包含 HTML 和纯文本两种版本，客户端会选择最适合的版本显示。
总结
在 Laravel 中发送包含 HTML 格式内容（如换行符
）的邮件，核心在于确保邮件客户端将邮件体解析为 HTML。通过利用 Laravel 强大的 Mailable 系统和 Blade 模板，您可以轻松实现这一点，因为 Mailable 会自动为您处理 Content-Type: text/html 头部。遵循使用模板、考虑内联 CSS 和进行多客户端测试等最佳实践，将有助于您构建出专业且兼容性强的电子邮件通知系统。
