本教程旨在解决laravel邮件中html标签（如`
`）不被正确渲染的问题，导致邮件内容显示异常。核心在于确保邮件被明确声明为html格式。我们将详细讲解如何在laravel应用中配置和发送html邮件，确保内容结构清晰、换行符正常显示，并提供最佳实践。
理解HTML邮件的渲染机制
当我们在邮件内容中使用
等HTML标签来控制格式时，如果邮件客户端没有将其识别为HTML，这些标签就会被当作普通文本显示出来，或者像某些服务（如Google）那样，因为无法解析而将其视为无效内容并进行截断（例如显示“...”）。
邮件客户端在接收邮件时，会根据邮件头部中的Content-Type字段来判断邮件体的格式。
- 如果Content-Type是text/plain，则邮件内容将被视为纯文本，所有HTML标签都会直接显示或被忽略。
- 如果Content-Type是text/html，则邮件内容将被视为HTML文档，邮件客户端会尝试解析并渲染其中的HTML标签，包括
、、等。
因此，问题的核心在于确保我们发送的邮件明确告知接收方，其内容是HTML格式。
解决方案：明确声明邮件内容为HTML
要解决HTML标签不被解析的问题，关键在于在邮件的HTTP头部中添加Content-Type: text/html; charset=utf-8。这会指示邮件客户端将邮件体作为HTML文档进行渲染。
立即学习“前端免费学习笔记（深入）”；
在Laravel中，有多种优雅的方式可以实现这一点，而无需手动管理头部信息。
在Laravel中实现HTML邮件发送
Laravel提供了强大的Mailable类和Blade模板系统，使得发送HTML邮件变得非常简单和高效。
1. 使用Mailable类和Blade模板（推荐方式）
这是Laravel官方推荐的发送HTML邮件的方式。通过Mailable类，您可以将邮件的逻辑、视图和数据封装在一起，Laravel会自动处理Content-Type头部设置。
步骤一：创建Mailable类
使用Artisan命令创建一个新的Mailable类：
php artisan make:mail MyHtmlMail
这会在app/Mail目录下生成MyHtmlMail.php文件。
步骤二：配置Mailable类
在MyHtmlMail.php中，我们将定义邮件的主题和内容。我们通过构造函数传递数据，并在content()方法中指定Blade模板和要传递给模板的数据。
mailData = $mailData;
}
/**
* 获取消息信封。
*/
public function envelope(): Envelope
{
return new Envelope(
subject: '您的重要通知', // 邮件主题
);
}
/**
* 获取消息内容定义。
*/
public function content(): Content
{
return new Content(
html: 'emails.my_html_mail', // 指定Blade模板路径
with: [
'name' => $this->mailData['name'],
'code' => $this->mailData['code'],
'message2' => $this->mailData['message2'],
'message3' => $this->mailData['message3'],
],
);
}
/**
* 对于Laravel 9.x之前的版本，可以使用build方法：
* public function build()
* {
* return $this->view('emails.my_html_mail')
* ->with([
* 'name' => $this->mailData['name'],
* 'code' => $this->mailData['code'],
* 'message2' => $this->mailData['message2'],
* 'message3' => $this->mailData['message3'],
* ]);
* }
*/
}步骤三：创建Blade邮件模板
在resources/views/emails目录下创建my_html_mail.blade.php文件。在这个模板中，您可以像构建任何其他HTML页面一样构建邮件内容，并使用Blade语法插入数据。
重要通知
步骤四：发送邮件
在您的控制器或服务中，使用Mail Facade发送Mailable实例：
use Illuminate\Support\Facades\Mail;
use App\Mail\MyHtmlMail;
use Illuminate\Http\Request;
class SomeController extends Controller
{
public function sendNotification(Request $request)
{
$name = $request->input('name', '默认用户');
$code = $request->input('code', 'XYZ789');
$mes2 = "这是一段重要的信息。";
$mes3 = "这是另一段重要的信息。";
$mailData = [
'name' => $name,
'code' => $code,
'message2' => $mes2,
'message3' => $mes3,
];
Mail::to('recipient@example.com')
->send(new MyHtmlMail($mailData));
return "邮件已成功发送！";
}
}通过这种方式，Laravel会自动将邮件的Content-Type设置为text/html，确保您的HTML标签（包括
）能够正确解析和显示。
2. 直接构建HTML字符串发送（不推荐，但了解原理）
如果您确实需要直接构建一个HTML字符串，并且不使用Blade模板，Laravel也提供了Mail::html()方法。这个方法会确保邮件被发送为HTML格式。
use Illuminate\Support\Facades\Mail;
// ...
$name = '示例用户';
$code = 'ABC123XYZ';
$mes2 = "loretmtext,";
$mes3 = "loremtext";
// 直接构建HTML字符串
$htmlContent = "
{$mes2}
{$mes3}
Code: {$code}
e: {$name}
text
";
Mail::to('recipient@example.com')->html($htmlContent);请注意，尽管这种方法能够解决换行问题，但它缺乏Blade模板提供的结构化、可维护性和安全性，因此在实际项目中不建议作为首选。
注意事项与最佳实践
- 始终使用Blade模板：Mailable类结合Blade模板是Laravel发送HTML邮件的最佳实践。它提供了清晰的结构、数据绑定、布局继承等特性，极大地提高了邮件内容的可维护性和开发效率。
- 内联CSS：邮件客户端对外部样式表和某些高级CSS属性的支持有限。为了确保邮件在各种客户端中显示一致，强烈建议使用内联CSS。可以使用工具（如juice）将外部CSS自动转换为内联样式，或者在Blade模板中直接编写
- 避免过度复杂：邮件客户端的渲染引擎通常不如现代浏览器强大。避免使用复杂的JavaScript、动画或高级CSS（如flexbox、grid），以确保兼容性。
- 多客户端测试：在发送生产环境邮件之前，务必在主流的邮件客户端（如Gmail、Outlook、Apple Mail、Thunderbird等）中进行测试，以确保显示效果符合预期。
- 提供纯文本替代：为了兼容不支持HTML的客户端或提高可访问性，Mailable类允许您同时提供一个纯文本版本的邮件。例如，在Mailable的content()方法中添加text: 'emails.my_text_mail'。
- 安全考虑：如果邮件内容包含用户输入，务必进行适当的转义，以防止跨站脚本（XSS）攻击。Blade模板默认会对通过{{ $variable }}输出的内容进行HTML实体转义，这有助于提高安全性。
总结
在Laravel中发送HTML格式的邮件并确保换行符及其他HTML标签正确显示，核心在于明确告知邮件客户端邮件内容为HTML格式。通过利用Laravel强大的Mailable类和Blade模板系统，我们可以优雅、高效地实现这一目标。这不仅解决了诸如Google邮件截断内容的问题，还为构建美观、结构清晰且易于维护的邮件提供了最佳实践。遵循上述指南和最佳实践，您将能够创建出在各种邮件客户端中都能良好呈现的专业邮件。
