在现代 Web 应用中，邮件通知是与用户沟通的重要桥梁。然而，开发一套在各种设备和邮件客户端（从老旧的 Outlook 到最新的 Gmail App）上都能完美显示的响应式邮件，一直是个让开发者头疼的“老大难”问题。你可能也经历过：为了让一个简单的按钮在所有客户端都居中，需要写上几十行嵌套的表格和内联样式；为了修复一个在移动端错位的图片，不得不反复调整 CSS 属性，然后发送测试邮件到各种设备上查看效果，这个过程既耗时又充满挫败感。
我最近在一个项目中就深陷这样的泥潭。客户要求所有邮件都必须是响应式的，并且在视觉上保持高度一致。起初，我尝试手写 HTML 和 CSS，但很快就发现这简直是噩梦。代码冗长、难以维护，而且每次修改都可能在某个意想不到的客户端上“翻车”。我迫切需要一种更高效、更可靠的解决方案。
遇见 MJML 与 Spatie MJML-PHP：邮件开发的救星
就在我几乎要放弃希望的时候，我发现了 MJML (Mailjet Markup Language)。它是一个开源的标记语言，专为响应式邮件设计，旨在大幅简化邮件的开发过程。MJML 提供了一套语义化的组件（如
而作为 PHP 开发者，如何将 MJML 引入到我们的 PHP 项目中呢？答案就是 Spatie 的 mjml-php 包。Spatie 团队总是能为我们带来高质量的 PHP 工具，这个包就是 PHP 应用与 MJML 引擎之间的完美桥梁。它允许我们在 PHP 代码中直接调用 MJML 引擎，将 MJML 模板实时编译成可发送的 HTML 邮件。
立即学习“PHP免费学习笔记（深入）”；
Composer：无缝集成 MJML-PHP
集成 mjml-php 到你的项目，通过 Composer 简直是小菜一碟。
首先，你需要使用 Composer 安装 spatie/mjml-php 包：
composer require spatie/mjml-php
需要注意的是，mjml-php 本身是一个 PHP 封装层，它需要底层的 MJML JavaScript 引擎来完成实际的编译工作。所以，你还需要在你的开发环境或服务器上安装 MJML 的 Node.js 包：
npm install mjml # 或者如果你使用 Yarn yarn add mjml
确保你的 Node.js 版本在 16 或更高，这样才能保证 MJML 引擎的正常运行。
如何使用 Spatie MJML-PHP
安装完成后，使用 mjml-php 转换 MJML 到 HTML 变得异常简单：
use Spatie\Mjml\Mjml;
$mjmlContent = <<<'MJML'
你好，这是一封响应式邮件！
点击我
MJML;
try {
$html = Mjml::new()->toHtml($mjmlContent);
echo $html; // 输出编译后的响应式 HTML
} catch (\Spatie\Mjml\Exceptions\CouldNotRenderMjml $e) {
echo "MJML 编译失败: " . $e->getMessage();
}这段代码简洁明了，你只需要将 MJML 字符串传递给 toHtml() 方法，它就会返回编译好的 HTML。如果 MJML 格式有误，它还会抛出 CouldNotRenderMjml 异常，方便你进行错误处理。
mjml-php 还提供了丰富的自定义选项，例如：
-
获取详细结果： 使用
convert()方法可以得到一个MjmlResult对象，它不仅包含 HTML，还有编译过程中可能出现的错误信息：$result = Mjml::new()->convert($mjmlContent); if ($result->hasErrors()) { foreach ($result->errors() as $error) { echo "MJML 错误在第 {$error->line()} 行: {$error->message()}\n"; } } echo $result->html(); -
优化输出： 你可以链式调用
minify()或beautify()来压缩或美化生成的 HTML，甚至hideComments()来移除注释。$minifiedHtml = Mjml::new()->minify()->toHtml($mjmlContent); $beautifiedHtml = Mjml::new()->beautify()->toHtml($mjmlContent);
-
MJML 验证： 在编译前，你可以使用
canConvert()或canConvertWithoutErrors()来检查你的 MJML 代码是否有效。if (Mjml::new()->canConvertWithoutErrors($mjmlContent)) { echo "MJML 代码有效且无错误。\n"; }
优势与实际应用效果
使用 Spatie MJML-PHP 彻底改变了我的邮件开发体验，其优势显而易见：
- 极大地简化了开发流程： 我现在只需关注邮件的结构和内容，用简洁的 MJML 语法描述，而不用再为复杂的 HTML 兼容性问题操心。开发效率至少提升了一倍。
- 完美的响应式效果： MJML 引擎负责生成高度优化的响应式 HTML，确保邮件在各种设备和客户端上都能自适应，保持良好的用户体验。
- 代码更清晰、更易维护： MJML 代码比原始的 HTML 邮件代码更语义化、更易读，团队协作和后续维护变得轻松许多。
- 与 PHP 生态无缝集成： 作为 PHP 包，它能轻松融入任何 PHP 项目，尤其是 Laravel 或 Symfony 这样的框架，我们可以很方便地在控制器或队列任务中生成邮件内容。
-
强大的错误报告：
MjmlResult提供的详细错误信息，让调试 MJML 模板变得高效，能快速定位问题。 - Composer 的便利性： 通过 Composer，安装、更新和管理这个依赖变得非常简单，确保项目依赖的规范化。
现在，我的项目中的邮件生成模块变得非常健壮和高效。我不再需要担心邮件的兼容性问题，可以将更多精力投入到业务逻辑和用户体验的提升上。
如果你也正在为响应式邮件的开发而烦恼，那么我强烈推荐你尝试一下 MJML 和 Spatie 的 mjml-php 包。它将是你邮件开发流程中的一项重要利器，让你从繁琐的兼容性工作中解脱出来，享受高效优雅的开发体验。
