wordpress-文章对象 – 行深膳食

使用wordpress遍历文章循环功能时，一直都是复制粘贴以下代码，在此基础上调整功能。由于不了解，每次使用时心里不踏实，徒增神秘感。因此，这次下决心了解此机制，非祛魅不可。

$args = array(
    'post_type' => 'fanhua_history',
    'posts_per_page' => 3
);
$query = new WP_Query($args);

if ($query->have_posts()) {
    echo '有文章需要处理：';
    while ($query->have_posts()) {
        $query->the_post();
        echo '<h2>'. get_the_title(). '</h2>';
    }
} else {
    echo '没有找到符合条件的文章。';
}
wp_reset_postdata();

◆ 查询文章返回结果

可见$query = new WP_Query($args);经过数据库执行后，其结果都缓存在$query对象里。后面均是围绕上面内容循环遍历文章。

◆ 遍历文章

public function have_posts() {
    if ( $this->current_post + 1 < $this->post_count ) {
        return true;
    } elseif ( $this->current_post + 1 == $this->post_count && $this->post_count > 0 ) {
        do_action_ref_array( 'loop_end', array( &$this ) );
        // Do some cleaning up after the loop.
        $this->rewind_posts();
    } elseif ( 0 === $this->post_count ) {
        $this->before_loop = false;

        do_action( 'loop_no_results', $this );
    }

    $this->in_the_loop = false;
    return false;
}

如上代码，have_posts() 方法通过$this->current_post + 1【这些current_post 、post_count 等变量均来自$query = new WP_Query($args)的查询结果】，比较当前处理的文章索引和文章总数，判断是否还有未处理的文章，并根据不同情况触发相应的动作钩子和进行状态重置。所以，通常会结合 while 循环来遍历查询结果集中的文章。

◆ 获取当前文章内容

public function the_post() {
    global $post;

    if ( ! $this->in_the_loop ) {
        // Only prime the post cache for queries limited to the ID field.
        $post_ids = array_filter( $this->posts, 'is_numeric' );
        // Exclude any falsey values, such as 0.
        $post_ids = array_filter( $post_ids );
        if ( $post_ids ) {
            _prime_post_caches( $post_ids, $this->query_vars['update_post_term_cache'], $this->query_vars['update_post_meta_cache'] );
        }
        $post_objects = array_map( 'get_post', $this->posts );
        update_post_author_caches( $post_objects );
    }
    $this->in_the_loop = true;
    $this->before_loop = false;
    if ( -1 == $this->current_post ) { // Loop has just started.
        do_action_ref_array( 'loop_start', array( &$this ) );
    }

    $post = $this->next_post();
    $this->setup_postdata( $post );
}

public function next_post() {
    ++$this->current_post;
    /** @var WP_Post */
    $this->post = $this->posts[ $this->current_post ];
    return $this->post;
}

如上代码，the_post() 方法作用是将查询结果集中的下一篇文章设置为当前文章，并为该文章设置好相关的数据和上下文，以便后续使用 WordPress 的模板标签（如 the_title()、the_content() 等）来显示文章的内容。

其中 next_post() 方法中++$this->current_post 会先将 $this->current_post 的值加 1，然后再使用这个新值。即调用该方法时，current_post 变量值加一，指向下一篇文章。

◆ 恢复主查询的当前文章对象

function wp_reset_postdata() {
    global $wp_query;

    if ( isset( $wp_query ) ) {
        $wp_query->reset_postdata();
    }
}

public function reset_postdata() {
    if ( ! empty( $this->post ) ) {
        $GLOBALS['post'] = $this->post;
        $this->setup_postdata( $this->post );
    }
}

由于new WP_Query()创建的自定义查询，遍历循环时，调用 the_post() 会修改全局 $post 对象。因此如果不重置，后续模板标签（如 the_title()）可能继续使用自定义查询的最后一篇文章数据，导致【主查询】或其它地方显示异常，这涉及到主循环等相关概念。

【主查询】：著查询是 WordPress 根据当前访问的 URL 自动生成的默认查询（如：访问首页时，主查询是按时间倒序显示文章列表），存在全局变量$wp_query 中（即WP_Query 对象实例），可通过 global $wp_query进行访问。

【自定义查询】：当创建自定义查询时，$query = new WP_Query($args)，即创建一个新的WP_Query实例时，务必使用自定义变量名$query保存数据结果，以避免覆盖保存原本著查询结果的全局变量名$wp_query。这样使用独立的变量名$query创建自定义查询，即$query 是一个独立的新的 WP_Query 对象，其操作不会影响主查询对象 $wp_query。

但是$post 是一个全局变量（WP_Post 对象），当在循环中调用 the_post()，会将 $post 设置为循环中的当前文章。所以遍历循环完后，一定要将全局 $post 重置为存储著查询结果的$wp_query->posts 数组中对应的文章对象。

【主循环重置流程】：如上代码，wp_reset_postdata() 的核心作用是将 $post 重新指向主查询当前循环的文章。具体过程为主查询（$wp_query）保存了循环的进度，其内部有一个变量current_post，记录当前循环到了第几篇文章（例如首页文章列表中的第3篇文章）。调用 wp_reset_postdata() 时，将全局 $post 设置为 $wp_query->posts 数组中对应的文章对象。

所以，了解以上机理。当你使用自定义查询时，其返回结果，如果你用原本保存著查询结果的全局变量$wp_query，即$wp_query = new WP_Query($args);这会造成严重后果，原始主查询（如页面内容、文章详情等）被彻底替换，就算用wp_reset_postdata() 只能恢复被覆盖后的 $wp_query 的状态。所以，再次强调：永远不要直接覆盖 $wp_query：它是 WordPress 的核心全局变量，存储主查询数据。正确做法应使用独立的变量名（如 $query）创建自定义查询。