基于PHP脚本生成并发送复杂HTML邮件的最优实现方案咨询

嘿，手动拼接HTML字符串确实是个折磨人的活儿，尤其是复杂邮件——完全懂你的痛苦！给你几个靠谱的方案，帮你优雅搞定这个问题：

最省心的方式就是把邮件的HTML结构单独做成一个模板文件，然后在PHP脚本里把数据库取到的数据传进去渲染，完全不用手动拼接字符串。

示例模板文件（比如email-template.php） #

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <title>您的订单通知</title>
    <!-- 先写整洁的样式，后面再处理内联（邮件客户端对<style>支持有限） -->
    <style>
        .email-container { max-width: 600px; margin: 0 auto; font-family: Arial, sans-serif; }
        .order-table { width: 100%; border-collapse: collapse; margin: 20px 0; }
        .order-table th { background: #f5f5f5; padding: 10px; text-align: left; border-bottom: 1px solid #ddd; }
        .order-table td { padding: 10px; border-bottom: 1px solid #eee; }
        .action-button { display: inline-block; padding: 12px 24px; margin: 0 10px 10px 0; background: #2563eb; color: white; text-decoration: none; border-radius: 4px; }
        .action-button.cancel { background: #dc2626; }
    </style>
</head>
<body>
    <div class="email-container">
        <h1>您好，<?php echo htmlspecialchars($userInfo['name'], ENT_QUOTES, 'UTF-8'); ?>！</h1>
        <p>以下是您最近的订单详情：</p>
        
        <table class="order-table">
            <tr>
                <th>订单编号</th>
                <th>商品名称</th>
                <th>下单时间</th>
                <th>金额</th>
            </tr>
            <?php foreach ($userOrders as $order): ?>
            <tr>
                <td><?php echo htmlspecialchars($order['order_id'], ENT_QUOTES, 'UTF-8'); ?></td>
                <td><?php echo htmlspecialchars($order['product_name'], ENT_QUOTES, 'UTF-8'); ?></td>
                <td><?php echo htmlspecialchars($order['create_time'], ENT_QUOTES, 'UTF-8'); ?></td>
                <td><?php echo htmlspecialchars($order['amount'], ENT_QUOTES, 'UTF-8'); ?></td>
            </tr>
            <?php endforeach; ?>
        </table>

        <p>请选择您的操作：</p>
        <a href="https://your-domain.com/order-handler.php?action=confirm&order_id=<?php echo urlencode($mainOrderId); ?>" class="action-button">确认订单</a>
        <a href="https://your-domain.com/order-handler.php?action=cancel&order_id=<?php echo urlencode($mainOrderId); ?>" class="action-button cancel">取消订单</a>
    </div>
</body>
</html>

然后在发送邮件的PHP脚本里渲染模板 #

// 1. 从数据库获取数据（这里是示例，实际根据你的业务逻辑查询）
$userInfo = [
    'name' => '张三',
    'email' => 'zhangsan@example.com'
];
$mainOrderId = 'ORD-20240520-001';
$userOrders = [
    [
        'order_id' => 'ORD-20240520-001-01',
        'product_name' => '无线耳机',
        'create_time' => '2024-05-20 14:30:00',
        'amount' => '¥299.00'
    ],
    [
        'order_id' => 'ORD-20240520-001-02',
        'product_name' => '充电底座',
        'create_time' => '2024-05-20 14:30:00',
        'amount' => '¥99.00'
    ]
];

// 2. 开启输出缓冲，渲染模板
ob_start();
// 把变量暴露给模板，这里直接用全局变量或者可以用更严谨的方式（比如把数组传进去）
include 'email-template.php';
$finalEmailHtml = ob_get_clean(); // 获取渲染后的HTML内容

// 3. 处理邮件样式内联（可选但强烈推荐）
// 用第三方库把<style>里的样式转为内联，兼容更多邮件客户端
// 比如 TijsVerkoyen/CssToInlineStyles，需要先通过Composer安装：composer require tijsverkoyen/css-to-inline-styles
// $cssConverter = new \TijsVerkoyen\CssToInlineStyles\CssToInlineStyles();
// $finalEmailHtml = $cssConverter->convert($finalEmailHtml);

// 4. 发送邮件（用你已有的发送逻辑，比如PHPMailer或者原生mail函数）
// $headers = "MIME-Version: 1.0\r\n";
// $headers .= "Content-type: text/html; charset=UTF-8\r\n";
// mail($userInfo['email'], '您的订单通知', $finalEmailHtml, $headers);

• 邮件样式兼容性：绝大多数邮件客户端不支持外部CSS，甚至<style>标签也会被过滤（比如Gmail），所以最好把样式转为内联。上面提到的CssToInlineStyles库能帮你自动完成这个工作，不用手动写内联样式。
• 安全问题：所有从数据库取出的内容，在输出到HTML时一定要用htmlspecialchars()转义，防止XSS攻击；链接里的参数要用urlencode()处理，避免参数里的特殊字符破坏URL结构。
• 测试邮件显示：不同邮件客户端（Outlook、Gmail、QQ邮箱等）对HTML的渲染差异很大，写完模板后一定要在主流客户端里测试显示效果，避免出现排版混乱。

内容的提问来源于stack exchange，提问作者Mathieu Turcotte