WordPress插件重写wp_mail函数被其他插件抢占控制权的技术求助

问题根源 #

WordPress的可插拔函数（pluggable functions）遵循「最后加载生效」的规则——哪个插件最后定义wp_mail，哪个版本就会覆盖之前的。你的插件被抢占，说明另一款插件的加载顺序在你之后，或者它通过更高优先级的钩子重写了函数。

可行解决方案 #

1. 用钩子替代直接重写wp_mail #

放弃直接重写可插拔函数，改用WordPress原生的邮件钩子来拦截发送，这种方式不受其他插件重写wp_mail的影响：

方法A：通过wp_mail过滤器直接阻止邮件

设置最高优先级（PHP_INT_MAX）确保你的回调最后执行，直接返回false即可终止邮件发送：

add_filter('wp_mail', '__return_false', PHP_INT_MAX);

如果需要更灵活的控制（比如仅拦截特定邮件），可以自定义回调：

add_filter('wp_mail', function($args) {
    // 示例：仅拦截WooCommerce订单邮件
    $is_woocommerce_mail = strpos($args['subject'], '订单') !== false || strpos($args['message'], 'WooCommerce') !== false;
    if ($is_woocommerce_mail) {
        return false;
    }
    // 非目标邮件正常发送
    return $args;
}, PHP_INT_MAX);

方法B：通过phpmailer_init钩子破坏发送流程

在PHPMailer初始化阶段清空所有发送信息，或设置无效的发送配置：

add_action('phpmailer_init', function($phpmailer) {
    // 清空收件人、附件、内容等
    $phpmailer->ClearAllRecipients();
    $phpmailer->ClearAttachments();
    $phpmailer->Subject = '';
    $phpmailer->Body = '';
    // 或者设置无效SMTP地址强制发送失败
    $phpmailer->isSMTP();
    $phpmailer->Host = 'localhost';
    $phpmailer->Port = 9999; // 不存在的端口
}, PHP_INT_MAX);

2. 强制让你的wp_mail版本最后生效 #

如果坚持要重写wp_mail，可以利用plugins_loaded钩子的最高优先级，在所有插件加载完成后重新定义函数：

add_action('plugins_loaded', function() {
    // 如果wp_mail已经被其他插件定义，先重命名原函数
    if (function_exists('wp_mail') && !function_exists('_wp_mail')) {
        rename_function('wp_mail', '_wp_mail');
    }
    
    // 重新定义我们的wp_mail
    function wp_mail($to, $subject, $message, $headers = '', $attachments = array()) {
        // 你的逻辑：比如直接返回true，不发送任何邮件
        return true;
    }
}, PHP_INT_MAX);

注：rename_function需要PHP的runkit扩展支持，如果没有该扩展，可以改用remove_function（仅对用户定义的函数有效）。

为什么这些方法有效 #

• 钩子的PHP_INT_MAX优先级确保你的代码最后执行，覆盖其他插件的设置；
• 利用原生钩子拦截邮件，绕开了可插拔函数的加载顺序问题，兼容性更强。

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