解析 WordPress `get_children()` 函数的源码：它如何查询文章的子文章或附件。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位老铁，晚上好！我是你们的老朋友，今晚咱们一起扒一扒 WordPress 里面的 get_children() 函数，看看它到底是怎么把文章的“娃”们，或者附件“宝贝”们给揪出来的。准备好咖啡和小零食，咱们开讲啦！

一、热身运动：get_children() 是个啥？

首先，get_children() 是一个 WordPress 函数，用于检索指定文章的子文章或者附件。简单来说，就是找到某个文章下面挂着的小弟（子文章）或者它上传的图片、视频等等（附件）。这玩意儿在很多地方都用得到，比如：

文章目录： 你可以用它来自动生成文章的目录，把所有子文章都列出来。
图片画廊： 找到文章关联的所有附件，然后展示成一个酷炫的画廊。
产品展示： 如果你的产品有多个变体，可以用子文章来表示，然后用 get_children() 把它们都找出来。

二、解剖源码：一层一层扒开它的心

好了，废话不多说，直接上代码！我们从 WordPress 核心代码 wp-includes/post.php 里面找到 get_children() 函数的定义。为了便于理解，我会把源码简化一下，只保留核心逻辑：

function get_children( $args = '', $output = OBJECT ) {
    global $wpdb;

    $defaults = array(
        'numberposts'      => -1, // 获取所有子项
        'post_parent'      => 0,   // 父文章 ID，默认为 0
        'post_status'      => 'publish', // 文章状态
        'post_type'        => 'any',     // 文章类型，默认为 'any'，可以设置为 'attachment'
        'post_mime_type'   => '',      // MIME 类型，用于筛选附件
        'order'            => 'ASC',    // 排序方式
        'orderby'          => 'menu_order ID' // 排序字段
    );

    $r = wp_parse_args( $args, $defaults );
    extract( $r, EXTR_SKIP );

    // 构建 SQL 查询语句
    $query = "SELECT * FROM $wpdb->posts WHERE 1=1";

    // 父文章 ID
    if ( ! empty( $post_parent ) ) {
        $query .= " AND post_parent = '" . intval( $post_parent ) . "'";
    }

    // 文章状态
    if ( ! empty( $post_status ) ) {
        $query .= " AND post_status = '" . esc_sql( $post_status ) . "'";
    }

    // 文章类型
    if ( ! empty( $post_type ) ) {
        if ( is_array( $post_type ) ) {
            $post_type = implode( "', '", array_map( 'esc_sql', $post_type ) );
            $query .= " AND post_type IN ('" . $post_type . "')";
        } else {
            $query .= " AND post_type = '" . esc_sql( $post_type ) . "'";
        }
    }

    // MIME 类型 (只在 post_type 为 attachment 时有效)
    if ( ! empty( $post_mime_type ) ) {
        $query .= " AND post_mime_type = '" . esc_sql( $post_mime_type ) . "'";
    }

    // 排序
    $query .= " ORDER BY " . esc_sql( $orderby ) . ' ' . esc_sql( $order );

    // 限制数量
    if ( $numberposts > 0 ) {
        $query .= " LIMIT " . absint( $numberposts );
    }

    // 执行查询
    $results = $wpdb->get_results( $query, $output );

    return $results;
}

怎么样，是不是感觉有点复杂？别怕，咱们一步一步来：

参数处理：

$args：这是最重要的，它是一个数组，用来传递各种参数，告诉 get_children() 你想找什么样的“娃”。
$output：指定返回结果的格式，默认是 OBJECT，也就是对象。你也可以设置为 ARRAY_A（关联数组）或者 ARRAY_N（数字索引数组）。

wp_parse_args() 函数会将你传递的 $args 和默认参数 $defaults 合并起来。如果 $args 里面有设置的参数，就用 $args 的值，否则就用 $defaults 的值。
然后，extract() 函数会将数组 $r 里面的键值对提取成变量，方便后面使用。 EXTR_SKIP 的意思是，如果已经存在同名变量，就跳过。

参数名	默认值	说明
`numberposts`	`-1`	要获取的子项数量。`-1` 表示获取所有子项。
`post_parent`	`0`	父文章的 ID。如果要获取某个特定文章的子项，就需要设置这个参数。
`post_status`	`publish`	文章状态。例如，`publish`（已发布）、`draft`（草稿）、`pending`（待审核）等。
`post_type`	`any`	文章类型。`any` 表示所有文章类型，包括 `post`（文章）、`page`（页面）、`attachment`（附件）等。如果要只获取附件，就需要设置为 `attachment`。
`post_mime_type`	`''`	MIME 类型。只有在 `post_type` 为 `attachment` 时才有效。例如，`image/jpeg`、`video/mp4` 等。
`order`	`ASC`	排序方式。`ASC` 表示升序，`DESC` 表示降序。
`orderby`	`menu_order ID`	排序字段。`menu_order` 表示菜单排序（用于页面），`ID` 表示文章 ID，`title` 表示文章标题，`date` 表示发布日期等。

构建 SQL 查询语句：

这部分是核心！get_children() 函数会根据你传递的参数，构建一个 SQL 查询语句，然后交给 WordPress 数据库去执行。
- $query = "SELECT * FROM $wpdb->posts WHERE 1=1";：这是 SQL 语句的基础框架。$wpdb->posts 是 WordPress 数据库中存储文章的表名。WHERE 1=1 只是为了方便后面添加条件，没有实际意义。
- AND post_parent = ...：如果设置了 post_parent，就加上这个条件，筛选出指定父文章的子项。
- AND post_status = ...：如果设置了 post_status，就加上这个条件，筛选出指定状态的文章。
- AND post_type = ...：如果设置了 post_type，就加上这个条件，筛选出指定类型的文章。
- AND post_mime_type = ...：如果设置了 post_mime_type，就加上这个条件，筛选出指定 MIME 类型的附件。
- ORDER BY ...：根据 orderby 和 order 参数，对结果进行排序。
- LIMIT ...：根据 numberposts 参数，限制返回结果的数量。
执行查询：

$results = $wpdb->get_results( $query, $output );：这行代码会执行我们构建好的 SQL 查询语句，然后将结果返回。$wpdb->get_results() 是 WordPress 数据库类的一个方法，用于执行查询并返回结果。

$output 参数决定了返回结果的格式。默认是 OBJECT，也就是返回一个对象数组，每个对象代表一个文章或附件。

三、实战演练：秀一把操作

光说不练假把式，咱们来几个实际的例子，看看怎么用 get_children() 找到我们想要的“娃”。

获取指定文章的所有子文章：

$parent_id = 123; // 替换成你的父文章 ID
$children = get_children( array(
    'post_parent' => $parent_id,
    'post_type'   => 'post', // 只获取文章类型的子项
    'post_status' => 'publish' // 只获取已发布的子项
) );

if ( $children ) {
    echo '<ul>';
    foreach ( $children as $child ) {
        echo '<li><a href="' . get_permalink( $child->ID ) . '">' . esc_html( $child->post_title ) . '</a></li>';
    }
    echo '</ul>';
} else {
    echo '没有找到子文章。';
}

这段代码会找到 ID 为 123 的文章的所有已发布的文章类型的子文章，然后输出一个列表。

获取指定文章的所有附件：

$parent_id = 456; // 替换成你的父文章 ID
$attachments = get_children( array(
    'post_parent'    => $parent_id,
    'post_type'      => 'attachment', // 只获取附件
    'post_mime_type' => 'image', // 只获取图片类型的附件
    'numberposts'    => -1, // 获取所有附件
    'post_status'    => null, // 获取所有状态的附件
) );

if ( $attachments ) {
    echo '<div class="gallery">';
    foreach ( $attachments as $attachment ) {
        $image_src = wp_get_attachment_image_src( $attachment->ID, 'thumbnail' ); // 获取缩略图 URL
        echo '<a href="' . wp_get_attachment_url( $attachment->ID ) . '"><img src="' . esc_url( $image_src[0] ) . '" alt="' . esc_attr( $attachment->post_title ) . '"></a>';
    }
    echo '</div>';
} else {
    echo '没有找到附件。';
}

这段代码会找到 ID 为 456 的文章的所有图片类型的附件，然后输出一个图片画廊。注意 post_status 设置为 null 可以获取所有状态的附件。

获取指定文章的特定MIME类型的附件：

$parent_id = 789; // 替换成你的父文章 ID
$videos = get_children( array(
    'post_parent'    => $parent_id,
    'post_type'      => 'attachment', // 只获取附件
    'post_mime_type' => 'video/mp4', // 只获取MP4视频类型的附件
    'numberposts'    => -1, // 获取所有附件
    'post_status'    => 'inherit', // 必须设置状态为 inherit 才能获取附件
) );

if ( $videos ) {
    echo '<div class="video-list">';
    foreach ( $videos as $video ) {
        $video_url = wp_get_attachment_url( $video->ID );
        echo '<video width="320" height="240" controls>';
        echo '<source src="' . esc_url( $video_url ) . '" type="video/mp4">';
        echo 'Your browser does not support the video tag.';
        echo '</video>';
    }
    echo '</div>';
} else {
    echo '没有找到视频附件。';
}

这段代码会找到 ID 为 789 的文章的所有MP4视频类型的附件，并输出一个视频列表。注意 post_status 需要设置为 inherit 才能正确获取附件。

四、注意事项：踩坑指南

在使用 get_children() 的时候，有一些坑需要注意：

性能问题： 如果你的文章有很多子项，或者附件很多，get_children() 可能会导致性能问题。因为它会一次性把所有结果都查出来。如果只需要部分结果，可以考虑使用 WP_Query 类，它可以分页查询。
post_status 的重要性： 在获取附件时，post_status 参数通常需要设置为 inherit，这样才能正确获取到与文章关联的附件。
MIME 类型： 确保你设置的 post_mime_type 是正确的 MIME 类型。常见的 MIME 类型可以参考 https://developer.mozilla.org/zh-CN/docs/Web/HTTP/Basics_of_HTTP/MIME_types。

五、总结：掌握核心，灵活运用

get_children() 函数是 WordPress 中一个非常有用的工具，它可以帮助我们轻松地获取文章的子文章或者附件。通过理解它的源码，我们可以更好地掌握它的使用方法，并且可以根据实际需求，灵活地运用它。

记住，核心在于理解参数的含义，以及 SQL 查询语句的构建过程。只要掌握了这些，你就可以像一位经验丰富的猎人一样，轻松地找到你想要的“娃”或者“宝贝”！

好了，今天的分享就到这里。希望对大家有所帮助。咱们下次再见！如果各位老铁还有什么问题，欢迎在评论区留言，我会尽力解答。祝大家晚安！

发表回复 取消回复

发表回复取消回复