分析 WordPress `WP_User_Query` 类的源码：如何通过 `meta_query` 查询用户元数据。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众老爷们，大家好！欢迎来到今天的 "WordPress Meta-query大冒险" 特别节目。我是你们的老朋友，代码界的段子手，今天咱们就来扒一扒 WordPress 的 WP_User_Query 类，重点讲解如何通过 meta_query 这个神奇的东东来查询用户元数据。

准备好了吗？系好安全带，让我们一起进入这个略微有点枯燥，但绝对实用的技术之旅！

一、WP_User_Query 是个啥？

首先，咱们先来认识一下今天的主角 WP_User_Query。简单来说，它就是 WordPress 提供的一个专门用来查询用户的类。就像你用 SQL 语句 SELECT * FROM wp_users WHERE ... 一样，WP_User_Query 帮你构建更复杂、更灵活的用户查询。

二、用户元数据 (User Meta) 是个啥？

在 WordPress 里面，除了用户的基础信息（用户名、密码、邮箱等等）之外，我们还可以给用户添加一些自定义的信息，这些信息就叫做用户元数据 (User Meta)。举个例子，你可以给用户添加 "喜欢的颜色"、"个人简介"、"上次登录时间" 等等。这些数据都存储在 wp_usermeta 表里。

三、meta_query：查询用户元数据的利器

现在，重头戏来了！ meta_query 就是 WP_User_Query 类提供的一个参数，专门用来查询用户元数据的。它可以让你根据用户元数据的值来筛选用户。

四、meta_query 的结构

meta_query 本身是一个数组，数组里面的每个元素都是一个关联数组，描述一个元数据查询的条件。让我们先来看看 meta_query 的基本结构：

$args = array(
    'meta_query' => array(
        array(
            'key'     => 'meta_key', // 元数据的键名
            'value'   => 'meta_value', // 元数据的值
            'compare' => '=',          // 比较操作符
            'type'    => 'CHAR',       // 元数据的数据类型
        ),
        // 可以添加多个条件
    )
);

$user_query = new WP_User_Query( $args );

key: 必须的参数，指定你要查询的元数据的键名。比如，你想查询 "喜欢的颜色"，那 key 就应该是 'favorite_color'。
value: 可选参数，指定你要查询的元数据的值。比如，你想查询喜欢红色的人，那 value 就应该是 'red'。如果你只是想查询存在某个元数据的用户，而不管它的值是什么，可以省略 value。
compare: 可选参数，指定比较操作符。默认值是 '=' (等于)。还有很多其他的操作符，比如 '!=' (不等于), '>' (大于), '<' (小于), 'LIKE' (模糊匹配), 'IN' (在某个数组里), 'NOT IN' (不在某个数组里), 'BETWEEN' (在两个值之间), 'NOT BETWEEN' (不在两个值之间), 'EXISTS' (存在), 'NOT EXISTS' (不存在)。
type: 可选参数，指定元数据的数据类型。默认值是 'CHAR' (字符串)。还有 'NUMERIC' (数值型), 'BINARY' (二进制)。当你使用数值型的比较操作符 (比如 '>' 或 '<') 时，一定要设置 type 为 'NUMERIC'。

五、compare 操作符详解

compare 操作符是 meta_query 的灵魂，它决定了你的查询如何比较元数据的值。让我们来逐一击破这些操作符：

操作符	含义	示例
`=`	等于	`'compare' => '=', 'value' => 'red'` (查询喜欢的颜色是红色的人)
`!=`	不等于	`'compare' => '!=', 'value' => 'red'` (查询喜欢的颜色不是红色的人)
`>`	大于	`'compare' => '>', 'value' => 18, 'type' => 'NUMERIC'` (查询年龄大于18岁的人，注意 `type` 必须是 `'NUMERIC'`)
`<`	小于	`'compare' => '<', 'value' => 30, 'type' => 'NUMERIC'` (查询年龄小于30岁的人，注意 `type` 必须是 `'NUMERIC'`)
`>=`	大于等于	`'compare' => '>=', 'value' => 60, 'type' => 'NUMERIC'` (查询年龄大于等于60岁的人，注意 `type` 必须是 `'NUMERIC'`)
`<=`	小于等于	`'compare' => '<=', 'value' => 12, 'type' => 'NUMERIC'` (查询年龄小于等于12岁的人，注意 `type` 必须是 `'NUMERIC'`)
`LIKE`	模糊匹配 (包含)	`'compare' => 'LIKE', 'value' => 'john'` (查询名字包含 "john" 的人。注意， `'value'` 里面可以使用 `%` 作为通配符，比如 `'%john%'` 表示包含 "john" 的任何字符串)
`NOT LIKE`	模糊匹配 (不包含)	`'compare' => 'NOT LIKE', 'value' => 'john'` (查询名字不包含 "john" 的人)
`IN`	在某个数组里	`'compare' => 'IN', 'value' => array( 'red', 'blue', 'green' )` (查询喜欢的颜色是红色、蓝色或绿色的人)
`NOT IN`	不在某个数组里	`'compare' => 'NOT IN', 'value' => array( 'red', 'blue', 'green' )` (查询喜欢的颜色不是红色、蓝色或绿色的人)
`BETWEEN`	在两个值之间 (包含边界值)	`'compare' => 'BETWEEN', 'value' => array( 18, 30 ), 'type' => 'NUMERIC'` (查询年龄在18到30岁之间的人，注意 `type` 必须是 `'NUMERIC'`)
`NOT BETWEEN`	不在两个值之间 (不包含边界值)	`'compare' => 'NOT BETWEEN', 'value' => array( 18, 30 ), 'type' => 'NUMERIC'` (查询年龄不在18到30岁之间的人，注意 `type` 必须是 `'NUMERIC'`)
`EXISTS`	存在 (不管值是什么)	`'compare' => 'EXISTS'` (查询存在 "喜欢的颜色" 这个元数据的用户)
`NOT EXISTS`	不存在	`'compare' => 'NOT EXISTS'` (查询不存在 "喜欢的颜色" 这个元数据的用户)
`REGEXP`	正则表达式匹配	`'compare' => 'REGEXP', 'value' => '^[a-z]+$'` (查询名字只包含小写字母的用户，小心使用，性能可能会比较差)
`NOT REGEXP`	正则表达式不匹配	`'compare' => 'NOT REGEXP', 'value' => '^[a-z]+$'` (查询名字不只包含小写字母的用户)
`RLIKE`	`REGEXP` 的别名，作用相同，用哪个都行	`'compare' => 'RLIKE', 'value' => '^[a-z]+$'` (效果同上)

六、type 数据类型详解

type 参数告诉 WordPress 如何处理元数据的值。不同的类型会影响比较的结果。常见的类型有：

CHAR: 字符串类型 (默认值)。按照字符串进行比较。
NUMERIC: 数值类型。按照数值进行比较。适用于整数、浮点数等。当你使用 '>'、 '<' 等数值比较操作符时，必须设置 type 为 'NUMERIC'。
BINARY: 二进制类型。用于存储二进制数据。比较时会进行二进制比较。
DATE: 日期类型。自 WordPress 5.9 起可用。按照日期进行比较。
DATETIME: 日期时间类型。自 WordPress 5.9 起可用。按照日期时间进行比较。
DECIMAL: 十进制类型。自 WordPress 5.9 起可用。用于存储高精度数值。
SIGNED: 有符号整数类型。自 WordPress 5.9 起可用。
UNSIGNED: 无符号整数类型。自 WordPress 5.9 起可用。
TIME: 时间类型。自 WordPress 5.9 起可用。按照时间进行比较。

七、组合多个 meta_query 条件：relation 参数

有时候，我们需要组合多个 meta_query 条件，比如 "喜欢红色并且年龄大于18岁"。这时候，就要用到 relation 参数了。 relation 参数有两个值：

AND: 表示所有条件都必须满足 (逻辑与)。这是默认值。
OR: 表示只要满足其中一个条件即可 (逻辑或)。

$args = array(
    'meta_query' => array(
        'relation' => 'AND', // 或者 'OR'
        array(
            'key'     => 'favorite_color',
            'value'   => 'red',
            'compare' => '=',
        ),
        array(
            'key'     => 'age',
            'value'   => 18,
            'compare' => '>',
            'type'    => 'NUMERIC',
        ),
    )
);

$user_query = new WP_User_Query( $args );

上面的代码会查询既喜欢红色又年龄大于18岁的用户。如果把 'relation' => 'AND' 改成 'relation' => 'OR'，就会查询 喜欢红色 或者 年龄大于18岁 的用户。

八、嵌套的 meta_query：更复杂的查询

meta_query 还可以嵌套，也就是在一个 meta_query 里面再包含一个 meta_query。这可以实现更复杂的查询逻辑。

$args = array(
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key'     => 'city',
            'value'   => 'New York',
            'compare' => '=',
        ),
        array(
            'relation' => 'OR', // 嵌套的 meta_query
            array(
                'key'     => 'favorite_color',
                'value'   => 'red',
                'compare' => '=',
            ),
            array(
                'key'     => 'favorite_food',
                'value'   => 'pizza',
                'compare' => '=',
            ),
        ),
    )
);

$user_query = new WP_User_Query( $args );

上面的代码会查询 居住在纽约 并且 喜欢红色 或者 喜欢披萨 的用户。

九、实战演练：一些例子

光说不练假把式，让我们来看几个实际的例子：

查询所有设置了 "个人简介" 的用户:

$args = array(
    'meta_query' => array(
        array(
            'key'     => 'bio',
            'compare' => 'EXISTS',
        ),
    )
);

$user_query = new WP_User_Query( $args );

查询所有 "上次登录时间" 在过去7天内的用户 (假设 "last_login" 存储的是 Unix 时间戳):

$seven_days_ago = time() - (7 * 24 * 60 * 60);

$args = array(
    'meta_query' => array(
        array(
            'key'     => 'last_login',
            'value'   => $seven_days_ago,
            'compare' => '>=',
            'type'    => 'NUMERIC',
        ),
    )
);

$user_query = new WP_User_Query( $args );

查询 "技能" 包含 "PHP" 和 "WordPress" 的用户 (假设 "skills" 存储的是逗号分隔的字符串):

$args = array(
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key'     => 'skills',
            'value'   => 'PHP',
            'compare' => 'LIKE',
        ),
        array(
            'key'     => 'skills',
            'value'   => 'WordPress',
            'compare' => 'LIKE',
        ),
    )
);

$user_query = new WP_User_Query( $args );

十、性能优化小贴士

meta_query 非常强大，但使用不当可能会影响性能。这里有一些性能优化的小建议：

尽量使用索引: 如果你的 meta_key 经常被用于查询，考虑给 wp_usermeta 表的 meta_key 列添加索引。
避免复杂的 LIKE 查询: LIKE '%keyword%' 这种查询性能比较差，尽量避免。如果需要全文搜索，可以考虑使用专门的全文搜索引擎。
使用缓存: 对查询结果进行缓存，避免重复查询。可以使用 WordPress 的 Transients API 或者 Object Cache。
限制返回字段：如果只需要用户ID，可以使用’fields’ => ‘ID’参数，减少查询的数据量。

十一、注意事项

meta_query 参数区分大小写。
确保你的 meta_key 是正确的，否则查询会失败。
如果 value 是一个数组，compare 只能是 'IN' 或 'NOT IN' 或 'BETWEEN' 或 'NOT BETWEEN'。
如果 compare 是 'BETWEEN' 或 'NOT BETWEEN'，value 必须是一个包含两个元素的数组。

十二、结束语

好了，今天的 "WordPress Meta-query 大冒险" 就到此结束了。希望通过今天的讲解，大家对 WP_User_Query 的 meta_query 参数有了更深入的了解。记住，熟练掌握 meta_query，你就能像一位经验丰富的猎人一样，在 WordPress 的用户数据海洋里自由穿梭，精准定位到你想要的目标用户！

下次再见！祝大家编程愉快，Bug 远离！记得给我点赞哦！（虽然这里不能点赞，但请在心里默默为我点赞吧！）

发表回复 取消回复

发表回复取消回复