WordPress WP_Query 高级应用：实现多分类法“AND”关系查询

本教程详细阐述了如何在 wordpress 中使用 `wp_query` 来查询同时属于多个指定分类法（taxonomy）下的文章。通过正确配置 `tax_query` 参数中的 `relation` 为 `and`，并结合动态获取当前分类法上下文的方法，确保查询结果精确匹配所有条件，有效解决跨分类法交集查询的复杂性。

在 WordPress 开发中，我们经常需要根据分类法（Taxonomy）来筛选文章。然而，当需求变得复杂，例如需要查询同时属于“地点”分类法下的某个城市，并且也属于“类型”分类法下的“出售”标签的文章时，简单的 WP_Query 配置可能无法满足要求。这种情况下，我们需要精确地使用 tax_query 参数中的 relation =youjiankuohaophpcn 'AND' 来实现多个分类法之间的“与”关系查询。

理解 WP_Query 的 tax_query 参数

WP_Query 是 WordPress 中用于从数据库中检索文章、页面、自定义文章类型等内容的核心类。其 tax_query 参数专门用于处理基于分类法的查询。

tax_query 接受一个数组，其中每个元素代表一个分类法查询条件。更重要的是，它支持一个 relation 参数，用于定义这些条件之间的逻辑关系：

• 'AND'：文章必须满足所有分类法条件。
• 'OR'：文章只需满足任一分类法条件。

当我们需要查询同时属于多个分类法及其术语（term）的文章时，必须将顶层 tax_query 的 relation 设置为 'AND'。

构建多分类法“AND”关系查询

为了实现同时包含在两个或更多分类法中的文章查询，tax_query 的结构应如下所示：

$args = array(
    'post_type'      => 'your_post_type', // 指定文章类型
    'posts_per_page' => -1,               // 获取所有匹配的文章
    'tax_query'      => array(
        'relation' => 'AND', // 关键：指定所有内部条件必须同时满足
        array(
            'taxonomy' => 'taxonomy_1_slug', // 第一个分类法的别名
            'field'    => 'slug',           // 查询字段，可以是 'id', 'slug', 'name'
            'terms'    => 'term_1_slug',    // 第一个分类法下的术语别名
        ),
        array(
            'taxonomy' => 'taxonomy_2_slug', // 第二个分类法的别名
            'field'    => 'id',             // 查询字段
            'terms'    => 123,              // 第二个分类法下的术语ID
        ),
        // 可以根据需要添加更多分类法条件
    ),
);

$query = new WP_Query($args);

在这个结构中，relation => 'AND' 位于 tax_query 的顶层，确保了文章必须同时满足 taxonomy_1_slug 和 taxonomy_2_slug 的条件。

结合动态上下文的查询函数

在实际应用中，我们可能需要在某个分类法归档页面上，根据当前页面的分类法术语来进一步筛选文章。以下是一个结合 get_queried_object() 实现动态查询的示例函数，用于统计特定文章类型在当前分类法页面下，并且也属于另一个指定分类法的文章数量。

Flawless AI

好莱坞2.0，电影制作领域的生成式AI工具

32

查看详情

/**
 * 根据文章类型、分类法别名和术语别名获取文章数量
 *
 * @param string $post_type   要查询的文章类型别名
 * @param string $taxonomy    第二个分类法的别名
 * @param string $term_slug   第二个分类法下的术语别名
 * @return int|string         匹配的文章数量，或“Nothing found”
 */
function get_post_count_by_term_slug($post_type, $taxonomy, $term_slug) {
    // 获取当前查询的对象，例如在 'location' 分类法归档页时，会返回 'location' 的 term 对象
    $current_obj = get_queried_object();

    // 检查是否在 'location' 分类法页面，如果不是，则不执行查询
    // 此处 'location' 是一个示例，应替换为你的主分类法别名
    if (!is_tax('location')) {
        return 'Invalid Context'; // 或者返回 0
    }

    $args = array(
        'post_type'      => $post_type,
        'posts_per_page' => -1, // 获取所有匹配的文章，以便准确计数
        'tax_query'      => array(
            'relation' => 'AND', // 确保文章同时属于这两个分类法条件
            array(
                'taxonomy' => $current_obj->taxonomy, // 获取当前页面的分类法别名
                'field'    => 'id',                   // 通过 ID 匹配
                'terms'    => $current_obj->term_id   // 获取当前页面的术语 ID
            ),
            array(
                'taxonomy' => $taxonomy,              // 第二个分类法的别名
                'field'    => 'slug',                 // 通过别名匹配
                'terms'    => $term_slug              // 第二个分类法下的术语别名
            )
        ),
    );

    $count_query = new WP_Query($args);

    if ($count_query->have_posts()) {
        return $count_query->post_count; // 返回文章数量
    } else {
        return 0; // 没有找到匹配的文章
    }
}

代码解析：

1. get_queried_object(): 这个函数在 WordPress 的循环外部非常有用，它能返回当前正在查询的对象。例如，在分类法归档页 (is_tax()) 上，它会返回当前分类法术语的对象，包含 taxonomy 和 term_id 等信息。
2. is_tax('location'): 这是一个条件判断，确保我们只在特定的分类法归档页面（例如 location 分类法）上执行后续逻辑，避免在不相关的页面上运行不必要的查询。
3. tax_query 结构:
   • 'relation' => 'AND'：这是核心，保证了两个分类法条件必须同时满足。
   • 第一个子数组：动态地获取当前页面的分类法 ($current_obj->taxonomy) 和术语 ID ($current_obj->term_id)。
   • 第二个子数组：使用函数参数传入的第二个分类法别名 ($taxonomy) 和术语别名 ($term_slug)。
4. posts_per_page => -1: 设置为 -1 可以确保 WP_Query 返回所有匹配的文章，从而 post_count 能给出准确的总数。如果只需要检查是否存在而不关心具体数量，可以设置为 1 并检查 have_posts()。
5. $count_query->post_count: WP_Query 对象在执行后会存储匹配的文章总数，直接访问此属性即可获得。

如何在模板中使用

假设我们有一个自定义文章类型 property，并且有两个分类法 location 和 set。location 用于表示地点，set 用于表示房产的出售或出租状态（例如，sell 和 rent 是 set 分类法下的术语）。

在 location 分类法的归档模板（如 taxonomy-location.php）中，我们可以这样使用上述函数来显示不同状态的房产数量：

<div class="count_property">
    <div class="sell">
        <span class="strong">出售:</span> <?php echo get_post_count_by_term_slug('property', 'set', 'sell'); ?>
    </div>
    <div class="rent">
        <span class="strong">出租:</span> <?php echo get_post_count_by_term_slug('property', 'set', 'rent'); ?>
    </div>
</div>

在这个例子中：

• 'property' 是自定义文章类型。
• 'set' 是第二个分类法的别名。
• 'sell' 和 'rent' 是 set 分类法下的术术别名。

当用户访问某个 location 的归档页面时（例如 /location/new-york/），上述代码将分别显示在“纽约”地区中“出售”的房产数量和“出租”的房产数量。

注意事项与最佳实践

1. 性能考量: posts_per_page => -1 会获取所有匹配的文章。如果匹配的文章数量非常大，这可能会对性能产生影响。对于仅仅需要计数的情况，WP_Query 内部已经优化，直接访问 post_count 通常是高效的。
2. field 参数的选择: field 参数可以是 'id'、'slug' 或 'name'。通常建议使用 'id' 或 'slug'，因为它们是唯一的标识符。'name' 可能会因术语名称的重复而导致歧义。
3. 错误处理与默认值: 在实际项目中，应为函数添加更健壮的错误处理，例如当 get_queried_object() 返回 null 或上下文不符合预期时，返回一个默认值（如 0）而不是错误信息。
4. 可读性与维护性: 将复杂的查询逻辑封装到函数中，可以提高代码的可读性和复用性。确保函数名和变量名具有描述性。

总结

通过本教程，我们深入理解了如何利用 WP_Query 的 tax_query 参数，特别是 relation => 'AND' 属性，来构建复杂的、同时满足多个分类法条件的文章查询。结合 get_queried_object() 等 WordPress 内置函数，我们可以创建出动态且高效的查询逻辑，从而在各种场景下精确地筛选和展示内容。掌握这种高级查询技巧，将极大地提升你在 WordPress 开发中的灵活性和能力。

以上就是WordPress WP_Query 高级应用：实现多分类法“AND”关系查询的详细内容，更多请关注php中文网其它相关文章！