在Laravel中发送HTML格式邮件：确保换行符和内容正确显示-php教程-PHP中文网

在Laravel中发送HTML格式邮件：确保换行符和内容正确显示

碧海醫心

发布： 2025-11-15 11:50:02

原创

620人浏览过

在Laravel中发送HTML格式邮件：确保换行符和内容正确显示

本教程旨在解决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文件。

Trae国内版

国内首款AI原生IDE，专为中国开发者打造

815

查看详情

步骤二：配置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>&copy; {{ 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邮件截断内容的问题，还为构建美观、结构清晰且易于维护的邮件提供了最佳实践。遵循上述指南和最佳实践，您将能够创建出在各种邮件客户端中都能良好呈现的专业邮件。

以上就是在Laravel中发送HTML格式邮件：确保换行符和内容正确显示的详细内容，更多请关注php中文网其它相关文章！