WordPress 函数 query_posts 及查询文章方法总结

追格官方小助手/ 2023年01月03日/ WordPress/ 浏览 2192

关于如何在 WordPress 中查询文章,我们已学习了很多:《WordPress自定义查询WP_Query参数使用方法大全》《WordPress函数:get_posts 查询一组文章的好方法》《WordPress钩子 pre_get_posts 如何限制主循环查询的分类》等。


今天,要学习一个关于查询文章的新函数:query_posts 。这个函数的特别之处在于,这个函数会改变WordPress主循环。WordPress 文档介绍:

此函数将完全覆盖主查询,不用于插件或主题。它过于简单的修改主查询的方法可能会有问题,应尽可能避免。在大多数情况下,有更好、更高性能的选项来修改主查询,例如通过 WP_query 中的“pre_get_posts”操作。
这不能在 WordPress 循环中使用。


query_posts() 是一种更改 WordPress 用于显示帖子的主查询的方法。它通过将主查询放在一边,并用新查询替换它来实现这一点。要在调用 query_posts 后进行清理,请调用 wp_reset_query(),原始主查询将被恢复。
需要注意的是,使用它来替换页面上的主查询会增加页面加载时间,在最坏的情况下,这会使所需的工作量增加一倍或更多。虽然该功能易于使用,但在以后也容易出现混淆和问题。有关详细信息,请参阅下面的注意事项。
对于常规后期查询,请使用 WP_Query 或 get_posts() 。
强烈建议您改用“pre_get_posts”操作,并通过检查 is_main_query() 来更改主查询。

下面两段代码的效果是一样的,虽然,使用 query_posts 看上去比较简单,但是由于其副作用,可能会导致莫名其妙的bug。


query_posts( 'posts_per_page=5' );


function wpdocs_five_posts_on_homepage( $query ) {
    if ( $query->is_home() && $query->is_main_query() ) {
        $query->set( 'posts_per_page', 5 );
    }
}
add_action( 'pre_get_posts', 'wpdocs_five_posts_on_homepage' );


发表评论

暂无评论,抢个沙发...

客服 工单