WordPress Ajax调用独立PHP文件时wp_mail()失效问题排查

这个问题和Ajax提交方式没有任何关系，核心原因是你直接请求主题目录下的独立email.php文件时，没有加载WordPress的运行环境，对应你观察到的几个现象可以一一对应：

• 代码嵌入HTML模板页时wp_mail()正常：模板页的请求是走WordPress完整初始化流程的，核心函数、主题插件的所有钩子、SMTP配置都已经加载完成，wp_mail()作为WordPress内置函数自然可以正常调用。
• 独立文件里wp_mail()失效、原生mail()正常：wp_mail()不是PHP自带的函数，是WordPress核心代码里定义的发信函数。你直接访问主题下的email.php时，PHP是独立解析这个文件的，根本找不到wp_mail()的定义，会直接抛出致命错误，所以接口空返回、控制台也没有内容。而原生mail()是PHP邮件扩展自带的函数，不依赖WordPress环境，所以替换后就能跑通。
• 哪怕你不用Ajax，直接在浏览器里打开email.php的地址，wp_mail()一样会报错，和提交方式无关。

有两种实现方式，优先选第一种WordPress官方规范的方案，兼容性和安全性更好。

方案1：使用WordPress原生Ajax接口（推荐） #

不要直接请求主题下的PHP文件，用WordPress内置的admin-ajax机制处理异步请求，这是官方推荐的开发方式：

1. 先在主题的functions.php文件里注册Ajax处理动作，同时支持登录、未登录用户的提交请求：

// 注册联系表单发信的Ajax回调
add_action('wp_ajax_send_contact_mail', 'contact_mail_handler');
add_action('wp_ajax_nopriv_send_contact_mail', 'contact_mail_handler');
function contact_mail_handler() {
    // 建议在这里加非ce校验、表单参数过滤，拦截恶意提交
    $headers = "From: contact@mywebsite.com\r\n";
    $to = 'contact@mywebsite.com';
    $message = 'My message';
    $subject = 'Message from Contact Form';

    $send_email = wp_mail($to,$subject,$message,$headers);

    if (!$send_email) {
        echo 'this is error';
    } else {
        echo 'this is success';
    }
    wp_die(); // 必须加这行终止执行，否则接口末尾会自动输出0
}

2. 修改前端Ajax请求，把请求地址换成WordPress的admin-ajax入口，同时传对应的action参数：

$(document).ready(function () {
  $(".myform").on("submit", function () {
    var form = $(this);
    $.ajax({
      url: "/wp-admin/admin-ajax.php",
      method: form.attr("method"),
      // 追加action参数，和你注册的动作名保持一致
      data: form.serialize() + '&action=send_contact_mail',
      success: function (result) {
        console.log(result);
      },
    });
    return false;
  });
});

如果不想硬编码Ajax地址，可以在functions.php里把地址注入到前端JS变量，适配不同的站点域名配置：

add_action('wp_enqueue_scripts', function() {
    wp_localize_script('jquery', 'siteConfig', [
        'ajaxUrl' => admin_url('admin-ajax.php')
    ]);
});

之后前端JS里的url字段直接写siteConfig.ajaxUrl即可。

方案2：在独立email.php顶部手动加载WordPress核心 #

如果你一定要保留独立PHP文件的写法，只需要在文件最顶部引入WordPress的核心加载文件，把WP环境拉起来就能正常调用wp_mail()，注意根据你的文件层级调整相对路径：

<?php
// 加载WordPress核心，当前文件在wp-content/themes/yourtheme/目录下，所以需要向上跳3层找到wp-load.php
require_once __DIR__ . '/../../../wp-load.php';

// 原有的发信代码
$name = 'My name';
$email = 'myemail@gmail.com';
$headers = "From: contact@mywebsite.com";
$to = 'contact@mywebsite.com';
$message = 'My message';
$subject = 'Message from Contact Form';

$send_email = wp_mail($to,$subject,$message,$headers);

if ($send_email == false) {
    echo 'this is error';
} else {
    echo 'this is success';
}
?>

这种方式不推荐：因为绕过了WordPress的部分初始化流程，如果你装了SMTP发信类的插件，可能会出现兼容问题，同时所有的安全校验、参数过滤逻辑都需要你自己实现，被恶意刷信的风险更高。

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