WordPress的functions.php内调用get_search_query()返回空值问题咨询

问题根本原因 #

AJAX请求是独立的HTTP请求，和用户当前访问的搜索结果页属于两个完全独立的请求周期，WordPress不会自动将原搜索页的查询参数同步到AJAX请求中，因此在AJAX处理函数中直接调用get_search_query()无法拿到对应搜索词。

解决方案 #

步骤1：前端请求携带搜索词参数 #

可任选以下一种方式把搜索词加入AJAX请求参数：

方式A：使用wp_localize_script传参（WordPress推荐方案）

在主题functions.php中入队前端脚本时，同步将当前页面的搜索词传递到前端JS变量：

wp_enqueue_script('custom-script', get_template_directory_uri() . '/js/your-script.js', array('jquery'), '1.0', true);
wp_localize_script('custom-script', 'ajax_conf', array(
    'ajax_url' => admin_url('admin-ajax.php'),
    'search_term' => get_search_query()
));

修改前端AJAX请求代码，携带搜索词：

jQuery.post(ajax_conf.ajax_url, {
    action: "load_posts",
    page: page,
    ppp: ppp,
    s: ajax_conf.search_term
})

方式B：前端直接读取URL搜索参数

如果不想修改脚本入队逻辑，也可以直接在JS中读取当前页面URL的搜索参数：

// 获取URL中的搜索词
function getSearchQuery() {
    return new URLSearchParams(window.location.search).get('s') || '';
}

// 发起AJAX请求
jQuery.post(ajaxUrl, {
    action: "load_posts",
    page: page,
    ppp: ppp,
    s: getSearchQuery()
})

步骤2：修改后端AJAX处理函数 #

调整load_posts函数，从POST参数中读取搜索词使用，同时做好参数安全校验：

function load_posts() {
    $ppp = isset($_POST["ppp"]) ? intval($_POST["ppp"]) : 20;
    $page = isset($_POST['page']) ? intval($_POST['page']) : 1;
    // 从POST参数读取搜索词并做安全过滤
    $search_term = isset($_POST['s']) ? sanitize_text_field($_POST['s']) : '';
 
    $args = array(
        'suppress_filters' => true,
        'post_type' => 'post',
        'ignore_sticky_posts'   => true,
        'post_status' => array('publish'),
        'orderby'           => 'post_date',
        'order'             => 'DESC',
        'posts_per_page' => $ppp,
        'paged'             => $page,
        's' => $search_term,
    );

    $loop = new WP_Query($args);
    echo '<pre>' . var_export($args, true) . '</pre>';
    // WordPress AJAX处理规范，结束时必须调用wp_die()
    wp_die();
}
add_action('wp_ajax_nopriv_load_posts','load_posts');
add_action('wp_ajax_load_posts','load_posts');

注意事项 #

• 所有用户传入的参数必须做类型转换和安全过滤，避免注入风险
• 不要在AJAX处理函数中依赖is_search()、get_search_query()这类依赖当前页面查询周期的函数，所有需要的参数都要从AJAX请求中主动传递

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