剖析 WordPress `wp_delete_post()` 函数的源码：如何删除文章，并同时删除相关的元数据、评论和附件。

各位观众老爷，晚上好！我是今晚的主讲人，咱们今天就来扒一扒 WordPress 里面那个狠角色——wp_delete_post() 函数，看看它到底是怎么把一篇文章以及它的七大姑八大姨（元数据、评论、附件等等）给一锅端了的。准备好了吗？咱们开车了！

开场白：wp_delete_post() 是个啥？

简单来说，wp_delete_post() 就是 WordPress 用来删除文章（包括文章、页面、自定义文章类型）的终极武器。它不仅仅是把文章从数据库里删掉那么简单，它还会清理掉跟这篇文章相关的各种数据，比如：

• 元数据 (Post Meta): 附加在文章上的各种信息，比如自定义字段的值。
• 评论 (Comments): 针对文章的留言。
• 附件 (Attachments): 上传到文章中的图片、视频等文件。
• 分类法 (Taxonomies): 文章所属的分类、标签等。
• 关系 (Relationships): 文章与其他文章之间的关系 (比如父子关系)。

所以，wp_delete_post() 就像一个专业的拆迁队，不仅要拆掉房子，还要把里面的家具、电器、装饰品都清理干净，确保不留下任何痕迹。

源码剖析：wp_delete_post() 的内部运作

咱们先来大致看一下 wp_delete_post() 的源码结构（基于最新 WordPress 版本，但可能会略有简化以便理解）：

function wp_delete_post( $postid, $force_delete = false ) {
    global $wpdb;

    $postid = absint( $postid ); // 确保 postid 是一个整数
    if ( ! $postid ) {
        return false; // 如果 postid 无效，直接返回 false
    }

    $post = get_post( $postid ); // 获取文章对象
    if ( ! $post ) {
        return false; // 如果文章不存在，返回 false
    }

    if ( ! current_user_can( 'delete_post', $postid ) ) {
        return false; // 权限检查，如果用户没有删除文章的权限，返回 false
    }

    if ( 'attachment' === $post->post_type ) {
        return wp_delete_attachment( $postid, $force_delete ); // 如果是附件，调用 wp_delete_attachment()
    }

    $hook_args = array( $postid, $post );

    /**
     * Fires before a post is deleted, at the start of the wp_delete_post() function.
     *
     * @since 4.4.0
     *
     * @param int     $postid Post ID.
     * @param WP_Post $post   Post object.
     */
    do_action( 'before_delete_post', $postid, $post );

    if ( $force_delete ) {
        /**
         * Fires before a post is permanently deleted.
         *
         * @since 2.9.0
         *
         * @param int     $postid Post ID.
         */
        do_action( 'wp_delete_post', $postid );

        delete_post_meta( $postid ); // 删除文章元数据

        wp_delete_object_term_relationships( $postid, get_object_taxonomies( $post->post_type ) ); // 删除分类法关系

        $comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d", $postid ) ); // 获取文章的所有评论 ID

        if ( $comment_ids ) {
            foreach ( $comment_ids as $comment_id ) {
                wp_delete_comment( $comment_id, true ); // 强制删除评论
            }
            unset( $comment_ids );
        }

        $del_attachments = $wpdb->get_results( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'attachment'", $postid ) ); // 获取文章的所有附件

        if ( $del_attachments ) {
            foreach ( $del_attachments as $del_attachment ) {
                wp_delete_attachment( $del_attachment->ID, true ); // 强制删除附件
            }
        }

        $wpdb->delete( $wpdb->posts, array( 'ID' => $postid ) ); // 最终删除文章

        clean_post_cache( $postid ); // 清理文章缓存

        /**
         * Fires after a post is permanently deleted.
         *
         * @since 2.9.0
         *
         * @param int $postid Post ID.
         */
        do_action( 'after_delete_post', $postid );

    } else {
        /**
         * Fires when a post is trashed.
         *
         * @since 2.9.0
         *
         * @param int $postid Post ID.
         */
        do_action( 'wp_trash_post', $postid );

        wp_trash_post( $postid ); // 将文章移到回收站
    }

    /**
     * Fires after a post is deleted.
     *
     * @since 4.4.0
     *
     * @param int     $postid Post ID.
     * @param WP_Post $post   Post object.
     */
    do_action( 'deleted_post', $postid, $post );

    return $post; // 返回被删除的文章对象
}

看起来是不是有点吓人？别怕，咱们一步一步来分析。

1. 参数检查与准备工作

• $postid: 要删除的文章 ID。 函数首先会确保它是一个有效的整数。
• $force_delete: 一个布尔值，决定是彻底删除文章（true）还是移到回收站（false）。默认为 false。
• get_post( $postid ): 获取文章对象，确保文章存在。
• current_user_can( 'delete_post', $postid ): 检查当前用户是否有权限删除这篇文章。这个权限检查非常重要，可以防止恶意用户删除别人的文章。

2. 附件的特殊处理

if ( 'attachment' === $post->post_type ) {
    return wp_delete_attachment( $postid, $force_delete );
}

如果 $post 是一个附件 (比如图片)，wp_delete_post() 会直接调用 wp_delete_attachment() 函数来处理删除逻辑。 wp_delete_attachment() 的处理方式与删除普通文章类似，但它还会处理附件的文件删除。 我们稍后会简单提到它。

3. 钩子 (Hooks) 的妙用

/**
 * Fires before a post is deleted, at the start of the wp_delete_post() function.
 *
 * @since 4.4.0
 *
 * @param int     $postid Post ID.
 * @param WP_Post $post   Post object.
 */
do_action( 'before_delete_post', $postid, $post );

在删除文章之前，wp_delete_post() 会触发一个 before_delete_post 的动作钩子。 这个钩子允许其他插件或主题在文章被删除之前执行一些自定义操作，比如记录删除日志、发送通知等等。 这体现了 WordPress 强大的可扩展性。

4. 彻底删除 (Force Delete) 的逻辑

如果 $force_delete 为 true，表示要彻底删除文章，wp_delete_post() 会执行以下操作：

• 触发 wp_delete_post 动作钩子: 允许插件在文章被永久删除之前执行操作。
• delete_post_meta( $postid ): 删除文章的所有元数据。 delete_post_meta() 会从 wp_postmeta 表中删除所有 post_id 等于 $postid 的记录。
• wp_delete_object_term_relationships( $postid, get_object_taxonomies( $post->post_type ) ): 删除文章与分类法 (比如分类、标签) 之间的关系。 wp_delete_object_term_relationships() 会从 wp_term_relationships 表中删除相关记录。

• 删除评论:

  $comment_ids = $wpdb->get_col( $wpdb->prepare( "SELECT comment_ID FROM $wpdb->comments WHERE comment_post_ID = %d", $postid ) );
  
  if ( $comment_ids ) {
      foreach ( $comment_ids as $comment_id ) {
          wp_delete_comment( $comment_id, true );
      }
      unset( $comment_ids );
  }

  这段代码首先查询数据库，获取所有与该文章相关的评论 ID。 然后，它会遍历这些评论 ID，并使用 wp_delete_comment( $comment_id, true ) 强制删除每一条评论。 wp_delete_comment() 函数与 wp_delete_post() 类似，也会删除评论的元数据和相关信息。

• 删除附件:

  $del_attachments = $wpdb->get_results( $wpdb->prepare( "SELECT ID FROM $wpdb->posts WHERE post_parent = %d AND post_type = 'attachment'", $postid ) );
  
  if ( $del_attachments ) {
      foreach ( $del_attachments as $del_attachment ) {
          wp_delete_attachment( $del_attachment->ID, true );
      }
  }

  这段代码查询数据库，找到所有 post_parent 等于当前文章 ID 且 post_type 为 attachment 的文章 (也就是该文章的附件)。 然后，它会遍历这些附件，并使用 wp_delete_attachment( $del_attachment->ID, true ) 强制删除每一个附件。 wp_delete_attachment() 函数会删除附件的文章记录，以及附件的物理文件（如果附件没有被其他文章使用）。

• $wpdb->delete( $wpdb->posts, array( 'ID' => $postid ) ): 这才是真正删除文章记录的关键代码！ 它使用 WordPress 的数据库操作对象 $wpdb，从 wp_posts 表中删除 ID 等于 $postid 的记录。
• clean_post_cache( $postid ): 清理文章缓存，确保下次访问时能获取到最新的数据。
• 触发 after_delete_post 动作钩子: 允许插件在文章被永久删除之后执行操作。

5. 移到回收站 (Trash) 的逻辑

如果 $force_delete 为 false (默认值)，表示只是把文章移到回收站，wp_delete_post() 会执行以下操作：

• 触发 wp_trash_post 动作钩子: 允许插件在文章被移到回收站之前执行操作。
• wp_trash_post( $postid ): 这个函数负责将文章的状态 ( post_status ) 更新为 trash，并更新 post_modified 和 post_modified_gmt 字段。 这样，文章就不会再在前台显示，但仍然保留在数据库中，可以从回收站恢复。

6. 删除后的钩子

/**
 * Fires after a post is deleted.
 *
 * @since 4.4.0
 *
 * @param int     $postid Post ID.
 * @param WP_Post $post   Post object.
 */
do_action( 'deleted_post', $postid, $post );

无论文章是被彻底删除还是移到回收站，wp_delete_post() 都会触发 deleted_post 动作钩子。

wp_delete_attachment() 简述

虽然我们主要关注 wp_delete_post()，但既然提到了 wp_delete_attachment()，我们简单看一下它的核心逻辑：

function wp_delete_attachment( $post_id, $force_delete = false ) {
    // ... (参数检查和权限验证) ...

    if ( $force_delete ) {
        // ... (触发钩子) ...

        $file = get_attached_file( $post_id ); // 获取附件的物理文件路径

        // ... (删除文章元数据和分类法关系) ...

        wp_delete_object_term_relationships( $post_id, get_object_taxonomies( 'attachment' ) );

        wp_delete_post_comments( $post_id, true );

        wp_delete_post_metadata_by_mid( $post_id );

        if ( ! empty( $file ) ) {
            $delete = @unlink( $file ); // 尝试删除物理文件

            if ( $delete ) {
                /**
                 * Fires after a file attachment is deleted.
                 *
                 * @since 2.1.0
                 *
                 * @param string $file The file that was deleted.
                 */
                do_action( 'wp_delete_file', $file );
            }
        }

        $thumbfile = get_attached_file( $post_id, true ); // 获取缩略图文件路径

        if ( ! empty( $thumbfile ) && $thumbfile != $file ) {
            @unlink( $thumbfile ); // 尝试删除缩略图文件
        }

         $wpdb->delete( $wpdb->posts, array( 'ID' => $post_id ) ); // 删除附件的文章记录

        clean_post_cache( $post_id ); // 清理缓存
    } else {
        // ... (移到回收站的逻辑) ...
    }

    // ... (触发钩子) ...
}

wp_delete_attachment() 的关键在于它会尝试删除附件的物理文件 (unlink( $file ))。 它还会删除缩略图文件。 但是，需要注意的是，如果同一个文件被多个文章引用，那么删除其中一个文章的附件并不会删除该文件，只有当没有其他文章引用该文件时，才会真正删除物理文件。

总结：wp_delete_post() 的威力

让我们用一个表格来总结一下 wp_delete_post() 的主要功能：

功能	描述
删除文章	从 wp_posts 表中删除文章记录。
删除元数据	从 wp_postmeta 表中删除所有与该文章相关的元数据。
删除分类法关系	从 wp_term_relationships 表中删除文章与分类法 (分类、标签等) 之间的关系。
删除评论	从 wp_comments 表中删除所有与该文章相关的评论，并删除评论的元数据。
删除附件	如果文章是附件，会尝试删除附件的物理文件，以及附件的文章记录。
清理缓存	清理文章缓存，确保数据一致性。
触发钩子	在删除过程的不同阶段触发多个动作钩子，允许插件或主题进行自定义操作。
回收站功能	如果 $force_delete 为 false，则将文章移到回收站，而不是彻底删除。
权限验证	检查当前用户是否有权限删除文章，确保安全性。

注意事项

• 备份！备份！备份！ 在执行任何删除操作之前，务必备份你的数据库！ 万一出了问题，你可以快速恢复。
• 谨慎使用 $force_delete = true: 彻底删除文章是不可逆的，请务必谨慎操作。
• 了解钩子: 利用 wp_delete_post() 提供的钩子，你可以扩展删除功能，比如发送邮件通知、记录删除日志等等。
• 性能考虑: 删除大量文章可能会对数据库性能产生影响，特别是彻底删除文章时。 可以考虑使用批量删除工具，或者优化数据库查询。

实际应用场景

• 插件开发: 如果你正在开发一个插件，需要删除文章，可以使用 wp_delete_post() 函数。
• 主题开发: 在主题中实现删除文章的功能时，也需要使用 wp_delete_post() 函数。
• 数据清理: 如果你需要清理 WordPress 网站上的垃圾文章，可以使用 wp_delete_post() 函数批量删除。
• 自定义删除逻辑: 通过钩子，你可以自定义文章删除的逻辑，比如在删除文章之前发送邮件通知管理员。

总结

wp_delete_post() 函数是 WordPress 中一个非常重要的函数，它负责删除文章以及所有相关的附属数据。 了解它的内部运作机制，可以帮助我们更好地使用它，并避免一些潜在的问题。 希望今天的讲解对大家有所帮助！ 下次再见！