本教程旨在解决laravel邮件中html标签（如`
`）不被正确渲染的问题，导致邮件内容显示异常。核心在于确保邮件被明确声明为html格式。我们将详细讲解如何在laravel应用中配置和发送html邮件，确保内容结构清晰、换行符正常显示，并提供最佳实践。
理解HTML邮件的渲染机制
当我们在邮件内容中使用zuojiankuohaophpcnbr />等HTML标签来控制格式时，如果邮件客户端没有将其识别为HTML，这些标签就会被当作普通文本显示出来，或者像某些服务（如Google）那样，因为无法解析而将其视为无效内容并进行截断（例如显示“...”）。
邮件客户端在接收邮件时，会根据邮件头部中的Content-Type字段来判断邮件体的格式。
- 如果Content-Type是text/plain，则邮件内容将被视为纯文本，所有HTML标签都会直接显示或被忽略。
- 如果Content-Type是text/html，则邮件内容将被视为HTML文档，邮件客户端会尝试解析并渲染其中的HTML标签，包括<br />、<b>、<p>等。
因此，问题的核心在于确保我们发送的邮件明确告知接收方，其内容是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模板和要传递给模板的数据。
<?php
namespace App\Mail;
use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Mail\Mailables\Content;
use Illuminate\Mail\Mailables\Envelope;
use Illuminate\Queue\SerializesModels;
class MyHtmlMail extends Mailable
{
use Queueable, SerializesModels;
public $mailData; // 用于存储传递给邮件的数据
/**
* 创建一个新的消息实例。
*/
public function __construct(array $mailData)
{
$this->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语法插入数据。
<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>重要通知</title>
<style>
body { font-family: Arial, sans-serif; line-height: 1.6; color: #333; }
.container { max-width: 600px; margin: 0 auto; padding: 20px; border: 1px solid #ddd; border-radius: 5px; }
.header { background-color: #f8f8f8; padding: 10px; text-align: center; }
.content { padding: 20px 0; }
.footer { font-size: 0.9em; color: #777; text-align: center; margin-top: 20px; }
</style>
</head>
<body>
<div class="container">
<div class="header">
<h2>系统通知</h2>
</div>
<div class="content">
<p>您好，</p>
<p>这是一封来自系统的通知邮件，包含您的重要信息：</p>
<p>{{ $message2 }}</p>
<p>{{ $message3 }}</p>
<p><b>代码:</b> {{ $code }}</p>
<p><b>名称:</b> {{ $name }}</p>
<br>
<p>请妥善保管您的信息，如有疑问，请联系我们。</p>
</div>
<div class="footer">
<p>© {{ date('Y') }} 您的公司. All rights reserved.</p>
</div>
</div>
</body>
</html>步骤四：发送邮件
在您的控制器或服务中，使用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标签（包括<br />）能够正确解析和显示。
2. 直接构建HTML字符串发送（不推荐，但了解原理）
如果您确实需要直接构建一个HTML字符串，并且不使用Blade模板，Laravel也提供了Mail::html()方法。这个方法会确保邮件被发送为HTML格式。
use Illuminate\Support\Facades\Mail;
// ...
$name = '示例用户';
$code = 'ABC123XYZ';
$mes2 = "loretmtext,";
$mes3 = "loremtext";
// 直接构建HTML字符串
$htmlContent = "
<p>{$mes2}</p>
<p>{$mes3}</p>
<p>Code: {$code}</p>
<p>e: {$name}</p>
<p>text</p>
";
Mail::to('recipient@example.com')->html($htmlContent);请注意，尽管这种方法能够解决换行问题，但它缺乏Blade模板提供的结构化、可维护性和安全性，因此在实际项目中不建议作为首选。
注意事项与最佳实践
- 始终使用Blade模板：Mailable类结合Blade模板是Laravel发送HTML邮件的最佳实践。它提供了清晰的结构、数据绑定、布局继承等特性，极大地提高了邮件内容的可维护性和开发效率。
- 内联CSS：邮件客户端对外部样式表和某些高级CSS属性的支持有限。为了确保邮件在各种客户端中显示一致，强烈建议使用内联CSS。可以使用工具（如juice）将外部CSS自动转换为内联样式，或者在Blade模板中直接编写<style>标签内的样式。
- 避免过度复杂：邮件客户端的渲染引擎通常不如现代浏览器强大。避免使用复杂的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邮件截断内容的问题，还为构建美观、结构清晰且易于维护的邮件提供了最佳实践。遵循上述指南和最佳实践，您将能够创建出在各种邮件客户端中都能良好呈现的专业邮件。
