我读了@nacin的《 你昨天不知道查询》，并被发送了一个查询兔子洞。昨天之前，我（错误地）使用query_posts()了所有查询需求。现在，我对使用会更明智WP_Query()，但是仍然有一些灰色区域。

我想我肯定知道的是：

如果我要在页面上的任何地方（在侧边栏中，在页脚中，任何类型的“相关文章”等）进行附加循环，我想使用WP_Query()。我可以在单个页面上重复使用它而不会造成任何伤害。（对？）。

我不确定的是

1. 什么时候使用@ nacin的 pre_get_posts对比WP_Query()？我pre_get_posts现在应该用所有东西吗？
2. 当我想修改模板页面中的循环时（假设我要修改分类档案页面），是否要删除if have_posts : while have_posts : the_post零件并编写自己的零件WP_Query()？还是pre_get_posts在我的functions.php文件中使用修改输出？

tl; dr

我想从中得出的tl; dr规则是：

1. 切勿使用query_posts了
2. 在单个页面上运行多个查询时，请使用 WP_Query()
3. 修改循环时，请执行____。

谢谢你的智慧

特里

ps：我已经看过并读过：什么时候应该使用WP_Query vs query_posts（）vs get_posts（）？这增加了另一个维度- get_posts。但根本不处理pre_get_posts。

您说对了：

切勿使用query_posts了

pre_get_posts

pre_get_posts是一个过滤器，用于更改任何查询。它最常用于仅更改“主查询”：

add_action('pre_get_posts','wpse50761_alter_query');
function wpse50761_alter_query($query){

      if( $query->is_main_query() ){
        //Do something to main query
      }
}

（尽管这可能是多余的，但我还将检查is_admin()返回的false）。主要查询在您的模板中显示为：

if( have_posts() ):
    while( have_posts() ): the_post();
       //The loop
    endwhile;
endif;

如果您需要编辑此循环，请使用pre_get_posts。即，如果您想使用query_posts()-请pre_get_posts改为使用。

WP_Query

主要查询是的重要实例WP_Query object。WordPress使用它来决定使用哪个模板，例如，传递到url中的任何参数（例如，分页）都将被引导到该WP_Query对象的实例中。

对于辅助循环（例如，在侧栏或“相关文章”列表中），您需要创建自己的WP_Query对象单独实例。例如

$my_secondary_loop = new WP_Query(...);
if( $my_secondary_loop->have_posts() ):
    while( $my_secondary_loop->have_posts() ): $my_secondary_loop->the_post();
       //The secondary loop
    endwhile;
endif;
wp_reset_postdata();

注意wp_reset_postdata();-这是因为辅助循环将覆盖$post标识“当前帖子” 的全局变量。这实质上将其重置为“ $poston on”。

get_posts（）

实际上，这是WP_Query对象的单独实例的包装。这将返回一个post对象数组。上面循环中使用的方法不再对您可用。这不是一个“循环”，仅仅是一个post对象数组。

<ul>
<?php
global $post;
$args = array( 'numberposts' => 5, 'offset'=> 1, 'category' => 1 );
$myposts = get_posts( $args );
foreach( $myposts as $post ) :  setup_postdata($post); ?>
    <li><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></li>
<?php endforeach; wp_reset_postdata(); ?>
</ul>

回答您的问题

1. 使用pre_get_posts改变你的主查询。WP_Query模板页面中的辅助循环使用单独的对象（方法2）。
2. 如果要更改主循环的查询，请使用pre_get_posts。

循环有两种不同的上下文：

• 基于URL请求发生的主循环，在加载模板之前已进行处理
• 以任何其他方式发生的次级循环，从模板文件或其他方式调用

问题query_posts()在于它是试图成为主要循环而不幸失败的次级循环。因此忘记它的存在。

修改主循环

• 不要使用 query_posts()
• pre_get_posts与$query->is_main_query()检查一起使用过滤器
• 交替使用request滤镜（太粗略，所以上面的效果更好）

运行辅助循环

使用new WP_Query或get_posts()可以互换使用（后者是前者的薄包装）。

清理

使用wp_reset_query()如果使用query_posts()或与全球混乱$wp_query直接-所以你几乎从来没有需要。

使用wp_reset_postdata()如果使用the_post()或setup_postdata()或全球性混乱$post和需要恢复的职位相关的事情初始状态。

有使用的合法方案query_posts($query)，例如：

1. 您要在页面上显示帖子列表或自定义帖子类型的帖子（使用页面模板）

2. 您想对这些帖子进行分页

现在，为什么要在页面上显示它而不使用存档模板？

1. 对于管理员（您的客户？）来说更直观-他们可以在“页面”中查看页面

2. 最好将其添加到菜单中（没有页面，他们必须直接添加url）

3. 如果您想在模板上显示其他内容（文本，缩略图或任何自定义元内容），则可以轻松地从页面上获取它（这对客户来说也更有意义）。查看是否使用了存档模板，您是否需要对其他内容进行硬编码或使用例如主题/插件选项（这会使客户不太直观）

这是一个简化的示例代码（将在您的页面模板上-例如page-page-of-posts.php）：

/**
 * Template Name: Page of Posts
 */

while(have_posts()) { // original main loop - page content
  the_post();
  the_title(); // title of the page
  the_content(); // content of the page
  // etc...
}

// now we display list of our custom-post-type posts

// first obtain pagination parametres
$paged = 1;
if(get_query_var('paged')) {
  $paged = get_query_var('paged');
} elseif(get_query_var('page')) {
  $paged = get_query_var('page');
}

// query posts and replace the main query (page) with this one (so the pagination works)
query_posts(array('post_type' => 'my_post_type', 'post_status' => 'publish', 'paged' => $paged));

// pagination
next_posts_link();
previous_posts_link();

// loop
while(have_posts()) {
  the_post();
  the_title(); // your custom-post-type post's title
  the_content(); // // your custom-post-type post's content
}

wp_reset_query(); // sets the main query (global $wp_query) to the original page query (it obtains it from global $wp_the_query variable) and resets the post data

// So, now we can display the page-related content again (if we wish so)
while(have_posts()) { // original main loop - page content
  the_post();
  the_title(); // title of the page
  the_content(); // content of the page
  // etc...
}

现在，非常清楚地说，我们可以避免query_posts()在这里使用，WP_Query而是改为使用-像这样：

// ...

global $wp_query;
$wp_query = new WP_Query(array('your query vars here')); // sets the new custom query as a main query

// your custom-post-type loop here

wp_reset_query();

// ...

但是，当我们有这么好的小功能可用时，为什么要这样做呢？

我从functions.php修改WordPress查询：

//unfortunately, "IS_PAGE" condition doesn't work in pre_get_posts (it's WORDPRESS behaviour)
//so you can use `add_filter('posts_where', ....);`    OR   modify  "PAGE" query directly into template file

add_action( 'pre_get_posts', 'myFunction' );
function myFunction($query) {
    if ( ! is_admin() && $query->is_main_query() )  {
        if (  $query->is_category ) {
            $query->set( 'post_type', array( 'post', 'page', 'my_postType' ) );
            add_filter( 'posts_where' , 'MyFilterFunction_1' ) && $GLOBALS['call_ok']=1; 
        }
    }
}
function MyFilterFunction_1($where) {
   return (empty($GLOBALS['call_ok']) || !($GLOBALS['call_ok']=false)  ? $where :  $where . " AND ({$GLOBALS['wpdb']->posts}.post_name NOT LIKE 'Journal%')"; 
}

只是概述自WordPress随时间演变以来所接受答案的一些改进，并且现在（五年后）有所不同：

pre_get_posts是一个过滤器，用于更改任何查询。它最常用于仅更改“主查询”：

实际上是一个动作挂钩。不是过滤器，它将影响任何查询。

主要查询在您的模板中显示为：

if( have_posts() ):
    while( have_posts() ): the_post();
       //The loop
    endwhile;
endif;

实际上，这也不是事实。该函数have_posts迭代仅与主查询global $wp_query不相关的对象。 可能还会被辅助查询更改。global $wp_query;

function have_posts() {
    global $wp_query;
    return $wp_query->have_posts();
}

get_posts（）

本质上，这是WP_Query对象的单独实例的包装。

实际上，今天WP_Query是一个类，因此我们有一个类的实例。

总结一下：当时@StephenHarris编写的所有内容很可能都是真的，但是随着时间的流逝，WordPress中的情况已经发生了变化。