在Laravel中发送HTML格式邮件：确保换行符和内容正确显示
在Laravel开发中，发送邮件是常见的功能，尤其是当我们需要发送格式丰富的HTML邮件时，如何确保换行符、段落间距和内容正确显示，是一个容易被忽视但影响体验的细节。很多开发者在使用Mail类发送HTML邮件时，发现通过后端拼接的多行文本在邮件客户端中变成了连续的一行，或者换行符（如\n）没有生效。本文将详细分析原因，并给出在Laravel中正确处理换行符、确保HTML邮件内容显示正确的可行方案。
问题的根源
在HTML邮件中，浏览器或邮件客户端默认会忽略空白字符（包括换行符和多个空格）。当我们在Laravel的控制器或Mailable类中拼接一段多行文本，然后直接作为邮件内容时，这些换行符在HTML环境下会被忽略，从而造成内容挤在一起。例如，在控制器中写：
$message = "第一行内容\n第二行内容\n第三行内容";
Mail::send([], [], function ($m) use ($message) {
$m->to('user@ipipp.com')
->subject('测试邮件')
->setBody($message, 'text/html');
});收到的邮件中会显示为“第一行内容第二行内容第三行内容”，换行符丢失。这是因为邮件内容被当作纯文本HTML处理，而浏览器对HTML中的换行符没有渲染效果。
解决方案：将换行符转换为HTML的<br>标签
要让换行符在HTML邮件中正确显示，最直接的方法是将文本中的换行符替换为HTML的换行标签 <br>。Laravel本身没有提供自动转换原生字符串为HTML格式的方法，但PHP内置的 nl2br() 函数正好可以满足这个需求。
此外，如果邮件内容包含段落结构，建议使用 <p> 标签包裹，这样样式更加标准。下面我们来看具体的实现方式。
方法一：在控制器中手动转换
如果你直接在控制器中使用 Mail 的 send 方法发送邮件，可以在拼接内容后调用 nl2br() 函数。示例代码如下：
$plainText = "尊敬的客户：\n\n您好！\n感谢您使用我们的服务。\n\n您的订单已确认。";
$htmlContent = nl2br(e($plainText)); // e() 函数用于转义特殊字符，防止XSS
Mail::send([], [], function ($message) use ($htmlContent) {
$message->to('user@ipipp.com')
->subject('订单确认')
->setBody($htmlContent, 'text/html');
});注意：这里使用了 e() 辅助函数对原始文本进行HTML实体转义，避免用户输入中的特殊字符破坏邮件格式。但如果文本中原本就包含合法的HTML标签（比如加粗、斜体等），则需要谨慎处理。假设你信任该文本来源，可以省略 e()。
方法二：使用Mailable类，并在视图文件中处理
推荐的做法是使用Laravel的Mailable类搭配Blade视图来生成邮件内容。这样可以将逻辑和表现分离，也便于维护。首先创建一个Mailable类：
php artisan make:mail OrderConfirmation
在生成的 app/Mail/OrderConfirmation.php 中，定义邮件属性：
<?php
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
class OrderConfirmation extends Mailable
{
use Queueable, SerializesModels;
public $messageContent;
public function __construct($messageContent)
{
$this->messageContent = $messageContent;
}
public function build()
{
return $this->from('noreply@ipipp.com')
->subject('订单确认')
->view('emails.order-confirmation');
}
}然后创建对应的Blade视图文件 resources/views/emails/order-confirmation.blade.php：
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>订单确认</title>
</head>
<body>
<div>
{!! nl2br(e($messageContent)) !!}
</div>
</body>
</html>在视图文件中，使用 {!! !!} 语法输出不转义的HTML（因为我们使用了 nl2br 生成的 <br> 标签），同时用 e() 对原始内容进行转义，确保安全。如果 $messageContent 中本身包含需要保留的HTML标签（比如来自富文本编辑器），则不应转义，直接 {!! nl2br($messageContent) !!}。
最后在控制器中调用：
use App\Mail\OrderConfirmation;
use Illuminate\Support\Facades\Mail;
$message = "尊敬的客户：\n\n您好！\n感谢您使用我们的服务。\n\n您的订单已确认。";
Mail::to('user@ipipp.com')->send(new OrderConfirmation($message));方法三：直接使用 text/plain 和 text/html 双版本
某些邮件客户端可能不支持HTML，或者用户更偏好纯文本。Laravel Mail允许同时指定纯文本和HTML版本。我们可以让纯文本版本保留原始换行符，而HTML版本使用 nl2br 转换。Mailable类的 build 方法中可以通过 text() 方法指定纯文本视图。示例如下：
public function build()
{
return $this->from('noreply@ipipp.com')
->subject('订单确认')
->view('emails.order-confirmation-html')
->text('emails.order-confirmation-text');
}然后创建两个视图：emails/order-confirmation-html.blade.php（使用 nl2br）和 emails/order-confirmation-text.blade.php（直接输出 $messageContent，纯文本）。
其他注意事项
1. 避免在内容中直接使用原始换行符
在HTML邮件中，段落应该使用 <p> 或 <div> 包裹，而不是仅仅依靠 <br>。如果需要排版更精细，可以使用CSS内联样式，因为大多数邮件客户端会移除外部样式。
2. 处理用户输入的换行符
如果邮件内容来自用户输入（如评论、留言），建议在存储时保持原样，在显示时使用 nl2br(e($content)) 进行处理。注意，如果用户输入中包含恶意代码，e() 可以防止XSS攻击。
3. 邮件内容的编码
确保邮件内容使用UTF-8编码。在Laravel中，默认的字符集是UTF-8，一般不需要额外设置。
总结
在Laravel中发送HTML格式邮件时，换行符不显示的根本原因是HTML的特性忽略空白。通过 nl2br() 函数将换行符转换为 <br> 标签，可以轻松解决这个问题。同时，推荐使用Mailable类和Blade视图来组织邮件内容，保持代码清晰。如果邮件需要同时支持纯文本和HTML，可以使用双视图方案。掌握这些技巧后，你的邮件内容将不再出现格式错乱的问题。
希望本文能帮助你解决Laravel发送HTML邮件时换行符显示异常的困惑。如果你在实际开发中遇到其他问题，欢迎根据上述思路灵活调整。