wp-wpcli-and-ops

WP-CLI 和运维

适用场景

当任务涉及通过 WP-CLI 执行 WordPress 运维工作时，使用此技能，包括：

• wp search-replace（URL 更改、域名迁移、协议切换）
• 数据库导出/导入、重置和检查（wp db *）
• 安装/启用/更新插件或主题、语言包
• 列出/运行 cron 事件
• 刷新缓存/重写规则
• 多站点操作（wp site *、--url、--network）
• 构建可重复执行的脚本（wp-cli.yml、shell 脚本、CI 作业）

所需输入

• WP-CLI 的运行位置（本地开发、预发布、生产环境），以及运行是否安全。
• 如何定位正确的站点根目录：
  • --path=<wordpress-root>，以及（多站点）--url=<site-url>
• 是否为多站点，以及命令是否应在整个网络范围内运行。
• 任何限制条件（不能停机、不能写入数据库、维护时段）。

操作流程

0) 安全防护：确认环境和影响范围

WP-CLI 命令可能具有破坏性。运行任何会写入数据的命令之前：

1. 确认环境（开发/预发布/生产）。
2. 确认目标（path/url），避免操作错误的站点。
3. 执行高风险操作时创建备份。

请阅读：

• references/safety.md

1) 检查 WP-CLI 和站点目标（确定性）

运行检查器：

• node skills/wp-wpcli-and-ops/scripts/wpcli_inspect.mjs --path=<path> [--url=<url>]

如果 WP-CLI 不可用，请改用项目文档中说明的工具进行安装（Composer、容器或系统软件包），或者询问预期的执行环境。

2) 选择合适的工作流

A) 安全迁移 URL/域名（search-replace）

按以下安全顺序操作：

1. wp db export（备份）
2. wp search-replace --dry-run（检查影响）
3. 使用合适的标志运行实际替换
4. 如有需要，刷新缓存/重写规则

请阅读：

• references/search-replace.md

B) 插件/主题操作

使用 wp plugin * / wp theme *，并先确认操作的是预期站点（及网络）。

请阅读：

• references/packages-and-updates.md

C) Cron 和队列

检查 cron 状态；调试时应运行单个事件，而不是不加判断地“全部运行”。

请阅读：

• references/cron-and-cache.md

D) 多站点操作

多站点更改可能影响许多站点。务必先决定操作范围：

• 单个站点（--url=），或
• 整个网络（--network / 遍历站点）

请阅读：

• references/multisite.md

3) 自动化模式（脚本 + wp-cli.yml）

对于可重复执行的运维操作，建议使用：

• wp-cli.yml 设置默认值（path/url、PHP 内存限制）
• 记录命令并在出错时停止的 shell 脚本
• 默认只运行只读检查的 CI 作业

请阅读：

• references/automation.md

验证

• 对可能影响目标定位或配置的更改，完成后重新运行 wpcli_inspect。
• 确认预期的副作用：
  • 正确的 URL 已更新
  • 插件/主题处于预期状态
  • 必要时已刷新 cron/缓存
• 如果有健康检查端点或冒烟测试套件，请在运维更改后运行。

故障模式 / 调试

• “Error: This does not seem to be a WordPress installation.”
  • --path 错误、容器错误，或缺少 wp-config.php
• 多站点命令影响了错误的站点
  • 缺少 --url 或 URL 错误
• Search-replace 导致意外的序列化问题
  • 标志错误，或不安全地更改了序列化数据

请参阅：

• references/debugging.md

升级处理

• 如果无法确认环境安全，请勿运行写入操作。
• 如果仓库使用容器化工具（Docker/wp-env），但你无法访问，请询问预期的命令运行器或 CI 作业。