各位观众老爷们，晚上好！今儿咱就来唠唠 WordPress 里这个看似高冷，实则有点傲娇的 WP_Tax_Query 类。 别怕，听我慢慢给你扒它的皮，抽它的筋，让你彻底明白这玩意儿到底是个啥，怎么用它来构建各种奇葩的分类法查询条件。
开场白：分类法是个啥？WP_Tax_Query 又是干啥的？
先来个科普：WordPress 里的分类法（Taxonomy）就是给内容贴标签的。常见的有分类目录（Category）和标签（Tag），当然你也可以自定义各种各样的分类法，比如“颜色”、“尺寸”、“品牌”之类的。
那么， WP_Tax_Query 这哥们儿，就是专门负责构建复杂分类法查询条件的。 你想查所有“红色”且“大号”的产品？ 或者查所有属于“新闻”分类，但不属于“重要新闻”分类的文章？ 这都得靠它。
一、WP_Tax_Query 的基本骨架：参数详解
WP_Tax_Query 类本身并不直接执行查询，它只是构建查询条件，然后把这些条件交给 WP_Query 来执行。 它的核心在于构造函数，我们先来看看它的参数：
<?php
/**
* WP_Tax_Query Class
*
* @since 3.1.0
*/
class WP_Tax_Query {
/**
* Array of taxonomy queries
*
* @since 3.1.0
* @var array
*/
public $queries = array();
/**
* Relation between the taxonomy queries.
* Possible values are 'AND', 'OR'.
*
* @since 3.1.0
* @var string
*/
public $relation = 'AND';
/**
* Constructor.
*
* @since 3.1.0
*
* @param array $tax_query Taxonomy query clauses.
*/
public function __construct( $tax_query ) {
if ( isset( $tax_query['relation'] ) && strtoupper( $tax_query['relation'] ) === 'OR' ) {
$this->relation = 'OR';
}
if ( isset( $tax_query[0] ) && is_array( $tax_query[0] ) ) {
$this->queries = $tax_query;
} else {
$this->queries[] = $tax_query;
}
$this->queries = array_filter( $this->queries );
}
}可以看到，WP_Tax_Query 构造函数接受一个数组作为参数，这个数组定义了我们的分类法查询条件。这个数组可以是一个一维数组，也可以是一个多维数组。
关键的参数都在这个数组里，我们用表格来捋一捋：
| 参数名 | 类型 | 描述 | 示例 |
|---|---|---|---|
taxonomy |
string | 分类法的名称，比如 'category'、 'post_tag' 或者你自定义的分类法名称。 |
'category' |
terms |
array | 一个包含分类法术语 ID、slug 或者名称的数组。 注意，具体使用 ID、slug 还是名称，取决于 field 参数的设置。 |
array( 1, 2, 3 ) array( 'news', 'featured' ) |
field |
string | 指定 terms 参数中使用的是 ID、slug 还是名称。 可选值： 'term_id' (默认)、 'slug'、 'name'。 |
'term_id' 'slug' 'name' |
operator |
string | 定义多个术语之间的关系。 可选值： 'IN' (默认)、 'NOT IN'、 'AND'、 'EXISTS'、 'NOT EXISTS'。 这个参数非常重要，直接影响查询结果。 |
'IN' 'NOT IN' 'AND' |
include_children |
bool | 是否包含子分类。 默认值为 true。 如果设置为 false，则只查询指定的分类，不包含其子分类。 |
true false |
二、operator 参数详解：灵魂所在
operator 参数是 WP_Tax_Query 的灵魂， 它决定了多个术语之间如何组合。 咱们一个一个来：
-
IN：包含 (默认值)表示文章必须至少属于
terms数组中的一个术语。$args = array( 'tax_query' => array( array( 'taxonomy' => 'category', 'field' => 'term_id', 'terms' => array( 1, 2, 3 ), // 分类 ID 为 1, 2, 3 的文章 'operator' => 'IN', //可省略，默认就是 IN ), ), ); $query = new WP_Query( $args );这段代码会查询所有属于分类 ID 为 1、2 或 3 的文章。 只要文章属于其中任何一个分类，就会被查出来。
-
NOT IN：不包含表示文章不能属于
terms数组中的任何一个术语。$args = array( 'tax_query' => array( array( 'taxonomy' => 'post_tag', 'field' => 'slug', 'terms' => array( 'featured', 'popular' ), // slug 为 featured 和 popular 的标签 'operator' => 'NOT IN', ), ), ); $query = new WP_Query( $args );这段代码会查询所有不属于标签 slug 为
featured和popular的文章。 -
AND：并且表示文章必须同时属于
terms数组中的所有术语。$args = array( 'tax_query' => array( array( 'taxonomy' => 'category', 'field' => 'term_id', 'terms' => array( 4, 5 ), // 分类 ID 为 4 和 5 'operator' => 'AND', ), ), ); $query = new WP_Query( $args );这段代码会查询所有同时属于分类 ID 为 4 和 5 的文章。 注意：这个
AND和WP_Tax_Query的relation参数里的AND是不同的概念，别搞混了！ 这里的AND是指同一个分类法下，多个术语之间的关系。 -
EXISTS：存在表示文章必须属于指定的分类法。
terms参数会被忽略。 这通常用于检查文章是否有关联的分类法。$args = array( 'tax_query' => array( array( 'taxonomy' => 'category', 'operator' => 'EXISTS', ), ), ); $query = new WP_Query( $args );这段代码会查询所有属于
category分类法的文章。 无论属于哪个具体的分类，只要属于category分类法，就会被查出来。 -
NOT EXISTS：不存在表示文章不能属于指定的分类法。
terms参数会被忽略。 这通常用于查找没有关联指定分类法的文章。$args = array( 'tax_query' => array( array( 'taxonomy' => 'post_tag', 'operator' => 'NOT EXISTS', ), ), ); $query = new WP_Query( $args );这段代码会查询所有不属于
post_tag分类法的文章。 也就是所有没有打标签的文章。
三、多个 tax_query 的组合：relation 参数
如果我们需要组合多个 tax_query， 比如要查找既属于“新闻”分类，又属于“体育”分类的文章，或者查找属于“新闻”分类或属于“体育”分类的文章，就需要用到 relation 参数了。
relation 参数可选值：
'AND'(默认)：表示所有tax_query都必须满足。'OR'：表示至少有一个tax_query满足。
$args = array(
'tax_query' => array(
'relation' => 'AND', // 所有条件都必须满足
array(
'taxonomy' => 'category',
'field' => 'slug',
'terms' => array( 'news' ),
),
array(
'taxonomy' => 'post_tag',
'field' => 'slug',
'terms' => array( 'featured' ),
),
),
);
$query = new WP_Query( $args );这段代码会查询所有既属于“新闻”分类，又属于“featured”标签的文章。
$args = array(
'tax_query' => array(
'relation' => 'OR', // 至少一个条件满足
array(
'taxonomy' => 'category',
'field' => 'slug',
'terms' => array( 'news' ),
),
array(
'taxonomy' => 'post_tag',
'field' => 'slug',
'terms' => array( 'featured' ),
),
),
);
$query = new WP_Query( $args );这段代码会查询所有属于“新闻”分类，或者属于“featured”标签的文章。 只要满足其中一个条件，就会被查出来。
四、实战演练：构建各种奇葩查询
理论讲了一堆，咱们来点实际的，用 WP_Tax_Query 构建一些更复杂的查询条件。
-
查询属于“新闻”分类，但不属于“重要新闻”分类的文章：
$args = array( 'tax_query' => array( 'relation' => 'AND', array( 'taxonomy' => 'category', 'field' => 'slug', 'terms' => array( 'news' ), 'operator' => 'IN', // 必须属于“新闻”分类 ), array( 'taxonomy' => 'category', 'field' => 'slug', 'terms' => array( 'important-news' ), 'operator' => 'NOT IN', // 不能属于“重要新闻”分类 ), ), ); $query = new WP_Query( $args ); -
查询属于“红色”或“蓝色”颜色，并且尺寸是“大号”的产品（假设自定义分类法）：
$args = array( 'tax_query' => array( 'relation' => 'AND', array( 'relation' => 'OR', // 颜色是红色或蓝色 array( 'taxonomy' => 'color', 'field' => 'slug', 'terms' => array( 'red' ), ), array( 'taxonomy' => 'color', 'field' => 'slug', 'terms' => array( 'blue' ), ), ), array( 'taxonomy' => 'size', 'field' => 'slug', 'terms' => array( 'large' ), ), ), ); $query = new WP_Query( $args );注意：这里我们用了一个嵌套的
relation， 先用'OR'组合了颜色条件，然后再用'AND'把颜色条件和尺寸条件组合起来。 这就是WP_Tax_Query的强大之处，可以构建任意复杂的查询条件。 -
查询没有关联任何标签的文章：
$args = array( 'tax_query' => array( array( 'taxonomy' => 'post_tag', 'operator' => 'NOT EXISTS', ), ), ); $query = new WP_Query( $args ); -
查询属于某个分类及其所有子分类的文章：
$args = array( 'tax_query' => array( array( 'taxonomy' => 'category', 'field' => 'term_id', 'terms' => array( 10 ), // 分类 ID 为 10 'include_children' => true, // 包含子分类 ), ), ); $query = new WP_Query( $args );这段代码会查询所有属于分类 ID 为 10 及其所有子分类的文章。 如果
include_children设置为false，则只会查询属于分类 ID 为 10 的文章，不包含其子分类。
五、WP_Tax_Query 的幕后黑手：SQL 查询分析
WP_Tax_Query 最终会生成 SQL 查询语句，然后交给 WordPress 数据库来执行。 我们可以通过 get_posts() 函数的 suppress_filters 参数来查看生成的 SQL 语句。
$args = array(
'tax_query' => array(
array(
'taxonomy' => 'category',
'field' => 'slug',
'terms' => array( 'news' ),
),
),
'posts_per_page' => 5,
'suppress_filters' => false, // 设置为 false，允许我们拦截 SQL 查询
);
add_filter( 'posts_request', 'debug_tax_query_sql' );
function debug_tax_query_sql( $sql ) {
remove_filter( 'posts_request', 'debug_tax_query_sql' );
echo '<pre>';
print_r( $sql );
echo '</pre>';
return $sql;
}
$posts = get_posts( $args );这段代码会打印出生成的 SQL 查询语句。 通过分析 SQL 语句，我们可以更深入地理解 WP_Tax_Query 的工作原理，以及如何优化查询性能。
六、性能优化：避免滥用
虽然 WP_Tax_Query 很强大，但是滥用它可能会导致性能问题。 特别是当你的网站内容很多，分类法术语也很多的时候，复杂的 tax_query 会生成非常庞大的 SQL 查询语句，导致查询速度变慢。
以下是一些建议：
- 尽量使用 ID 而不是 slug 或 name： 使用 ID 查询通常比使用 slug 或 name 更快，因为 ID 是数字类型的，而 slug 和 name 是字符串类型的。
- 避免过于复杂的嵌套查询： 过于复杂的嵌套查询会增加 SQL 语句的复杂度，导致查询速度变慢。 尽量把复杂的查询拆分成多个简单的查询。
- 使用缓存： 如果查询结果不会经常变化，可以使用 WordPress 的对象缓存或者其他缓存机制来缓存查询结果，避免重复查询数据库。
- 合理使用
include_children： 如果不需要查询子分类，一定要把include_children设置为false， 避免不必要的查询。 - 分析 SQL 查询： 定期分析生成的 SQL 查询语句，找出性能瓶颈，并进行优化。
七、总结：WP_Tax_Query 的正确打开方式
WP_Tax_Query 是 WordPress 里一个非常重要的类， 掌握它可以让你轻松构建各种复杂的分类法查询。 但是，要记住，能力越大，责任越大。 合理使用 WP_Tax_Query，才能让你的网站飞起来！
好了，今天的讲座就到这里，希望大家有所收获！ 以后遇到 WP_Tax_Query，再也不用怕它了！ 散会！