WP-CLI 中文入门教程:WordPress 命令行操作指南

WP-CLI 全称是 WordPress Command Line Interface,是 WordPress 官方推荐的命令行工具,可以在终端中对 WordPress 网站进行操作,不依赖后台界面。

使用 WP-CLI 管理网站,比起鼠标操作更快速灵活,适合批量处理、自动化流程和高效维护。

20250621101236602-image

WP-CLI 能做什么?

WP-CLI 可执行大多数日常任务,例如:

操作类型 命令示例
插件管理 wp plugin install contact-form-7 --activate
WordPress 更新 wp core update
创建文章 wp post create --post_title="Hello CLI"
删除评论 wp comment delete 123 --force
数据库导出 wp db export backup.sql
创建用户 wp user create testuser test@example.com
清理缓存 wp cache flush
查询站点信息 wp site list(适用于多站点)

WP-CLI 的优势

操作更快

一条命令完成多个步骤,减少鼠标点击,提高工作效率。

支持自动化

可将命令写入 Shell 脚本、CI/CD 流程,实现定时任务或发布自动化。

安全依赖更少

不依赖图形后台界面,避免加载资源,降低出错几率。

安装 WP-CLI

Linux / macOS:

  1. 打开终端,下载核心文件: curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
  2. 测试文件有效性: php wp-cli.phar --info
  3. 添加为全局命令:chmod +x wp-cli.phar sudo mv wp-cli.phar /usr/local/bin/wp
  4. 输入 wp --info,显示信息代表安装成功。

Windows:

建议使用 WP-CLI for Windows 安装器 或通过 Windows Subsystem for Linux 执行。

开始使用

进入 WordPress 网站根目录后,输入:wp

会显示所有命令分类,例如:

  • wp plugin:插件操作
  • wp theme:主题管理
  • wp post:文章操作
  • wp option:网站设置
  • wp db:数据库管理
  • wp user:用户处理

若不在 WordPress 根目录,会提示缺少 wp-config.php

常用命令汇总

插件管理

wp plugin list
wp plugin install akismet --activate
wp plugin deactivate contact-form-7

主题管理

wp theme install astra --activate
wp theme update astra

数据库操作

wp db export backup.sql
wp db import backup.sql

文章管理

wp post create --post_title="新文章" --post_status=publish
wp post delete 123 --force

用户操作

wp user list
wp user create tom tom@example.com --role=editor

缓存清理

wp cache flush

WP-CLI 与插件配合使用

不少插件支持 WP-CLI 指令,例如:

  • WooCommerce
    支持添加商品、更新订单等
    wp wc product create --name="新产品"
  • Yoast SEO
    构建索引库
    wp yoast index
  • WP Rocket / W3 Total Cache
    清理缓存
    wp rocket cleanwp w3-total-cache flush

安装好插件后,执行 wp help 可查看是否包含 CLI 支持。

开发者自定义 CLI 命令

插件开发者可在代码中添加如下片段注册命令:

if ( defined( 'WP_CLI' ) && WP_CLI ) {
    WP_CLI::add_command( 'myplugin', 'MyPlugin_CLI' );
}

class MyPlugin_CLI {
    public function hello( $args, $assoc_args ) {
        WP_CLI::success( "你好,WP-CLI!" );
    }
}

运行以下命令:

wp myplugin hello

终端中会显示提示:“你好,WP-CLI!”

常见问题

Q: 提示未找到 WordPress?

A: 进入包含 wp-config.php 的根目录,再运行命令。

Q: 权限不足?

A: 某些命令可能需要 sudo 权限,或调整文件夹权限。

Q: 能否远程操作?

A: 可通过 SSH 登录远程服务器,正常使用 WP-CLI 命令。

总结

WP-CLI 是 WordPress 的命令行工具,适合需要频繁管理、脚本处理或部署自动化的场景。它支持插件扩展,兼容大多数常见操作,是开发与管理过程中的高效助手。


了解 宝藏号 的更多信息

订阅后即可通过电子邮件收到最新文章。

© 版权声明

相关文章

暂无评论

none
暂无评论...

了解 宝藏号 的更多信息

立即订阅以继续阅读并访问完整档案。

继续阅读