WP-CLIwp-cli 是 WordPress 的命令行工具，它允许你通过终端或命令行界面快速管理 WordPress

wp-cli 基础用法指南

wp-cli 是 WordPress 的命令行工具，它允许你通过终端或命令行界面快速管理 WordPress 站点。使用 wp-cli 可以避免频繁登录到 WordPress 后台，提升效率，特别适合开发者、运维人员和高级用户。

本教程将介绍一些 wp-cli 的基础用法，帮助你快速上手。

📦 一、安装 wp-cli

Linux / macOS 用户：

# 下载 wp-cli.phar 文件
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

# 赋予执行权限
chmod +x wp-cli.phar

# 移动到系统路径中以便全局调用
sudo mv wp-cli.phar /usr/local/bin/wp

# 验证是否安装成功
wp --info

Windows 用户（推荐使用 WSL 或 XAMPP）：

你可以下载 wp-cli.phar，然后使用 PHP 执行：

php wp-cli.phar --info

也可以创建批处理文件来简化调用。

🧭 二、基本结构

所有 wp-cli 命令都以 wp 开头，后面跟子命令和参数：

wp <command> <subcommand> [arguments] [parameters]

例如：

wp plugin install hello-dolly --activate

🔧 三、常用功能示例

1. 站点信息查看

wp option get blogname          # 获取站点名称
wp option get home              # 获取首页地址
wp site list                    # 列出多站点网络中的站点（如果是多站点）

2. 插件管理

wp plugin list                  # 查看已安装插件列表
wp plugin install e lementor       # 安装 Elementor 插件
wp plugin activate elementor      # 激活 Elementor 插件
wp plugin deactivate elementor    # 停用 Elementor 插件
wp plugin update elementor        # 更新 Elementor 插件
wp plugin delete elementor        # 删除 Elementor 插件

3. 主题管理

wp theme list                   # 查看已安装主题列表
wp theme install twentytwentyfour --activate   # 安装并启用 twentytwentyfour 主题
wp theme update twentytwentyfour              # 更新主题
wp theme delete twentytwentyfour              # 删除主题

4. 用户管理

wp user list                    # 列出所有用户
wp user create username email@example.com --role=author --user_pass=password   # 创建新用户
wp user update 1 --user_email=newemail@example.com   # 更新用户邮箱
wp user delete 2 --reassign=1   # 删除用户并将其文章重新分配给其他用户

5. 文章管理

wp post list                    # 列出所有文章
wp post create --post_title="Hello World" --post_content="This is my first post." --post_status=publish   # 创建一篇已发布文章
wp post update 123 --post_title="New Title"   # 更新某篇文章
wp post delete 123 --force      # 彻底删除一篇文章

6. 数据库操作

wp db export backup.sql         # 导出数据库
wp db import backup.sql         # 导入数据库
wp db optimize                  # 优化数据库表
wp db repair                    # 修复数据库表

7. 缓存清理与搜索替换

wp cache flush                  # 清除缓存
wp transient delete-all         # 删除所有临时数据（常用于调试）

# 替换内容中的 URL（如迁移网站时）
wp search-replace 'http://oldsite.com' 'http://newsite.com'

8. 多站点（Multisite）支持

如果你的 WordPress 是多站点模式：

wp site list
wp site create --slug=newsite   # 创建一个新站点
wp site delete 2                # 删除站点 ID 为 2 的站点

🛠 四、高级技巧

1. 使用 --format=json 输出 JSON 格式结果

wp user list --format=json

2. 批量操作（结合 shell 命令）

例如批量禁用所有插件：

wp plugin list --field=name | xargs wp plugin deactivate

3. 自定义命令（使用 WP-CLI 包）

可以使用 WP-CLI 的包管理器安装扩展命令：

wp package install wp-cli/rest-command

✅ 五、注意事项

使用 wp-cli 之前，请确保你在 WordPress 根目录下运行命令，或者指定用户和目录。

不建议在生产环境随意使用 search-replace 或 delete 类命令，操作前请备份数据库。

如果你是多站点（Multisite），注意使用 --url 参数指定具体站点。

示例：

根目录
sudo -u www -- wp --path=/www/wwwroot/example theme list --url=subsite.example.com 
子目录
sudo -u www -- wp theme list --url=subsite.example.com

📘 六、官方文档与资源

🧪 七、总结

wp-cli 是一个强大的 WordPress 命令行工具，熟练掌握后可以显著提高开发和维护效率。本文介绍了其基础命令和常见用途，建议你在本地测试环境中练习后再用于正式项目。