一条命令发博客:给 WordPress 接一根命令行发布管线⚡

silas 发布于 7 天前 63 次阅读 技术复盘


后台发一篇文章要走七步。

登录、等加载、点新建、填标题、粘正文、选分类、点保存。每一步都不难,但每一步都在劝你「明天再写吧」。

所以我停了八个月。

真正卡住我的不是没东西写,是写完之后那一堆机械动作。这次我把它们压成了一条命令。

🔍 先试了三条路,全是墙

标准的做法是走 WordPress REST API,/wp-json/wp/v2/posts 一个 POST 就完事。我先测了一下:

curl -s -o /dev/null -w '%{http_code}' https://fky.ltd/wp-json/wp/v2/posts
# 404

404。不是权限问题,是路由根本没挂上。宝塔面板里这个站点的伪静态配置文件是 0 字节,空的,index.php?rest_route= 这套 rewrite 自然没生效。

那就换应用密码 + Basic Auth。进后台一看,wp_is_application_passwords_available() 返回 false —— 这个函数在非 HTTPS 或者被 filter 关掉的站点上会直接拒绝。

第三条路是 XML-RPC,老牌方案,客户端支持也全。服务器上没装 wp-cli,就直接进 PHP 读这个开关:

php -r 'define("WP_USE_THEMES",false); require "wp-load.php"; echo get_option("enable_xmlrpc") ? "on" : "off";'
# off

三条路,三条都堵死。

🔧 最后选了最土的办法

我换了个思路:别跟 HTTP 层较劲,直接进 PHP 里调 WordPress 自己的函数。

服务器上本来就跑着 PHP 8.3 和完整的 WordPress 核心。写个 CLI 脚本 require 一下 wp-load.php,后面就能用 wp_insert_post(),和主题、插件用的是同一套 API。文章该有的分类、标签、摘要、特色图,全都能设。

关键是这个脚本放在站点根目录之外的一个目录里,Web 访问不到,也不占 URL。

<?php
define('WP_USE_THEMES', false);
require '/path/to/wordpress/wp-load.php';   // 换成你自己站点的 wp-load.php 绝对路径

$d = json_decode(stream_get_contents(STDIN), true);
$id = wp_insert_post([
    'post_title'   => $d['title'],
    'post_content' => $d['content'],
    'post_status'  => $d['status'],   // 默认 draft
    'post_type'    => 'post',
], true);

WP_USE_THEMES 那句必须加。不加的话 WordPress 会尝试加载主题模板,在 CLI 环境下直接报错退出。

到这一步服务器端通了,但还有个麻烦:文章不能手写 HTML。写 Markdown 习惯了,粘一段带表格和代码块的 md 进去,WordPress 会把它当纯文本渲染成一坨。

💥 踩到的坑

坑一:Markdown 没人转。 WordPress 核心不带 Markdown 解析,常规做法是装插件,但我不想为了发文章往站上塞插件。最后写了个零依赖的 Python 转换器,273 行,覆盖标题、列表、代码块、表格、引用、图片、链接,够用。

坑二:管道里的中文。 Windows 上的 Python 往管道写中文,stdout 用的是本地编码(cp936),json.dumps 出来就是错的。改成 sys.stdout.buffer.write(out.encode('utf-8')) 才干净。

坑三:重复发布。 脚本跑两次就有两篇一样的文章。加了个 slug 检查,get_page_by_path() 命中就带上 ID 走更新,不再新建。

坑四:误发上线。 这是最危险的一条。所以默认状态写死成 draft,想公开必须显式传 publish。宁可多点一下,不想哪天半成品直接挂到首页。

📊 现在的样子

写稿是一个 Markdown 文件,带 Front Matter 写标题、slug、分类、标签:

---
title: 标题
slug: english-kebab-case
status: draft
categories: [技术复盘]
tags: [WordPress, PHP]
---

发布就一行:

python md2html.py drafts/xxx.md | ssh blog "php ~/blog-publish.php"

返回一个 JSON,里面有后台编辑链接和预览链接。打开看一眼,没问题就点发布。

从七步到一步。

🧭 这条管线的边界

得说清楚它不管什么。

它不管选题。写什么、值不值得写,还是得自己想。工具只解决了「想写但懒得动手」这一层。

它也不管质量。命令能保证文章格式正确、状态是草稿,保证不了内容站得住。数字是不是真的、结论是不是自己验证过的,这件事只能靠人。

还有个隐患:wp_insert_post() 走的是数据库直写,不触发 REST 层的钩子。如果以后接了缓存插件或者静态化,发完记得刷一下缓存。

至于下一步,我想试试让这套东西往前走一格——不只是「我写好,它发出去」,而是「我给它一个选题和一堆素材,它给我一版能改的初稿」。骨架它搭,判断我来做。

毕竟博客这东西,机器能帮你省下排版的时间,但省不掉「你到底想说什么」这件事。