本教程详细讲解如何在wordpress中使用wp_query的tax_query参数，通过设置relation为'and'来精确查询同时属于多个自定义分类法的文章。文章将提供清晰的代码示例，演示如何构建高效的查询逻辑，并获取符合特定多分类条件的文章数量，帮助开发者解决复杂的文章筛选需求。
在WordPress开发中，经常需要根据文章所属的分类法（Taxonomy）来筛选文章。当需求是查询同时属于两个或更多特定分类法中的文章时，就需要巧妙地利用WP_Query的tax_query参数。本文将深入探讨如何正确配置tax_query以实现这种“交集”查询，并提供实际的代码示例。
理解 WP_Query 的 tax_query 参数
WP_Query是WordPress中用于从数据库中检索文章、页面、自定义文章类型等内容的核心函数。其tax_query参数专门用于构建基于分类法的复杂查询。
tax_query是一个数组，其中每个元素代表一个分类法查询条件。更重要的是，tax_query可以包含一个relation键，用于指定其内部子查询之间的逻辑关系。
-
relation:
- 'AND'：表示所有子查询条件都必须满足。
- 'OR'：表示只要满足任一子查询条件即可。
- 这个relation键可以应用于tax_query的顶层，也可以应用于嵌套的子查询数组。
每个子查询数组通常包含以下键：
- taxonomy: 要查询的分类法名称（slug）。
- field: 用于指定terms数组中值的类型，可以是'id'（分类ID）、'slug'（分类别名）或'name'（分类名称）。
- terms: 一个数组，包含要匹配的分类项ID、别名或名称。
- operator: 比较操作符，如'IN'（默认，匹配terms中的任意一个）、'NOT IN'、'AND'（匹配terms中的所有）。
- include_children: 布尔值，是否包含子分类的文章（默认为true）。
实现多分类交集查询
要查询同时属于两个不同分类法的文章，关键在于将tax_query的顶层relation设置为'AND'，并为每个分类法定义一个独立的查询数组。
假设我们有一个自定义文章类型'property'，以及两个自定义分类法'location'（地点）和'set'（类型，如出售/出租）。我们希望查询某个特定地点下，同时是“出售”或“出租”的房产数量。
以下是一个实现此功能的通用函数：
/**
* 获取同时属于指定两个分类法的文章数量。
*
* @param string $post_type 文章类型。
* @param string $primary_taxonomy_slug 主分类法的别名。
* @param mixed $primary_term_value 主分类项的值（ID或slug）。
* @param string $primary_field_type 主分类项的字段类型（'id'或'slug'）。
* @param string $secondary_taxonomy_slug 次要分类法的别名。
* @param mixed $secondary_term_value 次要分类项的值（ID或slug）。
* @param string $secondary_field_type 次要分类项的字段类型（'id'或'slug'）。
* @return int 符合条件的文章数量。
*/
function get_posts_count_by_two_taxonomies(
$post_type,
$primary_taxonomy_slug,
$primary_term_value,
$primary_field_type,
$secondary_taxonomy_slug,
$secondary_term_value,
$secondary_field_type
) {
$args = array(
'post_type' => $post_type,
'post_status' => 'publish',
'posts_per_page' => -1, // 获取所有匹配的文章，不分页
'fields' => 'ids', // 仅获取文章ID，提高性能
'tax_query' => array(
'relation' => 'AND', // 关键：两个分类条件必须同时满足
array(
'taxonomy' => $primary_taxonomy_slug,
'field' => $primary_field_type,
'terms' => (array) $primary_term_value, // 确保terms是数组
),
array(
'taxonomy' => $secondary_taxonomy_slug,
'field' => $secondary_field_type,
'terms' => (array) $secondary_term_value, // 确保terms是数组
),
),
);
$query = new WP_Query($args);
return $query->found_posts; // 使用found_posts获取总数，更准确
}代码解析：
- 'posts_per_page' => -1: 确保WP_Query返回所有匹配的文章，而不是默认的分页数量。
- 'fields' => 'ids': 这是一个性能优化技巧。当只需要文章数量而不需要文章的完整数据时，设置此参数可以显著减少数据库查询的开销。
- 'tax_query' => array('relation' => 'AND', ...): 这是实现交集查询的核心。它告诉WordPress，后续的两个分类法条件必须同时满足。
- 两个独立的分类法数组: 分别定义了主分类和次分类的查询条件，包括分类法名称、字段类型和要匹配的分类项值。
- return $query->found_posts;: WP_Query对象的found_posts属性会返回查询到的总文章数，即使posts_per_page限制了返回的文章数量，它依然能给出准确的总数。这比post_count在分页场景下更可靠。
动态上下文中的应用
在某些场景下，例如在某个location分类归档页面中，我们可能需要动态获取当前的location分类信息。get_queried_object()函数可以帮助我们实现这一点。
/**
* 在特定分类归档页获取文章数量，结合另一个指定分类。
*
* @param string $post_type 文章类型。
* @param string $secondary_taxonomy_slug 次要分类法的别名（例如 'set'）。
* @param mixed $secondary_term_value 次要分类项的值（ID或slug）。
* @param string $secondary_field_type 次要分类项的字段类型（'id'或'slug'）。
* @return int|string 符合条件的文章数量，或错误信息。
*/
function get_post_count_in_current_taxonomy(
$post_type,
$secondary_taxonomy_slug,
$secondary_term_value,
$secondary_field_type
) {
// 检查当前是否在分类归档页面
if (!is_tax() && !is_category() && !is_tag()) {
return 'Not on a taxonomy archive page.';
}
$current_obj = get_queried_object(); // 获取当前查询的对象（例如当前分类对象）
// 确保获取到的是一个分类对象
if (!($current_obj instanceof WP_Term)) {
return 'Invalid queried object.';
}
$args = array(
'post_type' => $post_type,
'post_status' => 'publish',
'posts_per_page' => -1,
'fields' => 'ids',
'tax_query' => array(
'relation' => 'AND',
array(
'taxonomy' => $current_obj->taxonomy, // 当前页面的分类法 
