WooCommerce自定义邮件中PHP echo无法工作该怎么解决

在WooCommerce开发中，自定义邮件模板时遇到PHP echo无法输出内容是很常见的问题，这和WooCommerce的邮件渲染逻辑、变量作用域、模板加载规则都有关系，需要逐一排查诱因。

问题常见诱因

• 变量作用域错误：在邮件模板中使用的变量没有通过正确的方式传递到模板作用域，导致echo时变量未定义
• 钩子使用不当：没有用WooCommerce提供的邮件相关钩子挂载内容，直接修改模板导致输出被过滤
• 输出缓冲未处理：邮件生成过程中使用了输出缓冲，没有正确获取缓冲内容就直接echo
• 模板路径错误：自定义的邮件模板没有被正确加载，实际执行的是默认模板，修改的内容没有生效

对应的解决方案

1. 确保变量正确传递到模板

WooCommerce的邮件模板变量需要通过wc_get_template的args参数传递，不能直接在模板中定义全局变量。比如要传递订单对象到自定义邮件模板，正确的调用方式如下：

// 发送自定义邮件时传递变量
$order = wc_get_order(123);
$args = array(
    'order' => $order,
    'custom_content' => '这是自定义的内容'
);
wc_get_template(
    'emails/custom-email.php',
    $args,
    '',
    plugin_dir_path(__FILE__) . 'templates/'
);

在模板文件custom-email.php中，就可以直接使用传递过来的变量echo输出：

<?php
if (isset($custom_content)) {
    echo esc_html($custom_content);
}
if (isset($order)) {
    echo '<p>订单号：' . $order->get_order_number() . '</p>';
}
?>

2. 使用正确的钩子挂载内容

如果不需要完全自定义模板，只是想在默认邮件中追加内容，应该使用WooCommerce提供的邮件钩子，而不是直接修改默认模板。比如给订单完成邮件追加内容：

add_action('woocommerce_email_order_details', 'add_custom_content_to_order_email', 20, 4);
function add_custom_content_to_order_email($order, $sent_to_admin, $plain_text, $email) {
    // 只给客户端的订单完成邮件追加内容
    if ($email->id === 'customer_completed_order') {
        echo '<p>感谢您的购买，这是您的专属优惠码：SAVE10</p>';
    }
}

3. 处理输出缓冲问题

如果自定义邮件生成过程中用到了输出缓冲，需要确保在echo之前正确获取缓冲内容。比如下面的错误示例和正确示例：

// 错误示例：缓冲未获取就直接输出
ob_start();
echo '缓冲内容';
// 这里直接echo不会生效，因为内容在缓冲中

// 正确示例：获取缓冲后再输出
ob_start();
echo '缓冲内容';
$custom_content = ob_get_clean();
echo $custom_content;

4. 验证模板加载路径

可以在自定义模板的最顶部添加调试代码，确认模板是否被正确加载：

<?php
// 调试用，确认模板加载后删除
error_log('自定义邮件模板已加载');
?>

如果日志中没有出现这条记录，说明模板路径配置错误，需要检查wc_get_template的路径参数是否正确，或者是否把模板放到了主题的woocommerce/emails/目录下。

验证方法

修改完成后，可以手动触发对应的邮件发送，查看邮件源码确认内容是否输出。如果还是没有生效，可以开启WordPress的调试模式，查看是否有变量未定义、函数调用错误等日志，进一步定位问题。

WooCommerce自定义邮件PHP_echo邮件模板钩子函数修改时间：2026-06-04 05:50:58