WP_Query自定义字段数组匹配问题求助

问题根源 #

你的allowed_userroles是数组类型的自定义字段，WordPress会将其序列化为字符串存储在数据库中。而IN比较符的作用是检查单个元值是否存在于给定数组中，无法处理元值本身是数组的情况，所以直接用IN不会生效。

解决方案 #

下面提供两种可行的实现方式，均基于序列化字段的匹配逻辑：

方法1：使用正则表达式（REGEXP）匹配任意角色

通过生成正则表达式，匹配序列化字段中包含的任意用户角色：

$roles = [];
if (is_user_logged_in()) {
    $user = wp_get_current_user();
    // 重置数组键为连续索引，避免序列化后的键影响匹配
    $roles = array_values( (array) $user->roles );
}

$args = [
    'post_type' => 'downloads',
    'posts_per_page' => -1,
    'meta_query' => [
        'relation' => 'OR',
        [
            'key' => 'public',
            'value' => true,
            'compare' => '=',
        ],
    ],
];

// 若用户有角色，添加正则匹配条件
if (!empty($roles)) {
    // 转义角色名中的正则特殊字符，防止匹配异常
    $role_patterns = array_map(function($role) {
        return preg_quote($role, '/');
    }, $roles);
    // 生成匹配任意角色的正则表达式
    $regex = '/(' . implode('|', $role_patterns) . ')/';

    $args['meta_query'][] = [
        'key' => 'allowed_userroles',
        'value' => $regex,
        'compare' => 'REGEXP',
    ];
}

方法2：为每个角色创建独立LIKE条件

为用户的每个角色单独创建LIKE条件，通过OR关联，匹配序列化字段中的角色字符串：

$roles = [];
if (is_user_logged_in()) {
    $user = wp_get_current_user();
    $roles = array_values( (array) $user->roles );
}

$meta_query = [
    'relation' => 'OR',
    [
        'key' => 'public',
        'value' => true,
        'compare' => '=',
    ],
];

// 为每个角色添加LIKE匹配条件
if (!empty($roles)) {
    $role_conditions = [];
    foreach ($roles as $role) {
        $role_conditions[] = [
            'key' => 'allowed_userroles',
            'value' => '"' . esc_sql($role) . '"', // 匹配序列化后的带引号角色字符串
            'compare' => 'LIKE',
        ];
    }
    // 将角色条件作为OR组加入主查询条件
    $meta_query[] = [
        'relation' => 'OR',
        ...$role_conditions,
    ];
}

$args = [
    'post_type' => 'downloads',
    'posts_per_page' => -1,
    'meta_query' => $meta_query,
];

关键说明 #

• WordPress存储数组类型自定义字段时，会将其序列化为类似a:3:{i:0;s:5:"role1";i:1;s:5:"role2";i:2;s:5:"role3";}的字符串，所以匹配时需要针对这种格式处理。
• 使用array_values()重置用户角色数组的键，是因为原角色数组的键（如16、17）是用户角色在数据库中的ID，序列化后不会影响角色名的存储，但重置后能避免后续处理的潜在问题。

内容的提问来源于stack exchange，提问作者Kaspersvh