深入理解 WordPress `WP_Query` 类中的 `meta_query` 参数源码：如何构建复杂的元数据查询。

各位观众老爷，晚上好！我是你们的老朋友，今天咱们不聊八卦，专攻硬核技术——WordPress WP_Query 的 meta_query 参数，教你如何玩转复杂的元数据查询，让你的网站数据像孙悟空一样，72变！

一、 啥是 meta_query？为啥要用它？

想象一下，你的 WordPress 网站就像一个大仓库，每篇文章（Post）都是一个箱子。这些箱子里除了文章标题、内容这些显而易见的东西，还有一些隐藏的信息，比如作者心情、阅读难度、推荐指数等等。这些隐藏的信息，我们就叫做“元数据”（Meta Data），它们以键值对的形式存储在 wp_postmeta 数据表中。

meta_query，顾名思义，就是专门用来查询这些元数据的工具。有了它，你可以像侦探一样，根据各种线索（元数据），精准地找到你想要的箱子（文章）。

举个栗子：

• 你想要找出所有“心情：开心”的文章？ meta_query 能搞定！
• 你想要找出所有“阅读难度：困难”，并且“推荐指数：5星”的文章？ meta_query 也能搞定！
• 你想要找出所有“价格”在 100 到 200 之间的商品？ meta_query 还是能搞定！

总而言之， meta_query 就是你玩转 WordPress 元数据的秘密武器。

二、 meta_query 的基本结构：一个数组套娃游戏

meta_query 本身是一个数组，数组里的每个元素也是一个数组，可以理解成一个“条件组”。每个条件组里又包含若干个“条件”，用来筛选符合条件的文章。

基本结构如下：

$args = array(
    'post_type' => 'post', // 文章类型
    'meta_query' => array(
        array( // 第一个条件组
            'key' => 'meta_key_1', // 元数据键名
            'value' => 'meta_value_1', // 元数据键值
            'compare' => '=', // 比较操作符
            'type' => 'CHAR' // 数据类型
        ),
        array( // 第二个条件组
            'key' => 'meta_key_2',
            'value' => array(10, 20),
            'compare' => 'BETWEEN',
            'type' => 'NUMERIC'
        )
    )
);

$query = new WP_Query( $args );

• key: 指定你要查询的元数据的键名 (meta_key)。
• value: 指定你要匹配的元数据键值 (meta_value)。
• compare: 指定比较操作符，例如 = (等于), != (不等于), > (大于), < (小于), LIKE (模糊匹配) 等等。
• type: 指定元数据的数据类型，例如 CHAR (字符串), NUMERIC (数字), DATE (日期) 等等。

三、 compare 操作符：让你的查询更灵活

compare 操作符是 meta_query 的灵魂所在，它决定了你如何比较元数据键值。 WordPress 提供了丰富的 compare 操作符，足以满足你各种奇葩的需求。

操作符	说明	示例
=	等于	'compare' => '=' // meta_value 等于指定的值
!=	不等于	'compare' => '!=' // meta_value 不等于指定的值
>	大于	'compare' => '>' // meta_value 大于指定的值
>=	大于等于	'compare' => '>=' // meta_value 大于等于指定的值
<	小于	'compare' => '<' // meta_value 小于指定的值
<=	小于等于	'compare' => '<=' // meta_value 小于等于指定的值
LIKE	模糊匹配，类似于 SQL 的 LIKE 语句	'compare' => 'LIKE' // meta_value 包含指定的值
NOT LIKE	模糊不匹配，类似于 SQL 的 NOT LIKE 语句	'compare' => 'NOT LIKE' // meta_value 不包含指定的值
IN	值在指定数组中	'value' => array('A', 'B', 'C'), 'compare' => 'IN' // meta_value 为 A, B 或 C
NOT IN	值不在指定数组中	'value' => array('A', 'B', 'C'), 'compare' => 'NOT IN' // meta_value 不为 A, B 或 C
BETWEEN	值在指定范围内 (需要提供一个包含两个元素的数组作为 value)	'value' => array(10, 20), 'compare' => 'BETWEEN' // meta_value 在 10 到 20 之间
NOT BETWEEN	值不在指定范围内 (需要提供一个包含两个元素的数组作为 value)	'value' => array(10, 20), 'compare' => 'NOT BETWEEN' // meta_value 不在 10 到 20 之间
EXISTS	元数据键存在 (不需要 value 参数)	'compare' => 'EXISTS' // meta_key 存在
NOT EXISTS	元数据键不存在 (不需要 value 参数)	'compare' => 'NOT EXISTS' // meta_key 不存在
REGEXP	使用正则表达式匹配 (需要 MySQL 5.7.22 或更高版本)	'value' => '^A.*', 'compare' => 'REGEXP' // meta_value 以 A 开头
NOT REGEXP	使用正则表达式不匹配 (需要 MySQL 5.7.22 或更高版本)	'value' => '^A.*', 'compare' => 'NOT REGEXP' // meta_value 不以 A 开头
RLIKE	REGEXP 的别名 (需要 MySQL 5.7.22 或更高版本)	'value' => '^A.*', 'compare' => 'RLIKE' // meta_value 以 A 开头
NOT RLIKE	NOT REGEXP 的别名 (需要 MySQL 5.7.22 或更高版本)	'value' => '^A.*', 'compare' => 'NOT RLIKE' // meta_value 不以 A 开头

四、 type 数据类型：让 WordPress 明白你在查啥

type 参数告诉 WordPress 你要查询的元数据是什么类型，这样 WordPress 才能正确地进行比较。

数据类型	说明	示例
CHAR	字符串 (默认值)	'type' => 'CHAR'
NUMERIC	数字 (整数或浮点数)	'type' => 'NUMERIC'
BINARY	二进制数据	'type' => 'BINARY'
DATE	日期 (YYYY-MM-DD)	'type' => 'DATE'
DATETIME	日期和时间 (YYYY-MM-DD HH:MM:SS)	'type' => 'DATETIME'
TIME	时间 (HH:MM:SS)	'type' => 'TIME'
SIGNED	有符号整数	'type' => 'SIGNED'
UNSIGNED	无符号整数	'type' => 'UNSIGNED'
DECIMAL	十进制数	'type' => 'DECIMAL'

重要提示： 一定要根据你的元数据的实际类型设置 type 参数，否则可能会导致查询结果不准确。 比如，如果你的元数据存储的是数字，但是你把 type 设置成了 CHAR，那么 WordPress 会把数字当成字符串来比较，结果就可能出错了。

五、 多条件查询：relation 参数来救场

有时候，你需要同时满足多个条件才能找到目标文章。 这时候， relation 参数就派上用场了。 relation 参数用来指定多个条件组之间的关系，可以是 AND (且) 或 OR (或)。

• AND: 只有同时满足所有条件组的文章才会被选中。
• OR: 只要满足任意一个条件组的文章就会被选中。

$args = array(
    'post_type' => 'post',
    'meta_query' => array(
        'relation' => 'AND', //  所有条件必须满足
        array(
            'key' => 'color',
            'value' => 'red',
            'compare' => '='
        ),
        array(
            'key' => 'size',
            'value' => 'large',
            'compare' => '='
        )
    )
);

$query = new WP_Query( $args );

上面的代码会找出所有颜色为红色 且 尺寸为大的文章。

$args = array(
    'post_type' => 'post',
    'meta_query' => array(
        'relation' => 'OR', //  满足任意一个条件即可
        array(
            'key' => 'price',
            'value' => 100,
            'compare' => '<'
        ),
        array(
            'key' => 'discount',
            'value' => 0.2,
            'compare' => '>'
        )
    )
);

$query = new WP_Query( $args );

上面的代码会找出所有价格小于 100 或 折扣大于 0.2 的文章。

六、 嵌套查询：更复杂的条件筛选

meta_query 支持嵌套，也就是说，你可以在一个条件组里再嵌套一个 meta_query。 这样可以实现更复杂的条件筛选。

$args = array(
    'post_type' => 'product',
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key' => 'category',
            'value' => 'electronics',
            'compare' => '='
        ),
        array(
            'relation' => 'OR', // 嵌套的 meta_query
            array(
                'key' => 'brand',
                'value' => 'apple',
                'compare' => '='
            ),
            array(
                'key' => 'brand',
                'value' => 'samsung',
                'compare' => '='
            )
        )
    )
);

$query = new WP_Query( $args );

上面的代码会找出所有分类为 electronics 且 品牌为 apple 或 samsung 的商品。

七、 实际应用案例：手把手教你写代码

光说不练假把式，下面我们来几个实际应用案例，让你彻底掌握 meta_query 的用法。

案例 1：查找所有阅读时长大于 30 分钟的文章

假设你的文章有一个名为 reading_time 的元数据，存储的是阅读时长，单位是分钟。

$args = array(
    'post_type' => 'post',
    'meta_query' => array(
        array(
            'key' => 'reading_time',
            'value' => 30,
            'compare' => '>',
            'type' => 'NUMERIC'
        )
    )
);

$query = new WP_Query( $args );

if ( $query->have_posts() ) {
    echo '<ul>';
    while ( $query->have_posts() ) {
        $query->the_post();
        echo '<li><a href="' . get_permalink() . '">' . get_the_title() . '</a></li>';
    }
    echo '</ul>';
    wp_reset_postdata();
} else {
    echo '没有找到符合条件的文章。';
}

案例 2：查找所有作者心情为“开心”或“兴奋”的文章

假设你的文章有一个名为 mood 的元数据，存储的是作者心情。

$args = array(
    'post_type' => 'post',
    'meta_query' => array(
        array(
            'key' => 'mood',
            'value' => array('开心', '兴奋'),
            'compare' => 'IN'
        )
    )
);

$query = new WP_Query( $args );

//  显示结果 (代码省略，同案例 1)

案例 3：查找所有价格在 100 到 200 之间，并且库存大于 0 的商品

假设你的商品有一个名为 price 的元数据，存储的是价格，还有一个名为 stock 的元数据，存储的是库存。

$args = array(
    'post_type' => 'product',
    'meta_query' => array(
        'relation' => 'AND',
        array(
            'key' => 'price',
            'value' => array(100, 200),
            'compare' => 'BETWEEN',
            'type' => 'NUMERIC'
        ),
        array(
            'key' => 'stock',
            'value' => 0,
            'compare' => '>',
            'type' => 'NUMERIC'
        )
    )
);

$query = new WP_Query( $args );

//  显示结果 (代码省略，同案例 1)

八、 性能优化：不要滥用 meta_query

meta_query 虽然强大，但也会带来性能问题。 如果你的网站数据量很大，或者 meta_query 的条件非常复杂，那么查询速度可能会变慢。

以下是一些性能优化建议：

1. 尽量使用索引： 确保你的元数据键 (meta_key) 上有索引。 索引可以大大加快查询速度。
2. 避免复杂的 LIKE 查询： LIKE 查询会进行全表扫描，速度很慢。 尽量使用精确匹配。
3. 限制查询范围： 尽量缩小查询范围，例如指定文章类型、分类等等。
4. 使用缓存： 使用缓存可以避免重复查询，提高网站性能。

九、 源码分析：WP_Query 如何处理 meta_query

虽然我们主要讲的是使用，但简单了解一下 WP_Query 内部如何处理 meta_query 也是有好处的。 WP_Query 会将 meta_query 转换成 SQL 查询语句，然后从数据库中查询符合条件的文章。

简单来说，过程如下：

1. WP_Query 解析 meta_query 数组，提取 key、value、compare、type 等参数。
2. 根据这些参数，生成 SQL 的 WHERE 子句。 例如，如果 compare 是 =，那么就会生成 meta_key = 'xxx' AND meta_value = 'yyy' 这样的语句。
3. 如果 relation 是 AND，那么所有条件组的 WHERE 子句会用 AND 连接起来。 如果 relation 是 OR，那么会用 OR 连接起来。
4. 最终， WP_Query 执行生成的 SQL 查询语句，获取符合条件的文章 ID。

具体的源码分析比较复杂，涉及到 WP_Query 类的 get_posts() 方法、get_meta_sql() 方法等等。 有兴趣的同学可以自行研究。

十、 总结：meta_query 在手，天下我有

meta_query 是 WordPress WP_Query 类中一个非常强大的参数，可以让你根据各种元数据条件，精准地查询文章。 掌握了 meta_query 的用法，你就可以像孙悟空一样，在 WordPress 数据中自由穿梭，找到你想要的任何东西。

记住，key、value、compare、type 四个要素要配合好，relation 参数要用对，嵌套查询要灵活，性能优化要重视。 这样，你就可以成为 meta_query 的高手，让你的 WordPress 网站数据更加智能化、个性化。

好了，今天的讲座就到这里。 各位观众老爷，咱们下期再见！