阐述 WordPress `WP_Query` 类中的 `query()` 方法源码：它如何将查询变量转换为完整的 SQL 语句。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

WordPress `WP_Query` 的 `query()` 方法：SQL 魔法的幕后推手

各位观众，晚上好！我是你们今天的 SQL 魔法师，啊不，是 WP_Query 解码员。今天咱们来聊聊 WordPress 里鼎鼎大名的 WP_Query 类，特别是它里面的核心方法 query()。这玩意儿就像个翻译器，你给它一堆人类能看懂的参数，它噼里啪啦一顿操作，就能变出一串数据库才能理解的 SQL 语句。是不是听起来很酷？那咱们就开始揭秘吧！

`WP_Query` 是个啥？

首先，咱们先简单回顾一下 WP_Query 的作用。简单来说，它就是一个查询 WordPress 数据库的类。通过它可以方便地获取文章、页面、自定义文章类型等各种数据。你可以在主题、插件里用它，简直是万能的。

`query()`：查询的起点

query() 方法是 WP_Query 类的核心，所有的查询最终都要通过它。咱们可以把它想象成一个总指挥，接收各种查询参数，然后分配任务给各个小弟（也就是类里面的其他方法），最终生成 SQL 语句。

query() 的基本流程大概是这样的：

接收参数： 接收一个参数数组，里面包含了各种查询条件，比如文章类型、分类、标签、作者等等。
预处理参数： 对参数进行一些预处理，比如检查参数的合法性，设置默认值等等。
构建 SQL 片段： 根据参数，逐步构建 SQL 语句的各个部分，比如 WHERE 子句、ORDER BY 子句等等。
组合 SQL 语句： 将各个 SQL 片段组合成完整的 SQL 语句。
执行查询： 执行 SQL 语句，从数据库中获取数据。
处理结果： 对查询结果进行处理，比如将结果存储在 posts 属性中，设置分页信息等等。

源码剖析：步步惊心

好了，理论知识咱们先放到一边，直接进入源码分析环节！放心，我会尽量用大白话解释，保证你能听懂。

1. 接收参数 & 预处理

query() 方法的开头，首先会接收一个参数数组 $query。这个数组可以包含各种各样的查询参数，比如：

post_type：文章类型 (post, page, etc.)
category_name：分类别名
tag：标签别名
posts_per_page：每页显示的文章数量
orderby：排序方式
order：排序方向 (ASC, DESC)

等等等等，还有很多很多…

接下来，query() 会对这些参数进行预处理。这部分的代码比较复杂，主要是为了确保参数的合法性，并设置一些默认值。

public function query( $query ) {
    $this->init(); // 初始化 WP_Query 对象

    if ( empty( $query ) ) {
        $query = array();
    }

    if ( ! is_array( $query ) && ! empty( $query ) ) {
        parse_str( $query, $qv ); // 将字符串形式的查询参数转换为数组
        $query = $qv;
    }

    $this->query = $this->query_vars = wp_parse_args( $query, $this->query_vars ); // 合并查询参数和默认参数

    // ... 省略一些代码 ...

    // 处理各种查询参数
    $this->parse_query( $this->query_vars );

    // ... 省略一些代码 ...

    return $this->get_posts(); // 执行查询并返回结果
}

$this->init(): 初始化 WP_Query 对象，重置一些属性。
wp_parse_args(): 这个函数非常重要，它会将用户传入的查询参数和 WP_Query 对象的默认参数进行合并。这样可以确保即使你只传入了部分参数，也能得到一个完整的参数数组。

2. `parse_query()`：参数解析的重头戏

parse_query() 方法是参数解析的核心。它会根据不同的查询参数，设置 WP_Query 对象的各种属性，这些属性会在后续的 SQL 构建过程中用到。

public function parse_query( &$q ) {
    // 全局变量
    global $wp, $wpdb;

    $q = wp_parse_args( $q, $this->query_vars ); //再次合并参数，确保万无一失
    $this->query_vars = $q;

    // 处理分页参数
    $this->parse_query_vars( $q );

    // ... 省略大量的代码 ...

    // 处理文章类型
    if ( ! empty( $q['post_type'] ) ) {
        $this->set_post_types( $q['post_type'] );
    }

    // 处理分类参数
    $this->parse_tax_query( $q );

    // ... 省略更多的代码 ...

    $this->query_vars_hash = md5( serialize( $this->query_vars ) ); // 生成查询参数的哈希值，用于缓存
}

parse_query() 里面的代码非常复杂，包含了大量的 if 语句，用于处理各种不同的查询参数。这里咱们只挑几个重点的讲一下：

parse_query_vars(): 处理分页相关的参数，比如 paged、page、posts_per_page 等。
set_post_types(): 根据 post_type 参数，设置文章类型。
parse_tax_query(): 处理分类、标签等分类法相关的参数。这个方法会构建一个 WP_Tax_Query 对象，用于生成分类法查询的 SQL 片段。

3. `get_posts()`：SQL 的诞生与执行

经过 parse_query() 的处理，WP_Query 对象已经准备好了所有的查询参数。接下来，get_posts() 方法就要开始构建 SQL 语句并执行查询了。

public function get_posts() {
    global $wpdb;

    // ... 省略一些代码 ...

    // 构建 SQL 语句
    $this->get_posts_sql( $this->query_vars, $this->request );

    // 执行查询
    $this->posts = $wpdb->get_results( $this->request );

    // ... 省略一些代码 ...

    return $this->posts;
}

get_posts_sql(): 这个方法是构建 SQL 语句的核心。它会根据 WP_Query 对象的各种属性，生成 SELECT、FROM、WHERE、ORDER BY 等 SQL 子句，并将它们组合成完整的 SQL 语句。
$wpdb->get_results(): 使用 WordPress 自带的 $wpdb 对象执行 SQL 语句，并获取查询结果。

4. `get_posts_sql()`：SQL 组装车间

get_posts_sql() 方法的代码非常长，也比较复杂。咱们可以把它想象成一个 SQL 组装车间，它会根据不同的查询参数，组装出不同的 SQL 语句。

protected function get_posts_sql( &$q, &$request ) {
    global $wpdb;

    // 初始化 SQL 语句的各个部分
    $fields = '*';
    $join = '';
    $where = 'AND 1=1';
    $groupby = '';
    $orderby = '';
    $limits = '';

    // 处理文章状态
    $where .= $this->get_posts_by_status_sql( $q['post_status'], $q['perm'] );

    // 处理文章类型
    $where .= $this->get_posts_by_post_type_sql( $q['post_type'] );

    // 处理分类法查询
    $clauses = $this->tax_query->get_sql( $wpdb->posts, 'ID' );
    if ( ! empty( $clauses['where'] ) ) {
        $where .= $clauses['where'];
        $join  .= $clauses['join'];
    }

    // ... 省略大量的代码 ...

    // 构建 ORDER BY 子句
    $orderby = $this->get_posts_orderby( $orderby, $q['orderby'], $q['order'], $q );

    // 构建 LIMIT 子句
    if ( ! empty( $q['posts_per_page'] ) && $q['posts_per_page'] > 0 ) {
        if ( $q['offset'] ) {
            $limits = 'LIMIT ' . (int) $q['offset'] . ',' . (int) $q['posts_per_page'];
        } else {
            $limits = 'LIMIT ' . (int) $q['posts_per_page'];
        }
    }

    // 组合 SQL 语句
    $found_posts_query = "SELECT FOUND_ROWS()";

    $request = "SELECT {$fields} FROM {$wpdb->posts} {$join} WHERE 1=1 {$where} {$groupby} {$orderby} {$limits}";

    if ( $q['fields'] === 'ids' ) {
        $this->request = $wpdb->prepare( "SELECT SQL_CALC_FOUND_ROWS {$wpdb->posts}.ID FROM {$wpdb->posts} {$join} WHERE 1=1 {$where} {$groupby} {$orderby} {$limits}", array() );
    } else {
        $this->request = $wpdb->prepare( "SELECT SQL_CALC_FOUND_ROWS {$wpdb->posts}.* FROM {$wpdb->posts} {$join} WHERE 1=1 {$where} {$groupby} {$orderby} {$limits}", array() );
    }

    $this->found_posts = (int) $wpdb->get_var( $found_posts_query );

}

get_posts_sql() 里面有很多辅助方法，用于生成不同的 SQL 子句，比如：

get_posts_by_status_sql(): 根据文章状态 (publish, draft, etc.) 生成 WHERE 子句。
get_posts_by_post_type_sql(): 根据文章类型生成 WHERE 子句。
WP_Tax_Query->get_sql(): 生成分类法查询的 WHERE 和 JOIN 子句。
get_posts_orderby(): 根据排序参数生成 ORDER BY 子句。

最终，get_posts_sql() 会将所有的 SQL 子句组合成一个完整的 SQL 语句，并将其存储在 $this->request 属性中。

5. 示例：从参数到 SQL

为了更好地理解 query() 方法的工作原理，咱们来看一个具体的例子。

假设我们有以下查询参数：

$args = array(
    'post_type'      => 'post',
    'category_name'  => 'news',
    'posts_per_page' => 10,
    'orderby'        => 'date',
    'order'          => 'DESC',
);

$query = new WP_Query( $args );

这段代码的意思是：查询文章类型为 post，分类为 news，每页显示 10 篇文章，按照发布日期降序排序。

经过 WP_Query 的处理，最终生成的 SQL 语句大概是这样的：

SELECT SQL_CALC_FOUND_ROWS wp_posts.*
FROM wp_posts
INNER JOIN wp_term_relationships ON (wp_posts.ID = wp_term_relationships.object_id)
INNER JOIN wp_term_taxonomy ON (wp_term_relationships.term_taxonomy_id = wp_term_taxonomy.term_taxonomy_id)
INNER JOIN wp_terms ON (wp_term_taxonomy.term_id = wp_terms.term_id)
WHERE 1=1
AND ( wp_term_taxonomy.taxonomy = 'category' AND wp_terms.slug = 'news' )
AND wp_posts.post_type = 'post'
AND ((wp_posts.post_status = 'publish'))
ORDER BY wp_posts.post_date DESC
LIMIT 0, 10

可以看到，WP_Query 自动帮我们处理了分类表的连接，并生成了相应的 WHERE 子句。是不是很方便？

6. 缓存：提升性能的利器

WP_Query 还使用了缓存机制来提升性能。当查询参数相同时，它可以直接从缓存中获取结果，而不需要再次执行 SQL 语句。

WP_Query 使用了两种缓存：

数据库查询缓存： WordPress 默认启用了数据库查询缓存。当执行 SQL 语句时，WordPress 会将查询结果缓存在内存中。下次执行相同的 SQL 语句时，可以直接从缓存中获取结果。
对象缓存： WP_Query 还会将查询结果缓存在对象缓存中。对象缓存是一种更高级的缓存机制，可以存储 PHP 对象。 WP_Query 会将查询到的文章对象缓存在对象缓存中，下次查询相同的文章时，可以直接从缓存中获取对象。

可以通过 WP_Query 对象的 $cache_results 属性来控制是否使用对象缓存。默认情况下，$cache_results 属性为 true，表示使用对象缓存。

`query()` 方法的核心属性

为了更好地理解 query() 方法的工作原理，咱们来总结一下 WP_Query 类中一些重要的属性：

属性名	类型	描述
`$query`	array	原始的查询参数数组。
`$query_vars`	array	经过 `wp_parse_args()` 处理后的查询参数数组，包含了默认值。
`$posts`	array	查询结果，包含了文章对象。
`$post_count`	int	文章数量。
`$current_post`	int	当前文章的索引。
`$found_posts`	int	符合查询条件的所有文章数量（不考虑分页）。
`$max_num_pages`	int	总页数。
`$is_single`	bool	是否是单篇文章页面。
`$is_page`	bool	是否是页面。
`$is_archive`	bool	是否是归档页面。
`$tax_query`	WP_Tax_Query	用于构建分类法查询的 SQL 片段。
`$meta_query`	WP_Meta_Query	用于构建元数据查询的 SQL 片段。
`$request`	string	最终生成的 SQL 语句。
`$query_vars_hash`	string	查询参数的哈希值，用于缓存。
`$cache_results`	bool	是否使用对象缓存。

总结

WP_Query 的 query() 方法是一个非常复杂的方法，它负责接收查询参数，预处理参数，构建 SQL 语句，执行查询，并处理结果。理解 query() 方法的工作原理，可以帮助我们更好地使用 WP_Query 类，并编写更高效的 WordPress 代码。

关键点回顾：

query() 是 WP_Query 的入口，接收参数并启动查询流程。
parse_query() 解析参数，设置 WP_Query 对象的属性。
get_posts() 构建 SQL 语句并执行查询。
get_posts_sql() 是 SQL 组装车间，负责生成 SQL 语句的各个部分。
WP_Query 使用缓存来提升性能。

希望今天的讲座能帮助你更好地理解 WP_Query 的 query() 方法。记住，代码的世界充满了魔法，只要你愿意探索，就能发现更多有趣的秘密！下次再见！

WordPress WP_Query 的 query() 方法：SQL 魔法的幕后推手

WP_Query 是个啥？

query()：查询的起点

源码剖析：步步惊心

1. 接收参数 & 预处理

2. parse_query()：参数解析的重头戏

3. get_posts()：SQL 的诞生与执行

4. get_posts_sql()：SQL 组装车间