<?php endif;

        // 显示文章标题
        the_title( '<h2>', ';</h2>' ); 
        // 显示该文章作者存档的链接
        printf( __( '作者 %s', 'textdomain' ), get_the_author_posts_link() );
        // 显示文章内容
        ?>
        <div>
            <?php the_content() ?>
         </div>
        <?php
        // 显示逗号分隔的文章分类
        _e( '文章分类 ', 'textdomain' ); the_category( ', ' ); 
    // 关闭 div
   ?>
   </div>
<?php 
// 结束循环，下面是没有文章时显示的内容
endwhile; 

else : // 如果没有文章，显示提示消息 _e( ‘抱歉，未找到您需要的文章。’, ‘textdomain’ );

// 结束判断和循环 endif; ?>`

主循环

主循环是 WordPress 中的一个非常重要的概念，在开始学习多个循环之前，我们首先需要了解一下什么是主循环。

当我们访问 WordPress 站点的时候，WordPress 会根据我们访问的页面为我们新建一个文章查询和循环，设置一个 $wp_query 全局变量。这个变量就是主循环数据的变量，我们可以直接在页面模版中循环这个数据来输出文章。

看一下下面的代码：

复制if ( have_posts() ) : while ( have_posts() ) : the_post(); the_title(); endwhile; endif;

为了说明主循环，我们稍微改写一下代码。

复制if ( $wp_query->have_posts() ) : while ( $wp_query->have_posts() ) : $wp_query->the_post(); the_title(); endwhile; endif;

两段代码是等效的，为了保持代码的简洁性，WordPress 隐藏了全局的主循环变量$wp_query。

多个循环

在某些情况下，我们可能需要使用多个循环。例如，我们可能需要在页面顶部的内容列表中显示文章标题，然后在页面下方显示文章内容。因为我们使用的是同一个循环，我们只需要在开始第二次循环之前重置循环即可，使用函数rewind_posts() 即可实现这个功能。

使用rewind_posts() 函数重新开始循环

我们可以使用 rewind_post() 函数让循环从循环中的第一个元素重新开始，当我们需要在一个页面中循环同一个查询时，这个函数非常有用。

这下面是一个rewind_posts() 示例 ：

复制`<?php // 开始第一次循环 if ( have_posts() ) : while ( have_posts() ) : the_post(); the_title(); endwhile; endif;

// 使用 rewind_posts() 重置循环 rewind_posts();

// 开始第二次循环 while ( have_posts() ) : the_post(); the_content(); endwhile; ?>`

新建查询和文章循环

如上面的代码所示，我们可以非常容易的循环同一个查询结果两次或多次，但是很多时候，这不是我们所需要的。有时候我们需要在一个页面上显示不同的文章，例如，我们需要在页面的左侧显示所有文章，右侧显示分类「example-category」中的文章。这种情况下，我们需要新建一个文章查询，然后循环这个新的文章查询结果，示例代码如下：

复制`<?php // 显示所有文章 if ( have_posts() ) : while ( have_posts() ) : the_post(); the_title(); the_content(); endwhile; else : _e( ‘抱歉，未找到您需要的文章。’ ); endif; wp_reset_postdata();

// 创建一个新的文章查询，获取分类 「category_name」中的文章。 $secondary_query = new WP_Query( ‘category_name=example-category’ );

// 循环新的查询结果 if ( $secondary_query->have_posts() ) echo ‘

‘; while ( $secondary_query->have_posts() ) : $secondary_query->the_post(); the_title( ‘
• ‘, ‘
‘ ); endwhile; echo ‘

‘; endif; wp_reset_postdata(); ?>`

如上例所示，我们首先显示主循环中的结果。然后，使用WP_Query 类查询指定分类中的文章。

请注意，上面示例中的第二个循环和主循环还有一个区别：后者调用了 wp_reset_postdata() 函数来重置文章数据。

重置多个文章循环

在循环中，文章数据是存储在$post全局变量中的，在循环结束时，我们需要重置这个全局变量，否则会导致一些难以调试的 Bug 。根据循环调用的方式，有三个函数可以用来重置循环。

• [wp_reset_postdata()](https://developer.wordpress.org/reference/functions/wp_reset_postdata/)
• [wp_reset_query()](https://developer.wordpress.org/reference/functions/wp_reset_query/)
• [rewind_posts()](https://developer.wordpress.org/reference/functions/rewind_posts/)

使用wp_reset_postdata() 重置文章数据

使用 WP_Query 新建自定义循环或使用了多个循环时，请使用 wp_reset_postdata() 来重置文章数据，这个函数将全局变量 $post 变量还原到主查询中的当前帖子。如果我们在进行 WordPress开发时遵循了最佳实践，该函数是用来重置循环的最常见函数。

建议在使用了 WP_Query 类新建了查询和循环时，都要使用 wp_reset_postdata() 函数重置文章数据。

下面是使用 WP-Query 类新建了查询和循环后，使用 wp_reset_postdata() 还原文章数据的示例代码。

复制 `<?php // WP_Query 所使用的参数 $args = array( ‘posts_per_page’ => 3 );

// 调用 WP_Query 新建文章查询. $the_query = new WP_Query( $args );

if ( $the_query->have_posts() ) : // 开始循环 while ( $the_query->have_posts() ) : $the_query->the_post(); the_title(); the_excerpt(); // 结束循环 endwhile; else: _e( ‘抱歉，未找到您需要的文章。’, ‘textdomain’ ); endif;

wp_reset_postdata(); ?>`

使用wp_reset_query() 重置主循环和文章数据

因为query_posts() 函数新建的循环是一个主循环，在使用了这个函数新建查询后，我们必须使用wp_reset_query() 来还原查询和文章数据。如果使用了WP_Query 新建查询，我们可以使用 wp_reset_query() 函数来还原文章数据（因为该函数已经调用了 wp_reset_postdata() 函数），但是最好的做法是使用 wp_reset_postadata 函数来还原使用 WP_Query 新建的文章循环。

因为query_posts()会新建一个主循环来替代当前页面的主循环，使用这个函数会带来一些副作用，新建循环是，我们尽量使用 WP_Query 按不是 query_posts 函数。