WP_Query 类是 WordPress 文章查询的核心，它的文章查询部分提供了很多可用参数，经过好几个版本的升级完善，让它越来越强大，本文就可以让你详细的了解所有查询参数和技巧。
作者
分类
标签
自定义分类法
搜索
文章和页面
密码
类型
状态
分页
排序和排序类型
日期
自定义字段
用户权限
文章缓存
作者
查询和某些作者（用户）有关的文章，可以使用 4 个参数：
author（整数）：用户 ID
author_name（字符串）：用户的昵称（“user_nicename” 字段）
author__in（数组）：用户 ID
author__not_in（数组）：用户 ID
获取一个作者的文章 根据用户 ID 获取：
$query = new WP_Query( 'author=123' );
根据用户的昵称（“user_nicename” 字段）获取：
$query = new WP_Query( 'author_name=rami' );
获取多个作者的文章 根据用户 ID 获取多个作者的文章：
$query = new WP_Query( 'author=2,6,17,38' );
排除作者的文章 排除一个作者可以使用用户 ID 前边加上 “-” 的方式：
$query = new WP_Query( 'author=-12' );
多作者查询 获取多个作者的文章：
$query = new WP_Query([
'author__in' => [2, 6]
]);
排除多个作者的文章：
$query = new WP_Query([
'author__not_in' => [2, 6]
]);
分类
关于分类有 5 个可用的参数：
cat（整数）：分类 ID
category_name（字符串）：分类别名
category__and（数组）：分类 ID
category__in（数组）：分类 ID
category__not_in（数组）：分类 ID
获取一个分类的文章 根据分类的 ID 获取一个分类的文章（包含此分类的子分类）：
$query = new WP_Query( 'cat=4' );
根据分类的别名获取一个分类的文章（包含此分类的子分类）：
$query = new WP_Query( 'category_name=staff' );
根据分类的 ID 获取一个分类的文章（不包含此分类的子分类）：
$query = new WP_Query( 'category__in=4' );
获取多个分类的文章 根据分类的 ID 获取多个分类的文章：
$query = new WP_Query( 'cat=2,6,17,38' );
根据分类别名获取多个分类的文章：
$query = new WP_Query( 'category_name=staff,news' );
根据分类别名获取同时拥有几个分类的文章：
$query = new WP_Query( 'category_name=staff+news' );
排除分类 想要排除一些分类只需要在分类 ID 前加上 “-” 号：
$query = new WP_Query( 'cat=-12,-34,-56' );
多分类查询 获取同时有多个分类的文章，下边的代码会获取必须同时拥有 ID 为 2 和 6 的分类的文章：
$query = new WP_Query([
'category__and' => [2, 6]
]);
获取多个分类的文章，不包含其子分类，下边的代码获取了拥有 ID 为 2 或者 ID 为 6 的分类的文章：
$query = new WP_Query([
'category__in' => [2, 6]
]);
排除一些分类的文章：
$query = new WP_Query([
'category__not_in' => [2, 6]
]);
标签
获取关于标签的文章，可以使用 7 个参数：
tag（字符串）：标签别名
tag_id（整数）：标签 ID
tag__end（数组）：一些标签 ID
tag__in（数组）：一些标签 ID
tag_slug__and（数组）：一些标签别名
tag_slug__in（数组）：一些标签别名
获取一个标签的文章 根据标签别名获取有这个标签的文章：
$query = new WP_Query( 'tag=cooking' );
根据标签 ID 获取有这个标签的文章：
$query = new WP_Query( 'tag_id=13' );
获取多个标签的文章 根据标签的别名获取带有这几个标签其中一个的文章：
$query = new WP_Query( 'tag=bread,baking' );
根据标签别名获取同时拥有几个标签的文章：
$query = new WP_Query( 'tag=bread+baking+recipe' );
多标签查询 根据标签 ID 获取同时有几个标签的文章：
$query = new WP_Query([
'tag__and' => [37, 47]
]);
根据标签 ID 获取有这个标签的文章：
$query = new WP_Query([
'tag__in' => [37, 47]
]);
根据标签 ID 排除包含某些标签的文章：
$query = new WP_Query([
'tag__not_in' => [37, 47]
]);
tag_slug__in 和 tag_slug__and 的使用方法同上，只是把 ID 换成别名。
自定义分类法
有关自定义分类法（Taxonomy）的查询可以使用 1 个参数：
tax_query（数组）：分类法查询参数
relation（字符串）：条件的逻辑关系，OR（或者）或 AND（和）
taxonomy（字符串）：分类法名称
field（字符串）：根据分类法条款的什么字段查询，可选 term_id（分类条款 ID）、name（名称）和 slug（别名），默认是 term_id
terms（整数 | 字符串 | 分类）：分类法条款
include_children（布尔）：是否包含子分类法条款，默认是 True
operator（字符串）：匹配运算符（IN、IN NOT 和 AND），默认是 IN
简单的分类法查询 获取 people 分类法里别名为 bob 的条款下的文章：
$args = [
'post_type' => 'post',
'tax_query' => [
[
'taxonomy' => 'people',
'field' => 'slug',
'terms' => 'bob',
],
],
];
$query = new WP_Query( $args );
多分类法查询 获取同时是 movie_genre 分类法下别名为 action 或 comedy 的条款的文章和不是 actor 分类法下 ID 为 103 或 115 或 206 的条款的文章（略拗口）：
$args = [
'post_type' => 'post',
'tax_query' => [
'relation' => 'AND',
[
'taxonomy' => 'movie_genre',
'field' => 'slug',
'terms' => ['action', 'comedy'],
],
[
'taxonomy' => 'actor',
'field' => 'id',
'terms' => [103, 115, 206],
'operator' => 'NOT IN',
],
],
];
$query = new WP_Query( $args );
获取是分类法 category（也就是分类）下别名为 quotes 的条款或是分类法 post_format 下别名为 post-format-quote 的条款的文章：
$args = [
'post_type' => 'post',
'tax_query' => [
'relation' => 'OR',
[
'taxonomy' => 'category',
'field' => 'slug',
'terms' => ['quotes'],
],
[
'taxonomy' => 'post_format',
'field' => 'slug',
'terms' => ['post-format-quote'],
],
],
];
$query = new WP_Query( $args );
搜索
显示搜索关键词的结果，只有两个参数。
s（字符串）：搜索关键字
exact（布尔）：是否精确匹配
搜索关键词 搜索一个关键词：
$query = new WP_Query( 's=keyword' );
文章和页面
根据文章信息获取文章。请记住，默认情况下，post_type 一般都是 post（文章）。 有 9 个参数可以使用：
p（整数）：文章 ID
name（字符串）：文章别名
page_id（整数）：页面 ID
postname（字符串）：页面别名
post_parent（整数）：如果填写 ID 则只返回它的子项目，如果填 0 则只返回顶级项目
post_parent__in（数组）：一些父级项目的 ID，获取它们的子项目
post_parent__not_in（数组）：一些父级项目的 ID，排除它们的子项目
post__in（数组）：一些文章 ID
post__not_in（数组）：一些文章 ID
根据 ID 获取文章或页面 根据 ID 获取文章：
$query = new WP_Query( 'p=7' );
根据 ID 获取页面：
$query = new WP_Query( 'page_id=7' );
根据别名获取文章或页面 根据别名获取文章：
$query = new WP_Query( 'name=about-my-life' );
根据别名获取页面：
$query = new WP_Query( 'pagename=contact' );
获取文章或页面的子项目 根据别名获取一个页面的子页面，contact_us 是父页面别名，canada 是子页面别名：
$query = new WP_Query( 'pagename=contact_us/canada' );
获取一个文章的子项目：
$query = new WP_Query( 'post_parent=93' );
获取所有顶级项目：
$query = new WP_Query( 'post_parent=0' );
同时获取多个父级文章的子项目：
$query = new WP_Query([
'post_parent__in' => [2, 5, 12, 14, 20]
]);
多文章和页面查询 根据 ID 获取几个页面：
$query = new WP_Query([
'post_type' => 'page',
'post__in' => [2, 5, 12, 14, 20]
]);
排除几个 ID 的文章：
$query = new WP_Query([
'post_type' => 'post',
'post__not_in' => [2, 5, 12, 14, 20]
]);
PS：post__in 和 post__not_in 不能一起用。
PS2：post__not_in 不能使用以逗号分隔的字符串，只能是数组：
//这是错误的，不会工作
$query = new WP_Query( 'post__not_in=1,2,3' );
//这才是正确的
$query = new WP_Query([
'post__not_in' => [1, 2, 3]
]);
密码
有关文章密码的查询，可以使用 2 个参数：
has_password（布尔）：文章是否有密码
post_password（字符串）：指定的文章密码
有无密码 获取有密码的文章：
$query = new WP_Query([
'has_password' => true
]);
获取没有密码的文章：
$query = new WP_Query([
'has_password' => false
]);
指定密码 获取密码是指定内容的文章：
$query = new WP_Query( 'post_password=123' );
类型
有关文章类型的查询，只有一个参数可以使用：
post_type（字符串 | 数组）：文章的类型，一般默认都是 post（文章）
一个文章类型 获取页面：
$query = new WP_Query( 'post_type=page' );
获取自定义文章类型：
$query = new WP_Query( 'post_type=custom_post_type_name' );
多个文章类型 获取多个文章类型：
$query = new WP_Query([
'post_type' => ['post', 'page', 'movie', 'book']
]);
获取全部文章类型：
$query = new WP_Query( 'post_type=any' );
状态
有关文章状态的查询。文章状态指的是文章当前处于什么情况，比如 “已发布”、“草稿”、“待审核” 和 “定时发布” 等等，文章状态是可以由主题或者插件开发者扩展的。 关于文章状态可以使用一个参数：
post_status（字符串 | 数组）：文章的状态，一般默认都是 publish（已发布）
获取一个状态的文章 获取草稿文章：
$query = new WP_Query( 'post_status=draft' );
获取多个状态的文章 获取多个状态下的文章：
$query = new WP_Query([
'post_status' => ['pending', 'draft', 'future']
]);
获取全部状态的文章：
$query = new WP_Query( 'post_status=any' );
分页
有关分页的查询，有 7 个参数可以使用：
nopaging（布尔）：将文章分页还是全部获取。默认是 False：分页
posts_per_page（整数）：每页显示多少文章，如果设置成 –1 则不分页
posts_per_archive_page（整数）：和 posts_per_page 是一样的，不过这个只有在当前查询是根据存档或是搜索的情况下才生效
offset（整数）：偏移值，去掉前边几篇文章，再从后边找回来
paged（整数）：页码，指定文章分页的当前页
page（整数）：静态首页的页码
ignore_sticky_posts（布尔）：是否忽略指定文章，要忽略置顶文章可以设置成 True，默认是 False
设置每页文章数 设置每页的文章数量为 3 篇文章：
$query = new WP_Query( 'posts_per_page=3' );
显示全部文章 获取全部文章，不分页（方法一）：
$query = new WP_Query( 'nopaging=1' );
获取全部文章，不分页（方法二）：
$query = new WP_Query( 'posts_per_page=-1' );
偏移 从第 4 个文章开始获取：
$query = new WP_Query( 'offset=3' ) );
每页 5 篇文章，而但向前移位 3 篇：
$query = new WP_Query([
'posts_per_page' => 5,
'offset' => 3
]);
获取第 N 页文章 获取第 6 页的文章：
$query = new WP_Query( 'paged=6' );
获取当前页文章 获取当前页文章：
$query = new WP_Query([
'paged' => get_query_var( 'paged' )
]);
获取当前页文章，如果没有指定页码则默认第一页：
$paged = ( get_query_var('paged') ) ? get_query_var('paged') : 1;
$query = new WP_Query([
'paged' => $paged
]);
置顶文章 获取第一篇置顶文章：
$sticky = get_option( 'sticky_posts' );
$query = new WP_Query( 'p=' . $sticky[0] );
获取第一篇置顶文章，如果没有置顶文章则获取一篇最新的文章：
$args = [
'posts_per_page' => 1,
'post__in' => get_option( 'sticky_posts' ),
'ignore_sticky_posts' => 1,
];
$query = new WP_Query( $args );
排除置顶文章 排除全部置顶文章：
$query = new WP_Query([
'post__not_in' => get_option( 'sticky_posts' )
]);
忽略指定文章的置顶性，在循环里按正常排序出现：
$query = new WP_Query( 'ignore_sticky_posts=1' );
排序和排序类型
有关文章排序方法和类型的查询，有两个参数可以使用：
order（字符串 | 数组）：排序方法，ASC 为正序（从小到大）；DESC 为倒序（从大到小）
orderby（字符串 | 数组）：根据什么字段排序，默认是 post_date（文章日期）
按标题倒序 根据文章标题进行倒序排列：
$query = new WP_Query([
'orderby' => 'title',
'order' => 'DESC'
]);
先根据 menu_order 排序，如果出现无法排序的情况（比如相同或者为空）则再利用 title 排序。
$query = new WP_Query([
'orderby' => 'menu_order title',
'order' => 'DESC'
]);
随机排序 获取一篇随机文章：
$query = new WP_Query([
'orderby' => 'rand',
'posts_per_page' => '1'
]);
热门文章 获取根据评论数量排序的文章：
$query = new WP_Query([
'orderby' => 'comment_count'
]);
多条件不同排序 给多个排序条件，每个排序条件有不同的排序方法：
$query = new WP_Query([
'orderby' => [
'title' => 'DESC',
'menu_order' => 'ASC'
]
]);
自定义字段 获取文章自定义字段 age 是 3 或 4 的文章，并且按照 age 字段值的数字大小排序：
$args = [
'meta_key' => 'age',
'orderby' => 'meta_value_num',
'order' => 'ASC',
'meta_query' => [
[
'key' => 'age',
'value' => [3, 4],
'compare' => 'IN',
],
],
];
$query = new WP_Query( $args );
日期
和文章日期有关的查询，有 9 个参数：
year（整数）：4 位数的年份，比如 2014
monthnum（整数）：月份，从 1 到 12
w（整数）：周，从 0 到 53
day（整数）：日，从 1 到 31
hour（整数）：小时，从 0 到 23
minute（整数）：分钟，从 0 到 60
second（整数）：秒，从 0 到 60
m（整数）：年月，比如 201409
date_query（数组）：复杂的日期查询year（整数）：4 位数的年份，比如 2014
month（整数）：月份，从 1 到 12
week（整数）：周，从 0 到 53
day（整数）：日，从 1 到 31
hour（整数）：小时，从 0 到 23
minute（整数）：分钟，从 0 到 59
second（整数）：秒，从 0 到 59
before（字符串 | 数组）：开启查询日期，可以是能被 strtotime() 函数解析的日期字符串，还可以使用数组：
year（整数）：4 位数的年份，比如 2014，默认为空
month（整数）：月份，从 1 到 12，默认是 1
day（整数）：日，从 1 到 31，默认是 1
after（字符串 | 数组）：结束查询日期，可以是能被 strtotime() 函数解析的日期字符串，还可以使用数组：
year（整数）：4 位数的年份，比如 2014，默认为空
month（整数）：月份，从 1 到 12，默认是 12
day（整数）：日，从 1 到 31，默认是本月最后一天
inclusive（布尔）：before 和 after 是否包含所指定本日的文章
compare（字符串）：使用什么比较符号（=、!=、>、>=、<、<=、IN、NOT IN、BETWEEN、NOT、BETWEEN）
column（字符串）：匹配的日期字段，默认是 post_date
relation（字符串）：条件的逻辑关系，OR（或者）或 AND（和）
获取 2012 年 12 月 12 日的文章
$query = new WP_Query( 'year=2012&monthnum=12&day=12' );
或者：
$args = [
'date_query' => [
[
'year' => 2012,
'month' => 12,
'day' => 12,
),
),
);
$query = new WP_Query( $args );
获取今天发布的文章
$today = getdate();
$query = new WP_Query( 'year=' . $today['year'] . '&monthnum=' . $today['mon'] . '&day=' . $today['mday'] );
或者：
$today = getdate();
$args = [
'date_query' => [
[
'year' => $today['year'],
'month' => $today['mon'],
'day' => $today['mday'],
],
],
];
$query = new WP_Query( $args );
获取本周发布的文章
$week = date( 'W' );
$year = date( 'Y' );
$query = new WP_Query( 'year=' . $year . '&w=' . $week );
或者：
$args = [
'date_query' => [
[
'year' => date( 'Y' ),
'week' => date( 'W' ),
],
],
];
$query = new WP_Query( $args );
获取上午 9 点到下午 5 点的文章
$args = [
'date_query' => [
[
'hour' => 9,
'compare' => '>=',
],
[
'hour' => 17,
'compare' => '<=',
],
[
'dayofweek' => [ 2, 6 ],
'compare' => 'BETWEEN',
],
],
'posts_per_page' => -1,
];
$query = new WP_Query( $args );
获取 2013 年 1 月 1 日到 2013 年 2 月 18 日的文章 包含 2013 年 1 月 1 日和 2013 年 2 月 18 日的文章：
$args = [
'date_query' => [
[
'after' => 'January 1st, 2013',
'before' => [
'year' => 2013,
'month' => 2,
'day' => 28,
],
'inclusive' => true,
],
],
'posts_per_page' => -1,
];
$query = new WP_Query( $args );
不包含 2013 年 1 月 1 日和 2013 年 2 月 18 日的文章：
$args = [
'date_query' => [
[
'after' => 'January 1st, 2013',
'before' => [
'year' => 2013,
'month' => 2,
'day' => 28,
],
'inclusive' => false,
],
],
'posts_per_page' => -1,
];
$query = new WP_Query( $args );
获取在一年前发布却在一个月前修改过的文章
$args = [
'date_query' => [
[
'column' => 'post_date_gmt',
'before' => '1 year ago',
],
[
'column' => 'post_modified_gmt',
'after' => '1 month ago',
],
],
'posts_per_page' => -1,
];
$query = new WP_Query( $args );
自定义字段
有关自定义字段的查询，可用使用 9 个参数：
meta_key（字符串）：自定义字段的名（key）
meta_value（字符串）：自定义字段的值（value）
meta_value_num（数字）：自定义字段的值（value）
meta_compare（字符串）：匹配方法（=、!=、>、>=、<、<=），默认是 “=”
meta_query（数组）：处理复杂的查询relation（字符串）：条件的逻辑关系，OR（或者）或 AND（和）
key（字符串）：自定义字段的名（key）
value（字符串）：自定义字段的值（value）
compare（字符串）：匹配方法（=、!=、>、>=、<、<=、LIKE、NOT LIKE、IN、NOT IN、BETWEEN、NOT BETWEEN、EXISTS、NOT EXISTS），默认是 “=”
type（字符串）：自定义字段的类型（NUMERIC、BINARY、CHAR、DATE、DATETIME、DECIMAL、SIGNED、TIME、UNSIGNED），默认是 “CHAR”
简单的自定义字段查询 获取拥有自定义字段 color 的文章：
$query = new WP_Query( 'meta_key=color' );
获取自定义字段的值为 “blue” 的文章，不管字段的键值是什么：
$query = new WP_Query( 'meta_value=blue' );
获取自定义字段的值为 “blue” 的页面，不管字段的键值是什么：
$query = new WP_Query( 'meta_value=blue&post_type=page' );
获取自定义字段 color 是 “blue” 的文章：
$query = new WP_Query([
'meta_key' => 'color',
'meta_value' => 'blue'
]);
获取自定义字段 color 不是 “blue” 的文章：
$query = new WP_Query([
'meta_key' => 'color',
'meta_value' => 'blue',
'meta_compare' => '!='
]);
获取文章类型是 “product” 的文章，并且自定义字段 price 小于或者等于 22：
$query = new WP_Query([
'meta_key' => 'price',
'meta_value' => '22',
'meta_compare' => '<=',
'post_type' => 'product'
]);
简单的复杂查询 获取 product 自定义文章类型中 color 自定义字段不包含 “blue” 的文章：
$args = [
'post_type' => 'product',
'meta_query' => [
[
'key' => 'color',
'value' => 'blue',
'compare' => 'NOT LIKE',
],
],
];
$query = new WP_Query( $args );
复杂的查询 多自定义字段匹配：
$args = [
'post_type' => 'product',
'meta_query' => [
[
'key' => 'color',
'value' => 'blue',
'compare' => 'NOT LIKE',
],
[
'key' => 'price',
'value' => [20, 100],
'type' => 'numeric',
'compare' => 'BETWEEN',
],
],
];
$query = new WP_Query( $args );
在 product 自定义文章类型里获取 color 自定义字段不包含 “blue” 或者 price 字段是 20 到 100 之间的文章：
$args = [
'post_type' => 'product',
'meta_query' => [
'relation' => 'OR',
[
'key' => 'color',
'value' => 'blue',
'compare' => 'NOT LIKE',
],
[
'key' => 'price',
'value' => [20, 100],
'type' => 'numeric',
'compare' => 'BETWEEN',
],
],
];
$query = new WP_Query( $args );
用户权限
关于用户权限的文章查询有一个参数可以使用：
perm（字符串）：用户权限
只有用户有权限才显示文章 只有用户有权限才获取已发布和私密的文章：
$query = new WP_Query([
'post_status' => ['publish', 'private'],
'perm' => 'readable'
]);
文章缓存
有关文章数据的缓存，有 3 个参数：
cache_results（布尔）：文章信息缓存
update_post_meta_cache（布尔）：文章 meta 信息缓存
update_post_term_cache（布尔）：文章分类法信息缓存
获取文章但不更新文章缓存
$query = new WP_Query([
'posts_per_page' => 50,
'cache_results' => false
]);
获取文章但不更新 meta 信息的缓存
$query = new WP_Query([
'posts_per_page' => 50,
'update_post_meta_cache' => false
]);
获取文章但不更新文章分类法的缓存
$query = new WP_Query([
'posts_per_page' => 50,
'update_post_term_cache' => false
]);