用 WP-CLI 管理站点

1. WP-CLI 适合批量和可重复操作#

WP-CLI 可以查询 WordPress 状态、管理插件主题、导出数据库和执行迁移替换。它不是一个独立后台，需要在正确的 WordPress 安装目录中运行，并使用与网站兼容的 PHP。

先从 WP-CLI 官方安装文档获取当前安装方式，核对下载与校验要求。不要把第三方脚本作为 root 执行；安装后先查看环境。

wp --info
php -v
pwd

2. 先做只读查询确认站点#

切到站点根目录，或显式使用 --path=/实际/站点路径。以站点文件所属用户运行，避免为了绕过权限提示长期使用 --allow-root。

wp core version
wp option get home
wp option get siteurl
wp plugin list
wp theme list

home/siteurl 应对应你要管理的站点。多站点环境还需要指定目标 URL。无法连接数据库时，先检查配置与运行环境，不能盲目在当前目录执行安装命令。

3. 安装、更新插件前记录当前版本#

wp plugin list --fields=name,status,version,update
wp plugin update 插件目录名 --dry-run

这里的插件目录名需要替换为列表中的真实 slug。先在测试站验证，再备份生产站并更新指定插件。更新全部插件虽然方便，但故障时较难定位，尤其不适合同时跨多个大版本。

安装插件可使用 wp plugin install 官方插件slug，确认来源后再 activate。商业插件按发布者的授权和更新方式处理，不能从不明下载包安装。

4. 数据库导出与替换先预演#

wp db export /home/deploy/wordpress-backup.sql
wp search-replace 'https://old.example.com' 'https://new.example.com' --all-tables-with-prefix --skip-columns=guid --dry-run

导出位置应在网站公开目录外，限制权限并传到另一处。替换会处理 WordPress 常见序列化数据，但仍要核对表范围、前缀和对象类型；确认预演后才执行实际替换。

数据库导入、用户删除和重置站点都属于会改变数据的操作，不应把它们混进一般“检查脚本”。命令自动化时记录退出状态，并在失败时停止后续写操作。

5. 排查 PHP 和权限问题#

CLI 与 PHP-FPM 的扩展、内存和配置可能不同。WP-CLI 报缺扩展时，查看 php --ini 和 php -m；网站正常不代表命令行环境一样。必要时使用明确的 PHP 二进制路径运行。

插件导致命令无法启动时，可按官方说明使用 --skip-plugins 或 --skip-themes 做有限排查，但这不一定跳过 mu-plugins，也不能当作正常业务验证。

6. 命令完成后回到网页验收#

更新后测试文章、后台保存、上传和插件功能，查看错误日志。自动化脚本中使用完整路径、合适用户和受限凭据，参见计划任务。迁移的完整流程见WordPress 搬家。