探究 WordPress `get_posts()` 函数源码：与 `WP_Query` 相比，它在何种情况下更适合使用。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众老爷，大家好！我是你们的老朋友，今天咱们来聊聊 WordPress 里两个非常相似，但又各有千秋的函数：get_posts() 和 WP_Query。它们都能用来获取文章，但什么时候用哪个，可大有讲究。今天咱们就深入源码，把它们扒个精光，看看它们到底有啥区别，以及在什么情况下，get_posts() 才是你的真爱。

先来热个身：get_posts() 和 WP_Query 的基本用法

在深入源码之前，咱们先来回顾一下这两个函数的基本用法，确保大家都在同一条船上。

get_posts()

get_posts() 函数是一个简单易用的函数，它接受一个数组作为参数，这个数组包含各种查询参数。它会直接返回一个包含 WP_Post 对象的数组。

$args = array(
    'numberposts' => 5, // 获取最近的5篇文章
    'category'    => 1,   // 获取分类ID为1的文章
    'orderby'     => 'date', // 按照日期排序
    'order'       => 'DESC', // 降序排列
);

$recent_posts = get_posts($args);

foreach ($recent_posts as $post) {
    echo '<h2><a href="' . get_permalink($post->ID) . '">' . $post->post_title . '</a></h2>';
    echo '<p>' . get_the_excerpt($post->ID) . '</p>';
}

WP_Query

WP_Query 是一个类，你需要实例化它才能使用。它也接受一个包含查询参数的数组，但它返回的是一个 WP_Query 对象。你需要使用该对象的方法来遍历结果。

$args = array(
    'posts_per_page' => 5, // 获取最近的5篇文章
    'category_name'   => 'news', // 获取分类别名为news的文章
    'orderby'        => 'date', // 按照日期排序
    'order'          => 'DESC', // 降序排列
);

$the_query = new WP_Query($args);

if ($the_query->have_posts()) {
    while ($the_query->have_posts()) {
        $the_query->the_post();
        echo '<h2><a href="' . get_permalink() . '">' . get_the_title() . '</a></h2>';
        echo '<p>' . get_the_excerpt() . '</p>';
    }
    wp_reset_postdata(); // 别忘了重置查询！
} else {
    echo '<p>没有找到文章</p>';
}

源码大揭秘：get_posts() 到底做了什么？

现在，咱们来深入 get_posts() 的源码，看看它到底是怎么工作的。

打开 wp-includes/post.php 文件，找到 get_posts() 函数的定义。你会发现，它其实是一个非常简洁的函数，核心代码只有几行：

function get_posts( $args = null ) {
    $defaults = array(
        'numberposts' => 5,
        'category' => 0,
        'orderby' => 'post_date',
        'order' => 'DESC',
        'include' => array(),
        'exclude' => array(),
        'meta_key' => '',
        'meta_value' =>'',
        'post_type' => 'post',
        'suppress_filters' => true,
    );

    $r = wp_parse_args( $args, $defaults );
    if ( empty( $r['numberposts'] ) )
        $r['numberposts'] = 5;

    if ( isset( $r['post_status'] ) && 'any' == $r['post_status'] ) {
        $r['post_status'] = null;
    }

    $r = new WP_Query( $r );

    return $r->posts;
}

看到没？ get_posts() 函数其实是一个“包装器”，它做了以下几件事：

设置默认参数： 定义了一些默认的查询参数，比如默认获取 5 篇文章，按照日期降序排列等等。
合并参数： 使用 wp_parse_args() 函数将传入的参数和默认参数合并。
实例化 WP_Query： 最关键的一步！ get_posts() 函数直接实例化了一个 WP_Query 对象，并将合并后的参数传递给它。
返回结果： get_posts() 函数并不返回 WP_Query 对象本身，而是返回 WP_Query 对象的 $posts 属性，这个属性是一个包含 WP_Post 对象的数组。

get_posts() 的优势：简单粗暴，快速获取结果

从源码中可以看出，get_posts() 的最大优势就是简单。它把复杂的 WP_Query 封装起来，你只需要传入一个参数数组，就能直接拿到文章列表。

代码更简洁： 相比于 WP_Query，使用 get_posts() 获取文章的代码更短，更容易阅读。
上手更快： 对于新手来说，get_posts() 更容易上手，因为它不需要实例化对象，也不需要调用额外的方法。

WP_Query 的优势：灵活强大，控制一切

虽然 get_posts() 很方便，但 WP_Query 才是真正的王者。它提供了更多的选项和更强大的功能，让你能够完全掌控文章查询的过程。

更多查询参数： WP_Query 支持更多的查询参数，可以进行更复杂的查询，比如按照自定义字段排序，查询特定状态的文章等等。
分页功能： WP_Query 内置了分页功能，可以轻松实现分页显示文章列表。
模板标签： WP_Query 可以配合 WordPress 的模板标签使用，比如 the_post()，get_permalink()，the_title() 等等，可以更方便地在模板中显示文章信息。
更精细的控制： WP_Query 允许你访问 WP_Query 对象的各种属性和方法，可以更精细地控制查询过程，比如获取查询到的文章总数，判断是否有下一页等等。
自定义 SQL 查询： 通过 posts_where，posts_join，posts_orderby 等过滤器，你可以自定义 SQL 查询语句，实现更高级的查询需求。

get_posts() vs WP_Query：适用场景分析

了解了 get_posts() 和 WP_Query 的优缺点，接下来咱们就来分析一下，在什么情况下应该使用哪个函数。

特性	`get_posts()`	`WP_Query`
简洁性	非常简洁，代码量少	相对复杂，需要实例化对象和调用方法
易用性	容易上手，适合新手	相对难上手，需要理解对象和方法
灵活性	相对有限，只支持常用的查询参数	非常灵活，支持各种查询参数和自定义 SQL 查询
功能	简单获取文章列表	获取文章列表、分页、模板标签、精细控制等
适用场景	简单的文章列表展示，比如侧边栏展示最新文章等	复杂的文章列表展示，比如文章归档页面等
性能	理论上性能略好，因为少了一些对象操作	性能略差，但差距不大，可忽略不计

总结：

当你需要简单地获取文章列表，并且不需要太多的自定义选项时，get_posts() 是一个不错的选择。 比如，在侧边栏展示最近的几篇文章，或者在首页展示特定分类的文章。
当你需要进行复杂的文章查询，并且需要更多的控制权时，WP_Query 才是你的最佳选择。 比如，创建文章归档页面，实现分页功能，或者按照自定义字段排序文章。
如果你不确定使用哪个函数，那么 WP_Query 通常是一个更安全的选择，因为它提供了更多的灵活性和功能。

真实案例：get_posts() 的妙用

说了这么多理论，咱们来看一个真实的案例，看看 get_posts() 在实际项目中是怎么应用的。

假设你的 WordPress 网站有一个“推荐阅读”的侧边栏，你想在这个侧边栏里展示 3 篇与当前文章相关的文章。

<?php
// 获取当前文章的分类 ID
$categories = get_the_category();
if ($categories) {
    $category_ids = array();
    foreach ($categories as $category) {
        $category_ids[] = $category->term_id;
    }

    // 构建查询参数
    $args = array(
        'numberposts' => 3, // 获取 3 篇文章
        'category' => implode(',', $category_ids), // 获取相同分类的文章
        'post__not_in' => array(get_the_ID()), // 排除当前文章
        'orderby' => 'rand', // 随机排序
    );

    // 获取推荐文章
    $related_posts = get_posts($args);

    // 显示推荐文章
    if ($related_posts) {
        echo '<h3>推荐阅读</h3>';
        echo '<ul>';
        foreach ($related_posts as $post) {
            echo '<li><a href="' . get_permalink($post->ID) . '">' . $post->post_title . '</a></li>';
        }
        echo '</ul>';
    }
}
?>

在这个例子中，我们使用了 get_posts() 函数来获取与当前文章相同分类的 3 篇文章，并且排除了当前文章本身。由于我们只需要简单地获取文章列表，并且不需要分页等复杂功能，所以 get_posts() 是一个非常合适的选择。

高级技巧：使用 pre_get_posts 过滤器修改默认查询

除了直接使用 get_posts() 和 WP_Query 函数，WordPress 还提供了一个 pre_get_posts 过滤器，可以让你在查询执行之前修改查询参数。这个过滤器非常强大，可以让你在不修改主题文件的情况下，实现各种自定义的查询需求。

例如，你可以使用 pre_get_posts 过滤器来修改默认的文章排序方式，或者限制某个分类的文章只能显示 5 篇。

add_action('pre_get_posts', 'my_custom_query');

function my_custom_query($query) {
    // 只在主循环中修改查询
    if ($query->is_main_query() && !is_admin()) {
        // 修改文章排序方式为按照标题排序
        $query->set('orderby', 'title');
        $query->set('order', 'ASC');

        // 限制分类ID为1的文章只能显示5篇
        if (is_category(1)) {
            $query->set('posts_per_page', 5);
        }
    }
}

在这个例子中，我们使用 pre_get_posts 过滤器来修改主循环的查询参数，将文章排序方式修改为按照标题排序，并且限制分类 ID 为 1 的文章只能显示 5 篇。

最后的话：选择合适的工具，事半功倍

get_posts() 和 WP_Query 都是 WordPress 中非常重要的函数，它们可以帮助你轻松地获取文章列表，实现各种自定义的查询需求。理解它们的区别和适用场景，可以让你在开发 WordPress 主题和插件时，选择合适的工具，事半功倍。

希望今天的讲座对你有所帮助！下次再见！

发表回复 取消回复

发表回复取消回复