后台发一篇文章要走七步。
登录、等加载、点新建、填标题、粘正文、选分类、点保存。每一步都不难,但每一步都在劝你「明天再写吧」。
所以我停了八个月。
真正卡住我的不是没东西写,是写完之后那一堆机械动作。这次我把它们压成了一条命令。
🔍 先试了三条路,全是墙
标准的做法是走 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 层的钩子。如果以后接了缓存插件或者静态化,发完记得刷一下缓存。
至于下一步,我想试试让这套东西往前走一格——不只是「我写好,它发出去」,而是「我给它一个选题和一堆素材,它给我一版能改的初稿」。骨架它搭,判断我来做。
毕竟博客这东西,机器能帮你省下排版的时间,但省不掉「你到底想说什么」这件事。