解决Laravel邮件内容换行符不生效问题：发送HTML格式邮件指南-php教程-PHP中文网

解决Laravel邮件内容换行符不生效问题：发送HTML格式邮件指南

聖光之護

发布： 2025-11-09 11:57:46

原创

875人浏览过

解决Laravel邮件内容换行符不生效问题：发送HTML格式邮件指南

本教程旨在解决在laravel应用中发送邮件时，html换行符（zuojiankuohaophpcnbr />）不生效的问题。核心在于确保邮件内容以html格式发送，而非纯文本。文章将指导您如何利用laravel的mailable系统和blade模板来正确构建和发送包含html格式的邮件，确保换行和其他样式能被邮件客户端正确解析和显示。

理解问题：为何 不生效？

当您在邮件内容中使用HTML标签如 来创建换行时，如果邮件客户端未能将其识别为HTML内容，它会将 视为普通的文本字符串，而不是一个换行指令。这通常发生在邮件被发送为纯文本（text/plain）格式时。在这种情况下，邮件客户端不会解析任何HTML标签，因此您的换行符将直接显示为文本“ ”，而不是实际的换行。

为了让邮件客户端正确解析HTML标签并显示预期的换行效果，邮件服务提供商和客户端需要明确知道邮件的内容类型是HTML（text/html），而不是纯文本。

核心解决方案：指定邮件内容类型为HTML

解决此问题的关键在于在邮件请求的头部明确声明Content-Type: text/html。这个HTTP头告诉邮件客户端，邮件体中包含的是HTML标记，需要按照HTML规范进行渲染。

Laravel框架通过其Mailable类和Blade模板系统，极大地简化了HTML邮件的发送过程，通常会自动处理Content-Type的设置。

立即学习“前端免费学习笔记（深入）”；

在Laravel中实现HTML邮件发送

在Laravel中，发送HTML格式邮件并确保换行符正确显示的最佳实践是使用Mailable类结合Blade模板。

1. 推荐方式：使用Mailable类和Blade模板

这是Laravel官方推荐且最强大、最灵活的方式。Mailable类负责封装邮件的构建逻辑，而Blade模板则用于定义邮件的HTML结构和内容。

步骤一：创建Mailable类

使用Artisan命令生成一个新的Mailable类：

php artisan make:mail MyHtmlMail

登录后复制

这会在 app/Mail 目录下创建一个 MyHtmlMail.php 文件。

步骤二：定义Mailable内容

AI建筑知识问答

用人工智能ChatGPT帮你解答所有建筑问题

查看详情

在 MyHtmlMail 类中，您可以定义邮件的主题、发送者以及最重要的——指定用于渲染邮件内容的Blade视图。

// app/Mail/MyHtmlMail.php
namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;

class MyHtmlMail extends Mailable
{
    use Queueable, SerializesModels;

    public $details; // 用于存储邮件所需的数据

    /**
     * 创建一个新的消息实例。
     *
     * @param array $details 邮件数据
     * @return void
     */
    public function __construct(array $details)
    {
        $this->details = $details;
    }

    /**
     * 构建消息。
     *
     * @return $this
     */
    public function build()
    {
        return $this->subject('您的重要通知') // 设置邮件主题
                    ->view('emails.my_html_email'); // 指定Blade视图文件
    }
}

登录后复制

步骤三：创建Blade视图模板

在 resources/views/emails 目录下创建 my_html_email.blade.php 文件，并编写您的HTML邮件内容。在这个模板中，您可以像编写任何网页一样使用HTML标签，包括 或 来创建换行。

<!DOCTYPE html>
<html>
<head>
    <title>邮件通知</title>
    <style>
        /* 您可以在这里添加内联CSS样式 */
        body { font-family: Arial, sans-serif; line-height: 1.6; color: #333; }
        h1 { color: #0056b3; }
        strong { color: #d9534f; }
    </style>
</head>
<body>
    <h1>您好，{{ $details['name'] }}！</h1>
    <p>这是一封包含重要信息的邮件。</p>
    <p>您的代码是：<strong>{{ $details['code'] }}</strong></p>
    <p>以下是更多详细信息：</p>
    <p>
        第一行内容。<br>
        第二行内容，这里使用了HTML换行符。<br>
        第三行内容。
    </p>
    <p>感谢您的关注。</p>
</body>
</html>

登录后复制

请注意，在Blade模板中，{{ $variable }} 语法会自动对变量进行HTML实体转义，以防止跨站脚本攻击（XSS）。如果您需要输出未转义的HTML，可以使用 {!! $variable !!}，但请务必确保内容是安全的。

步骤四：发送邮件

在您的控制器、服务或任何需要发送邮件的地方，使用 Mail Facade 来发送您创建的Mailable实例：

use App\Mail\MyHtmlMail;
use Illuminate\Support\Facades\Mail;
use Illuminate\Http\Request;

class NotificationController extends Controller
{
    public function sendNotification(Request $request)
    {
        $name = '张三'; // 示例数据
        $code = $request->input('code', 'ABCDEF'); // 从请求获取或使用默认值

        $mailData = [
            'name' => $name,
            'code' => $code,
            'message_line1' => '这是第一条消息。',
            'message_line2' => '这是第二条消息。',
        ];

        Mail::to('recipient@example.com') // 收件人邮箱
            ->send(new MyHtmlMail($mailData));

        return 'HTML邮件已成功发送！';
    }
}

登录后复制

当Laravel通过Mailable类发送邮件时，它会自动将邮件的Content-Type设置为text/html，从而确保您的 标签能够被正确解析。

2. 发送纯字符串HTML内容（不推荐但可行）

尽管不推荐用于复杂邮件或长期维护，但如果您确实需要直接发送一个HTML字符串作为邮件内容，Mailable类也提供了html()方法：

// 在Mailable的build方法中
public function build()
{
    $name = $this->details['name'];
    $code = $this->details['code'];
    $mes2 = "lorem ipsum dolor sit amet,";
    $mes3 = "consectetur adipiscing elit.";
    $mes4 = "Code: <strong>".$code."</strong>"; // 注意这里也使用了HTML标签
    $mes5 = "User: ".$name;
    $mes6 = "Sed do eiusmod tempor incididunt.";

    // 直接拼接HTML字符串
    $msg = $mes2."<br />".$mes3."<br />".$mes4."<br />".$mes5."<br />".$mes6."<br />";

    return $this->subject('您的通知')
                ->html($msg); // 直接传入HTML字符串
}

登录后复制

注意事项：

这种方法不利于邮件内容的管理和样式化。
手动拼接HTML字符串时，您需要特别注意数据安全，确保所有用户输入都经过了适当的HTML实体转义，以防止XSS攻击。Laravel Blade模板的{{ $variable }}会自动处理这一点。

注意事项与最佳实践

内容安全（XSS防护）： 永远不要直接将未经处理的用户输入插入到HTML邮件中。如果使用Blade模板，{{ $variable }}会自动进行HTML实体转义。如果手动拼接HTML字符串，请务必使用e()辅助函数或htmlspecialchars()函数对用户输入进行转义。
响应式设计： 邮件客户端的渲染能力和标准差异很大。为了确保邮件在各种设备和客户端上都能良好显示，建议使用内联CSS，并考虑使用表格布局（而非Flexbox或Grid）来构建响应式邮件。
全面测试： 在部署之前，务必在多个主流邮件客户端（如Gmail、Outlook、Apple Mail、Thunderbird等）以及移动设备上测试您的HTML邮件，以确保其显示效果符合预期。
纯文本备用： 某些邮件客户端可能不支持HTML邮件，或者用户可能偏好纯文本邮件。Laravel的Mailable类允许您通过text()方法或创建.txt后缀的Blade视图来提供纯文本版本的邮件。
```
// 在Mailable的build方法中
return $this->subject('您的通知')
            ->view('emails.my_html_email') // HTML视图
            ->text('emails.my_text_email'); // 纯文本视图
```
登录后复制
Markdown Mailable： Laravel还提供了Markdown邮件功能，它允许您使用Markdown语法编写邮件内容，Laravel会自动将其渲染为美观的HTML邮件，并自动生成一个纯文本版本。这是一种兼顾易用性和功能性的好方法。

总结

在Laravel中发送带有正确换行符的HTML邮件，关键在于确保邮件客户端将内容识别为HTML格式。通过利用Laravel强大的Mailable类和Blade模板系统，您可以轻松地构建结构清晰、样式丰富的HTML邮件。Mailable类会自动为您处理Content-Type头部，从而确保您的 标签能够被正确解析和显示。遵循最佳实践，如内容安全、响应式设计和全面测试，将有助于您创建专业且用户体验良好的邮件通知。

以上就是解决Laravel邮件内容换行符不生效问题：发送HTML格式邮件指南的详细内容，更多请关注php中文网其它相关文章！