WordPress如何判断AJAX请求并实现不同加载场景的内容返回

1. 实现AJAX请求判断方法 #

你可以直接在主题functions.php文件中添加以下判断函数，兼容WordPress原生AJAX场景和自定义AJAX请求场景：

function is_custom_ajax_request() {
    // 适配WordPress内置AJAX接口场景
    if (defined('DOING_AJAX') && DOING_AJAX) {
        return true;
    }
    // 判断请求头标识，主流前端请求库默认都会携带该标识
    return isset($_SERVER['HTTP_X_REQUESTED_WITH']) && strtolower($_SERVER['HTTP_X_REQUESTED_WITH']) === 'xmlhttprequest';
}

注：如果使用原生fetch发起请求，需要手动在请求头中添加X-Requested-With: XMLHttpRequest字段

2. 差异化内容返回逻辑实现 #

根据你的使用场景可以选择以下两种方案：

方案1：路由模板拦截（适配默认页面路由场景） #

使用template_include钩子拦截模板加载逻辑，AJAX请求时直接输出目标区块内容，终止完整页面渲染：

add_filter('template_include', 'ajax_content_render_handler', 99);
function ajax_content_render_handler($original_template) {
    if (is_custom_ajax_request()) {
        // 按需输出你需要返回的区块内容，这里以文章内容为例
        if (have_posts()) {
            while (have_posts()) {
                the_post();
                the_content();
                // 可扩展输出其他自定义字段、模块内容
            }
        }
        // 输出完成直接终止，避免加载header、footer等完整页面资源
        exit;
    }
    // 非AJAX请求走默认完整页面渲染逻辑
    return $original_template;
}

方案2：自定义AJAX接口（适配灵活拉取内容场景） #

如果不需要复用现有页面路由，可以用WordPress内置AJAX接口机制实现：

• 先在functions.php中注册接口回调

// 登录用户可访问接口
add_action('wp_ajax_get_target_block', 'get_target_block_callback');
// 未登录用户可访问接口
add_action('wp_ajax_nopriv_get_target_block', 'get_target_block_callback');

function get_target_block_callback() {
    // 接收前端传递的参数，做参数校验和过滤
    $post_id = isset($_POST['post_id']) ? intval($_POST['post_id']) : 0;
    if (!$post_id || !get_post($post_id)) {
        wp_send_json_error('无效的内容ID');
    }
    // 组装返回内容
    $response_content = apply_filters('the_content', get_post_field('post_content', $post_id));
    // 可直接返回HTML内容，也可以用wp_send_json返回JSON格式数据
    echo $response_content;
    exit;
}

• 前端请求地址为{你的站点域名}/wp-admin/admin-ajax.php，需要携带参数action=get_target_block以及自定义的内容参数即可。

注意事项 #

• 所有用户传入的参数都需要做过滤和校验，避免安全风险
• 若需要返回JSON格式内容，优先使用WordPress内置的wp_send_json、wp_send_json_success系列函数处理
• 高频访问的AJAX接口可以搭配静态缓存、对象缓存使用，提升响应速度

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