分析 WordPress `get_post_status()` 函数的源码：如何获取文章状态，并解释其在数据库中的存储。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众老爷们，晚上好！我是今晚的讲师，老码农，一个在代码堆里摸爬滚打多年的老家伙。今天咱们来聊聊 WordPress 里的一个“小”函数，get_post_status()。别看它名字简单，功能可不小，它能告诉你一篇文章现在到底是个什么“状态”。状态这东西，听起来玄乎，其实就是文章活着还是死了，公开了还是私密了，准备好了还是还在草稿箱里躺着。

一、get_post_status()：你的文章，它说了算

首先，咱们先祭出这个函数的庐山真面目（简化版）：

function get_post_status( $post = null ) {
    $post = get_post( $post );

    if ( ! $post ) {
        return false;
    }

    return $post->post_status;
}

简单吧？三行代码，搞定！

第一行：$post = get_post( $post ); 这行很重要，它确保了你传递给函数的是一个有效的 $post 对象。如果你没传，它会尝试获取全局的 $post 对象。如果你传的是文章ID，它会用这个ID去数据库里捞出对应的文章信息，给你创建一个 $post 对象。get_post() 函数就像一个尽职尽责的门卫，确保进来的都是“良民”。
第二行：if ( ! $post ) { return false; } 如果get_post() 没找到对应的文章（比如你传了个不存在的ID），它就会返回 false，告诉我们，文章不存在！这是一种很负责任的表现。
第三行：return $post->post_status; 重头戏来了！这行代码直接从 $post 对象里拿出了 post_status 属性的值，然后返回。这个 post_status 就是文章的状态，比如 'publish'（已发布）、'draft'（草稿）、'pending'（待审核）等等。

二、$post 对象：文章的“身份证”

上面提到 $post 对象，它包含了文章的所有信息。你可以把它想象成一个装满了文章各种属性的“容器”。其中，post_status 只是众多属性中的一个。让我们来看看 $post 对象里可能包含的一些重要属性：

属性名	描述	示例
`ID`	文章的唯一ID，也就是文章在数据库中的“身份证号”。	`123`
`post_author`	文章作者的ID。	`5`
`post_date`	文章的发布日期和时间。	`2023-10-27 20:00:00`
`post_date_gmt`	文章的GMT（格林尼治标准时间）发布日期和时间。	`2023-10-27 12:00:00`
`post_content`	文章的内容，也就是你写的正文。	`"这是一篇精彩的文章"`
`post_title`	文章的标题。	`"如何使用 get_post_status()"`
`post_excerpt`	文章的摘要，通常用于显示在文章列表或搜索结果中。	`"这篇文章介绍了 get_post_status()"`
`post_status`	文章的状态！这就是咱们今天的主角！	`'publish'`
`comment_status`	评论状态，允许评论（`'open'`）还是不允许评论（`'closed'`）。	`'open'`
`ping_status`	Pingback/Trackback 状态，允许接收（`'open'`）还是不允许接收（`'closed'`）。	`'open'`
`post_password`	文章的密码，如果文章设置了密码保护。	`""`
`post_name`	文章的别名（slug），用于生成URL。	`"get-post-status"`
`to_ping`	需要Pingback的URL列表。	`""`
`pinged`	已经Pingback的URL列表。	`""`
`post_modified`	文章的最后修改日期和时间。	`2023-10-27 20:30:00`
`post_modified_gmt`	文章的GMT最后修改日期和时间。	`2023-10-27 12:30:00`
`post_content_filtered`	文章内容过滤后的版本。	`""`
`post_parent`	父文章的ID，用于创建层级结构的文章（例如页面）。	`0`
`guid`	文章的永久链接。	`"http://example.com/?p=123"`
`menu_order`	文章在菜单中的排序顺序。	`0`
`post_type`	文章的类型，例如 `'post'`（文章）、`'page'`（页面）、`'attachment'`（附件）等等。	`'post'`
`post_mime_type`	文章的 MIME 类型，通常用于附件。	`""`
`comment_count`	文章的评论数量。	`10`

三、文章状态：数据库里的“生死簿”

文章状态，也就是 post_status，存储在 WordPress 数据库的 wp_posts 表中。这个表是 WordPress 的核心表之一，存储了所有的文章、页面、附件等内容。

wp_posts 表的结构大概是这样的（简化版）：

字段名	数据类型	描述
`ID`	`BIGINT(20)`	文章的唯一ID，主键。
`post_author`	`BIGINT(20)`	文章作者的ID，外键，关联到 `wp_users` 表。
`post_date`	`DATETIME`	文章的发布日期和时间。
`post_date_gmt`	`DATETIME`	文章的GMT发布日期和时间。
`post_content`	`LONGTEXT`	文章的内容。
`post_title`	`TEXT`	文章的标题。
`post_excerpt`	`TEXT`	文章的摘要。
`post_status`	`VARCHAR(20)`	文章的状态！存储的就是像 `'publish'`、`'draft'` 这样的字符串。
…	…	其他字段，例如 `comment_status`、`ping_status`、`post_password`、`post_name` 等等。

post_status 字段的类型是 VARCHAR(20)，也就是说，它存储的是一个长度不超过20个字符的字符串。这个字符串就代表了文章的状态。

四、常见的文章状态：你的文章，它是什么“人”？

WordPress 预定义了一些文章状态，它们分别代表了文章的不同阶段和状态。下面是一些常见的文章状态：

状态	描述	前台可见性	后台可见性
`'publish'`	已发布：文章已经公开发布，所有人都可以看到。	可见	可见
`'pending'`	待审核：文章已经提交，等待管理员或编辑审核。	不可见	可见
`'draft'`	草稿：文章尚未完成，仅作者可见。	不可见	可见
`'auto-draft'`	自动草稿：WordPress 自动保存的草稿，通常在用户开始编辑文章但尚未手动保存时创建。	不可见	可见
`'future'`	预定发布：文章已经设置了未来的发布时间，到指定时间会自动发布。	不可见	可见
`'private'`	私有：文章仅对登录的用户可见。	不可见	可见
`'trash'`	已删除：文章被移动到回收站，尚未永久删除。	不可见	可见
`'inherit'`	继承：通常用于附件，表示附件继承了父文章的状态。	取决于父文章	取决于父文章

五、get_post_status() 的实际应用：代码说话

现在，咱们来看看 get_post_status() 在实际开发中可以用来做什么：

判断文章是否已发布：

$post_id = 123; // 假设文章ID是123
$status = get_post_status( $post_id );

if ( $status == 'publish' ) {
    echo "这篇文章已经发布了！";
} else {
    echo "这篇文章还没有发布！";
}

根据文章状态显示不同的内容：

$post_id = 456;
$status = get_post_status( $post_id );

switch ( $status ) {
    case 'publish':
        echo "<p>这篇文章已经发布，欢迎阅读！</p>";
        break;
    case 'draft':
        echo "<p>这篇文章还在草稿中，敬请期待！</p>";
        break;
    case 'pending':
        echo "<p>这篇文章正在审核中，请稍候！</p>";
        break;
    default:
        echo "<p>这篇文章状态未知！</p>";
        break;
}

在后台管理界面显示文章状态：

你可以在自定义的 WordPress 后台管理界面中使用 get_post_status() 来显示文章的状态，让管理员更清楚地了解文章的状况。
控制文章的可见性：

你可以根据文章的状态来控制文章在前台的可见性，比如只显示已发布的文章，隐藏草稿和待审核的文章。

六、深入研究：register_post_status() 函数

WordPress 不仅仅提供了预定义的文章状态，还允许你自定义文章状态。这就要用到 register_post_status() 函数了。

register_post_status() 函数可以让你注册一个新的文章状态，并定义它的属性，比如是否公开可见、是否允许在后台选择等等。

function my_custom_post_status() {
    register_post_status( 'special', array(
        'label'                     => _x( 'Special', 'post' ),
        'public'                    => true, // 是否公开可见
        'exclude_from_search'       => false, // 是否从搜索结果中排除
        'show_in_admin_all_list'    => true, // 是否在后台文章列表中显示
        'show_in_admin_status_list' => true, // 是否在后台文章状态列表中显示
        'label_count'               => _n_noop( 'Special <span class="count">(%s)</span>', 'Special <span class="count">(%s)</span>' ),
    ) );
}
add_action( 'init', 'my_custom_post_status' );

上面的代码注册了一个名为 'special' 的自定义文章状态。这个状态是公开可见的，可以在后台文章列表中显示。

注册了自定义文章状态之后，你就可以在编辑文章时选择这个状态了。然后，你就可以像使用预定义的文章状态一样，使用 get_post_status() 来获取文章的状态。

七、注意事项：一些“坑”要避开

缓存问题： WordPress 有缓存机制，有时候 get_post_status() 返回的值可能不是最新的。你可以使用 wp_cache_flush() 函数来清除缓存，或者使用 get_post( $post_id, OBJECT, true ) 来强制刷新缓存。
权限问题： 如果当前用户没有权限查看某个文章，get_post_status() 可能会返回错误的结果。你需要使用 current_user_can() 函数来检查用户是否有权限查看文章。
主题和插件冲突： 有些主题和插件可能会修改文章状态的逻辑，导致 get_post_status() 返回的值不符合预期。你需要仔细检查主题和插件的代码，找到冲突的原因。
循环中的性能问题： 在循环中使用 get_post_status() 时，要注意性能问题。尽量避免在每次循环迭代中都调用 get_post_status()，可以先把所有文章的状态都获取到，然后缓存起来，在循环中使用缓存的值。

八、总结：get_post_status()，小而强大

get_post_status() 函数虽然简单，但功能却很强大。它可以告诉你文章的状态，让你根据状态来控制文章的可见性、显示不同的内容，甚至自定义文章状态。

掌握了 get_post_status() 函数，你就能更好地控制你的 WordPress 网站的内容，让你的网站更加灵活和强大。

好了，今天的讲座就到这里。希望大家有所收获！如果还有什么问题，欢迎提问。下次有机会再跟大家分享其他的 WordPress 技巧。

散会！

发表回复 取消回复

发表回复取消回复