在laravel中发送包含html标签（如`
`）的邮件时，若内容无法正确换行或被截断，通常是因为邮件客户端将其识别为纯文本。核心解决方案是确保邮件头部明确设置`content-type: text/html`。本文将指导您如何在laravel中利用mailable类或`mail::html()`方法正确发送html格式邮件，从而实现预期的内容渲染和换行效果。
邮件换行问题的根源分析
当您尝试在邮件正文中使用HTML标签（例如
用于换行）时，如果邮件客户端未能正确渲染这些标签，而是将其作为普通文本显示，或者内容被意外截断，这通常意味着邮件被识别为纯文本格式。
邮件客户端通过邮件头部的Content-Type字段来判断邮件内容的格式。如果此字段缺失或被设置为text/plain，即使邮件内容中包含HTML标签，客户端也会将其视为纯文本进行解析，从而导致HTML标签失效。例如，
标签会直接显示出来，而不是产生换行效果。要使HTML标签生效，必须明确告知邮件客户端内容是text/html格式。
Laravel中的解决方案
Laravel提供了一套强大且灵活的邮件发送机制，可以轻松处理HTML格式的邮件。以下是两种主要的解决方案：
方案一：使用Mailable类和Blade模板（推荐）
这是Laravel官方推荐的发送复杂或结构化HTML邮件的方式。Mailable类结合Blade模板，能够提供清晰的代码结构、易于维护，并且Laravel会自动处理必要的Content-Type: text/html头部。
立即学习“前端免费学习笔记（深入）”；
1. 创建Mailable类： 首先，使用Artisan命令创建一个新的Mailable类：
php artisan make:mail MyHtmlMail
这会在app/Mail目录下生成MyHtmlMail.php文件。
2. 定义Mailable内容： 在生成的MyHtmlMail类中，您可以定义邮件的主题、视图等。在build方法中，指定用于渲染邮件内容的Blade模板。
// app/Mail/MyHtmlMail.php
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
class MyHtmlMail extends Mailable
{
use Queueable, SerializesModels;
public $mailData; // 用于传递到视图的数据
/**
* 创建一个新的消息实例。
*
* @param array $mailData
* @return void
*/
public function __construct(array $mailData)
{
$this->mailData = $mailData;
}
/**
* 构建消息。
*
* @return $this
*/
public function build()
{
return $this->subject('您的HTML测试邮件')
->view('emails.my-html-mail'); // 指定Blade模板
}
}3. 创建Blade模板：
在resources/views/emails目录下创建my-html-mail.blade.php文件。在这个文件中，您可以像编写普通HTML一样编写邮件内容，包括使用
标签进行换行。Laravel会自动将此Blade模板渲染为HTML，并确保邮件以HTML格式发送。
{{-- resources/views/emails/my-html-mail.blade.php --}}
HTML邮件
4. 发送邮件： 在您的控制器或服务中，实例化Mailable类并使用Mail Facade发送邮件：
use App\Mail\MyHtmlMail;
use Illuminate\Support\Facades\Mail;
use Illuminate\Http\Request;
// ... 在某个方法中 ...
public function sendTestEmail(Request $request)
{
$name = $request->input('name', '访客');
$code = $request->input('code', 'XYZ123');
$mailData = [
'name' => $name,
'code' => $code,
];
Mail::to('recipient@example.com')->send(new MyHtmlMail($mailData));
return "HTML邮件已发送！";
}方案二：直接发送HTML字符串（适用于简单场景）
如果您需要发送一个简单的、直接构建的HTML字符串，而不希望创建单独的Blade模板，Laravel的Mail::html()方法是您的选择。此方法会自动设置邮件的Content-Type: text/html头部。
use Illuminate\Support\Facades\Mail;
use Illuminate\Http\Request;
// ... 在某个方法中 ...
public function sendDirectHtmlEmail(Request $request)
{
$name = $request->input('name', '访客');
$code = $request->input('code', 'XYZ123');
// 构造HTML字符串，使用
进行换行
$mes2 = "尊敬的 ".$name."，";
$mes3 = "这是一封直接发送的HTML邮件。";
$mes4 = "您的验证码是：".$code."";
$mes5 = "请尽快使用。";
$mes6 = "感谢您的支持！";
$htmlContent = $mes2."
".$mes3."
".$mes4."
".$mes5."
".$mes6."
";
Mail::to('recipient@example.com')
->subject('直接HTML邮件测试')
->html($htmlContent); // 使用html()方法发送HTML字符串
return "直接HTML邮件已发送！";
}避免的常见误区：Mail::raw()
请注意，Laravel提供了Mail::raw()方法，用于发送纯文本邮件。如果您将包含HTML标签的字符串传递给Mail::raw()，即使内容包含
，邮件客户端也会将其视为纯文本，导致标签不会被渲染。因此，发送HTML内容时，切勿使用Mail::raw()。
注意事项与最佳实践
- 安全性： 如果您在邮件内容中嵌入了用户提供的数据，务必进行适当的转义和验证，以防止跨站脚本（XSS）攻击。Laravel Blade模板默认会对输出内容进行转义，这有助于防止XSS。
- 兼容性： 不同的邮件客户端（如Gmail、Outlook、Apple Mail等）对HTML和CSS的支持程度各异。建议使用内联CSS，并避免使用复杂的CSS属性、JavaScript或外部样式表，以确保邮件在大多数客户端中都能正确显示。发送测试邮件到不同的邮箱服务进行验证是必不可少的步骤。
- 可维护性： 对于结构复杂或需要频繁修改的邮件，强烈推荐使用Mailable类和Blade模板。它能提高代码的可读性和可维护性。
- 纯文本备用： 为了增强邮件的可达性和兼容性，Mailable类还允许您同时提供一个纯文本版本的邮件。当收件人的邮件客户端不支持HTML时，可以显示纯文本版本。您可以在Mailable的build方法中通过text('emails.my-text-mail')来指定一个纯文本视图。
总结
在Laravel中解决邮件内容换行显示异常的关键在于确保邮件头部正确设置Content-Type: text/html。最推荐且最强大的方法是利用Laravel的Mailable类结合Blade模板，它不仅能自动处理HTML头部，还能提供结构化的邮件管理。对于简单场景，Mail::html()方法可以直接发送HTML字符串。通过遵循这些实践，您可以确保您的Laravel应用发送的邮件能够以预期的格式和布局呈现在收件人面前。
