详解 WordPress `wp_insert_post()` 函数在 WP-CLI 中的源码：如何在命令行中创建文章。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众，晚上好！今天咱们来聊聊如何在命令行里，用 WordPress 的“神兵利器” wp_insert_post() 创建文章。我知道，有些人一听命令行就头疼，觉得那是黑客的专属。别怕！今天我就把这个看似高深的技能，用最接地气的方式，掰开了揉碎了，教给大家。

一、开场白：wp_insert_post() 是个啥？

想象一下，wp_insert_post() 就是 WordPress 内容管理系统里的一位“辛勤园丁”，你给它指定一些“种子”（文章的各种属性），它就能帮你种出一棵“参天大树”（文章）。

简单来说，wp_insert_post() 是 WordPress 内核提供的一个函数，用于在数据库中创建或更新文章（包括文章、页面、自定义文章类型等）。它功能强大，参数众多，但是别被吓到，我们一步一步来。

二、WP-CLI：让命令行不再枯燥

WP-CLI，全称 WordPress Command Line Interface，是 WordPress 官方提供的命令行工具。有了它，我们可以告别繁琐的后台操作，直接在命令行里管理 WordPress。

你可以把它想象成一个“遥控器”，通过它，我们可以远程控制 WordPress 的各个功能。

三、wp_insert_post() 在 WP-CLI 中的“身影”

WP-CLI 本身并没有直接公开 wp_insert_post() 函数。它提供了一套自己的命令，比如 wp post create，这些命令底层调用了 WordPress 的各种 API，包括 wp_insert_post()。

所以，我们实际上是通过 WP-CLI 的命令，间接使用了 wp_insert_post() 的功能。

四、wp post create：命令行创建文章的利器

wp post create 命令是 WP-CLI 中创建文章的命令。它的基本用法如下：

wp post create --title="文章标题" --content="文章内容" --post_status="publish"

这条命令会创建一个标题为“文章标题”，内容为“文章内容”，状态为“发布”的文章。

五、wp post create 背后的“秘密”：wp_insert_post() 的参数映射

wp post create 命令的参数，实际上对应了 wp_insert_post() 函数的参数。

为了更直观地理解，我们来看一个表格：

`wp post create` 参数	`wp_insert_post()` 参数	说明
`--title`	`post_title`	文章标题
`--content`	`post_content`	文章内容
`--post_status`	`post_status`	文章状态（publish, draft, pending, private, future, trash）
`--post_type`	`post_type`	文章类型（post, page, attachment, revision, nav_menu_item, custom post type）
`--post_author`	`post_author`	文章作者 ID
`--post_date`	`post_date`	文章发布日期（YYYY-MM-DD HH:MM:SS）
`--post_date_gmt`	`post_date_gmt`	文章发布日期（GMT 时间，YYYY-MM-DD HH:MM:SS）
`--post_excerpt`	`post_excerpt`	文章摘要
`--post_password`	`post_password`	文章密码
`--comment_status`	`comment_status`	评论状态（open, closed）
`--ping_status`	`ping_status`	引用通告状态（open, closed）
`--post_name`	`post_name`	文章缩略名（URL slug）
`--to_ping`	`to_ping`	要引用通告的 URL 列表，用空格分隔
`--pinged`	`pinged`	已引用通告的 URL 列表，用空格分隔
`--post_modified`	`post_modified`	文章最后修改日期（YYYY-MM-DD HH:MM:SS）
`--post_modified_gmt`	`post_modified_gmt`	文章最后修改日期（GMT 时间，YYYY-MM-DD HH:MM:SS）
`--post_parent`	`post_parent`	父级文章 ID
`--menu_order`	`menu_order`	菜单顺序
`--tax_input`	`tax_input`	分类和标签信息（JSON 格式）
`--meta_input`	`meta_input`	自定义字段信息（JSON 格式）
`--porcelain`	N/A	只输出文章 ID

可以看到，wp post create 命令的参数，几乎涵盖了 wp_insert_post() 函数的所有常用参数。

六、深入剖析：几个关键参数的用法

--title 和 --content：文章的灵魂

这两个参数分别用于设置文章的标题和内容。

wp post create --title="我的第一篇命令行文章" --content="这是我的第一篇用命令行创建的文章，感觉真棒！"

--post_status：文章的状态

这个参数用于设置文章的状态。常用的状态有：
- publish：发布
- draft：草稿
- pending：待审核
- private：私有
- future：定时发布
```
wp post create --title="定时发布的文章" --content="这篇文章将在未来某个时间发布。" --post_status="future" --post_date="2024-03-15 10:00:00"
```
--post_type：文章的类型

这个参数用于设置文章的类型。常用的类型有：
- post：文章
- page：页面
- attachment：附件
- 自定义文章类型
```
wp post create --title="我的新页面" --content="这是我的新页面内容。" --post_type="page"
```

--post_author：文章的作者

这个参数用于设置文章的作者。需要提供作者的 ID。

wp post create --title="作者指定的文章" --content="这篇文章由指定作者发布。" --post_author=1

--tax_input：分类和标签的设置

这个参数用于设置文章的分类和标签。需要提供 JSON 格式的数据。
```
wp post create --title="带有分类和标签的文章" --content="这篇文章有分类和标签。" --tax_input='{"category":["科技", "新闻"], "post_tag":["WP-CLI", "WordPress"]}'
```
注意： tax_input 参数需要使用 JSON 格式，其中 category 和 post_tag 分别对应分类和标签的 taxonomy。如果分类或标签不存在，WordPress 会自动创建。
--meta_input：自定义字段的设置

这个参数用于设置文章的自定义字段。同样需要提供 JSON 格式的数据。
```
wp post create --title="带有自定义字段的文章" --content="这篇文章有自定义字段。" --meta_input='{"my_custom_field":"自定义字段的值", "another_field":123}'
```
注意： meta_input 参数也需要使用 JSON 格式。

--porcelain：只输出文章 ID

这个参数可以让命令只输出文章的 ID，方便在脚本中使用。

POST_ID=$(wp post create --title="只输出 ID 的文章" --content="这篇文章只用来获取 ID。" --porcelain)
echo "文章 ID: $POST_ID"

七、实战演练：几个例子

创建一篇简单的文章：

wp post create --title="Hello World from WP-CLI" --content="This is a test post created using WP-CLI." --post_status="publish"

创建一篇草稿文章：

wp post create --title="Draft Article" --content="This is a draft article." --post_status="draft"

创建一篇指定作者的文章：

wp post create --title="Article by Author 1" --content="This article is written by author 1." --post_author=1 --post_status="publish"

（假设 ID 为 1 的用户存在）

创建一篇带有分类和标签的文章：

wp post create --title="Article with Categories and Tags" --content="This article has categories and tags." --tax_input='{"category":["Technology", "WordPress"], "post_tag":["WP-CLI", "Command Line"]}' --post_status="publish"

创建一篇带有自定义字段的文章：

wp post create --title="Article with Custom Fields" --content="This article has custom fields." --meta_input='{"author_email":"[email protected]", "article_views":100}' --post_status="publish"

创建一篇定时发布的文章：

wp post create --title="Scheduled Post" --content="This post will be published on a specific date and time." --post_status="future" --post_date="2024-12-31 23:59:59"

八、进阶技巧：结合脚本自动化

我们可以将 wp post create 命令嵌入到脚本中，实现文章的批量创建和自动化管理。

例如，我们可以编写一个 shell 脚本，从 CSV 文件中读取文章数据，然后批量创建文章。

#!/bin/bash

CSV_FILE="articles.csv"

while IFS=',' read -r title content category tags; do
  wp post create --title="$title" --content="$content" --tax_input='{"category":["'$category'"], "post_tag":["'$tags'"]}' --post_status="publish"
done < "$CSV_FILE"

这个脚本假设 articles.csv 文件的格式如下：

文章标题1,文章内容1,分类1,标签1 标签2
文章标题2,文章内容2,分类2,标签3 标签4
...

九、wp_insert_post() 的“真面目”：源码分析

虽然我们主要通过 wp post create 命令来使用 wp_insert_post()，但是了解 wp_insert_post() 函数的源码，可以更深入地理解其工作原理。

wp_insert_post() 函数位于 wp-includes/post.php 文件中。它的主要流程如下：

参数校验和准备： 检查传入的参数是否合法，并根据参数设置一些默认值。
文章状态转换： 根据传入的 post_status 参数，进行状态转换和权限判断。
数据清洗和过滤： 对文章的标题、内容等数据进行清洗和过滤，防止 XSS 攻击。
插入或更新数据库： 根据 ID 参数判断是插入新文章还是更新现有文章，然后执行相应的 SQL 语句。
更新分类和标签： 根据 tax_input 参数，更新文章的分类和标签。
更新自定义字段： 根据 meta_input 参数，更新文章的自定义字段。
触发 Actions： 在文章插入或更新前后，触发一些 actions，方便插件进行扩展。
返回结果： 返回文章的 ID。

由于 wp_insert_post() 函数的代码比较复杂，这里就不贴出全部源码了。但是，通过阅读源码，我们可以更深入地理解 WordPress 的工作机制。

十、总结与展望

今天我们学习了如何使用 WP-CLI 的 wp post create 命令，间接利用 WordPress 的 wp_insert_post() 函数，在命令行中创建文章。

掌握了这个技能，我们可以大大提高 WordPress 的管理效率，实现文章的批量创建和自动化管理。

希望今天的讲座对大家有所帮助。记住，命令行不是洪水猛兽，而是一个强大的工具，只要掌握了正确的方法，就能事半功倍。

以后有机会，我们再深入探讨 WordPress 的其他 API 和 WP-CLI 的高级用法。谢谢大家！

发表回复 取消回复

发表回复取消回复