概述

posts_request 是一个 WordPress 过滤器，用于在发送 SQL 查询前修改完整的查询字符串。它允许开发者自定义 WP_Query 生成的 SQL 语句。

关键要点

• 过滤器名称：posts_request
• 参数：$request（完整的 SQL 查询字符串）和 $query（WP_Query 实例，通过引用传递）
• 应用场景：在 WP_Query::get_posts() 中调用，用于调整查询逻辑
• 版本历史：自 WordPress 2.0.0 引入

代码示例

add_filter('posts_request', 'custom_posts_request', 10, 2);
function custom_posts_request($request, $query) {
    // 修改 $request 字符串，例如添加自定义条件
    if ($query->is_search()) {
        $request = str_replace('WHERE 1=1', 'WHERE 1=1 AND custom_field = value', $request);
    }
    return $request;
}

注意事项

• SQL 查询示例包括 SELECT、JOIN、WHERE 等子句，需谨慎修改以避免语法错误
• 参数 $query 为引用传递，可直接操作 WP_Query 实例
• 相关函数：WP_Query::get_posts()，位于 wp-includes/class-wp-query.php