获取关联分类法的WordPress用户列表方法

在WordPress开发中，有时我们需要识别出与特定分类法（Taxonomy）术语（Term）相关的用户。由于WordPress默认的用户模型并未直接与分类法建立关系，这种关联通常是通过用户发布的文章（Posts）或自定义文章类型（Custom Post Types）间接实现的。然而，在某些特定的定制化场景下，用户ID也可能被直接关联到分类法关系表中。本文将探讨这两种主要实现方式。

方法一：通过用户发布的文章间接关联 (使用 WP_Query)

这是最常见且符合WordPress最佳实践的方法，它基于一个前提：用户与分类法的关联是通过他们所撰写或发布的文章来实现的。例如，如果一个用户发布了一篇属于“产品分类”中“电子产品”术语的文章，那么该用户就被视为与“电子产品”这个分类法术语相关联。

核心思想：

1. 获取所有（或部分）WordPress用户。
2. 对于每个用户，执行一个 WP_Query 查询，检查他们是否发布了满足以下条件的文章：
   • 属于特定的文章类型（例如，post 或某个自定义文章类型 product）。
   • 属于指定的分类法（例如，category 或某个自定义分类法 product_cat）。
   • 属于该分类法下的特定术语（通过术语ID或slug）。

示例代码：

以下代码演示了如何遍历所有用户，并查找那些发布了属于特定自定义文章类型（product）和特定分类法（product_cat）术语（ID为 22）的文章的用户。

// 1. 定义查询用户时的参数 (可选，此处为空表示获取所有用户)
$user_args = array(
    'orderby' => 'ID', // 按用户ID排序
    // 'include' => array(11, 33, 52, 57, 997) // 如果已知特定用户ID，可在此处指定以优化性能
);

// 2. 获取所有用户
$users = get_users($user_args);

$associated_user_ids = array(); // 用于存储最终关联的用户ID

// 3. 遍历每个用户
foreach ($users as $user) {
    // 4. 为当前用户构建 WP_Query 查询，查找其发布的文章
    $user_posts_query = new WP_Query(array(
        'post_type'      => 'product',      // 替换为您的自定义文章类型slug
        'author'         => $user->ID,      // 查询当前用户发布的文章
        'posts_per_page' => 1,              // 只需要检查是否存在，所以只取一篇即可
        'tax_query'      => array(          // 分类法查询
            array(
                'taxonomy' => 'product_cat', // 替换为您的自定义分类法slug
                'field'    => 'term_id',     // 根据术语ID查询
                'terms'    => 22             // 替换为您的目标术语ID
            )
        ),
        'fields'         => 'ids'           // 仅获取文章ID，提高效率
    ));

    // 5. 如果查询结果存在文章，则表示该用户与指定分类法术语关联
    if ($user_posts_query->have_posts()) {
        // echo $user->first_name . ' ' . $user->last_name . ' 关联到分类法术语ID 22
';
        $associated_user_ids[] = $user->ID; // 存储用户ID
    }

    // 重置文章数据，以避免对后续查询产生影响
    wp_reset_postdata();
}

// 输出所有关联的用户ID
if (!empty($associated_user_ids)) {
    echo '与分类法术语ID 22关联的用户ID：' . implode(', ', $associated_user_ids) . '
';
} else {
    echo '没有用户与分类法术语ID 22关联。
';
}

代码解析：

• get_users($user_args): 用于获取WordPress用户列表。通过 include 参数可以指定要查询的特定用户ID，这在已知用户范围时能显著提升性能。
• WP_Query: WordPress用于查询文章的核心类。
  • post_type: 指定要查询的文章类型，例如 post（默认文章）、page（页面）或任何自定义文章类型（如 product）。
  • author: 指定文章作者的用户ID。
  • posts_per_page: 设置每页显示的文章数量。设置为 1 或 -1（全部）取决于你的需求。如果只是检查是否存在，1 更高效。
  • tax_query: 用于构建复杂的分类法查询。它是一个数组，其中每个内部数组定义一个分类法查询条件。
    • taxonomy: 分类法的slug（例如 category, product_cat）。
    • field: 用于匹配术语的字段，可以是 term_id, slug, name 等。
    • terms: 要匹配的术语值，可以是单个ID/slug或数组。
• wp_reset_postdata(): 在循环结束后或每次 WP_Query 之后调用，以确保全局 post 对象被正确重置，避免影响后续的模板标签和查询。

注意事项：

• 性能考量： 对于拥有大量用户和大量文章的网站，循环遍历所有用户并为每个用户执行 WP_Query 可能会导致性能问题。如果可能，应尽量限制 get_users() 的范围（例如，通过 include 参数）。
• 自定义文章类型和分类法： 务必将代码中的 product 和 product_cat 替换为您实际使用的自定义文章类型和分类法slug。
• 术语ID： terms 参数通常使用术语ID。您可以使用 get_term_by() 函数通过术语slug或名称获取其ID。

方法二：直接数据库查询 (SQL)

在某些高度定制化的场景下，用户ID可能被直接存储在 wp_term_relationships 表的 object_id 字段中，从而与分类法术语建立直接关联。这并非WordPress的标准行为（通常 object_id 存储文章ID），但如果您的系统存在这样的定制，直接执行SQL查询会是最直接高效的方法。

核心思想： 通过SQL联接 wp_users 表和 wp_term_relationships 表，筛选出 user_status 为0（活动用户）且 term_taxonomy_id 匹配指定分类法术语的用户。

示例代码：

以下代码演示了如何使用WordPress的 $wpdb 全局对象执行SQL查询，以获取直接与 term_taxonomy_id 为 1186 关联的用户ID。

get_results(
    "SELECT u.ID FROM {$wpdb->users} u 
     INNER JOIN {$wpdb->term_relationships} r ON u.ID = r.object_id 
     WHERE u.user_status = 0 
     AND r.term_taxonomy_id = 1186", // 替换为您的目标 term_taxonomy_id
    ARRAY_A // 以关联数组形式返回结果
);

// 处理查询结果，提取用户ID
if (!empty($results)) {
    foreach ($results as $row) {
        $all_ids[] = $row['ID'];
    }
}

// 输出所有关联的用户ID
if (!empty($all_ids)) {
    echo '通过直接SQL查询关联的用户ID：' . implode(', ', $all_ids) . '
';
} else {
    echo '没有用户通过直接SQL查询关联到 term_taxonomy_id 1186。
';
}

代码解析：

• global $wpdb;: 引入WordPress的数据库操作全局对象。
• $wpdb->users, $wpdb->term_relationships: 这是WordPress提供的表名前缀常量，确保SQL查询能够适应不同的数据库表前缀。
• SELECT u.ID FROM ...: 选择 wp_users 表中的用户ID。
• INNER JOIN ... ON u.ID = r.object_id: 将 wp_users 表与 wp_term_relationships 表联接起来，条件是用户ID等于关系表中的对象ID。再次强调，这假设了 object_id 可以是用户ID。
• WHERE u.user_status = 0: 筛选出状态为 0 的用户，通常表示活动用户。
• AND r.term_taxonomy_id = 1186: 筛选出与特定 term_taxonomy_id 关联的记录。term_taxonomy_id 是 wp_term_taxonomy 表中的ID，它唯一标识一个分类法下的一个术语。
• ARRAY_A: 指定 get_results 返回结果的格式为关联数组。
• foreach ($results as $row): 遍历查询结果，将每个用户ID添加到 $all_ids 数组中。

注意事项：

• 适用场景限定： 此方法仅适用于 wp_term_relationships.object_id 字段确实存储用户ID的特殊情况。在标准的WordPress安装中，此字段通常存储文章ID。在不确定时，请优先使用方法一。
• term_taxonomy_id： 确保您使用的 term_taxonomy_id 是正确的。它不同于 term_id，一个 term_id 在不同分类法下可能有不同的 term_taxonomy_id。
• 安全性： 直接执行SQL查询需要格外小心，以防止SQL注入漏洞。在此示例中，term_taxonomy_id 是硬编码的整数，风险较低。如果参数来自用户输入，务必使用 $wpdb->prepare() 进行安全处理。
• 可维护性： 直接SQL查询可能不如使用WordPress API（如 WP_Query）那样易于理解和维护，因为它绕过了WordPress的抽象层。

选择合适的方法

• 优先使用方法一（WP_Query）： 如果用户与分类法的关联是通过他们发布的文章（或自定义文章类型）实现的，那么方法一是推荐的标准做法。它利用了WordPress的API，更安全、更易于维护，并且受益于WordPress的缓存机制。
• 谨慎使用方法二（直接SQL）： 仅当您明确知道在您的WordPress环境中，用户ID被直接存储在 wp_term_relationships.object_id 中，并且方法一无法满足您的需求时，才考虑使用直接SQL查询。此方法更底层，可能提供更高的性能，但风险和维护成本也相对较高。

总结与最佳实践

获取与特定分类法关联的WordPress用户，通常涉及间接关联或特殊直接关联两种情况。理解您的系统如何建立这种关联是选择正确方法的关键。

• 明确关联方式： 确定用户与分类法是通过其发布的文章间接关联，还是通过定制化设置直接关联。
• 利用WordPress API： 优先使用 get_users() 和 WP_Query 等WordPress提供的API。它们提供了强大的功能，同时确保了代码的兼容性、安全性和可维护性。
• 替换占位符： 在使用示例代码时，务必将 post_type、taxonomy、term_id 和 term_taxonomy_id 等占位符替换为您实际项目中的值。
• 性能优化： 对于大型网站，考虑查询的性能影响。例如，限制 get_users() 的范围，或在 WP_Query 中使用 posts_per_page=1 和 fields='ids' 进行优化。

通过本文提供的两种方法，您可以根据项目的具体需求和系统配置，有效地获取与WordPress分类法关联的用户列表。