WP-CLI 技术文档

1. 安装指南

环境要求

在安装 WP-CLI 之前，请确保您的环境满足以下最低要求：

• UNIX-like 环境（OS X、Linux、FreeBSD、Cygwin）；Windows 环境支持有限。
• PHP 5.6 或更高版本。
• WordPress 3.7 或更高版本。较旧的 WordPress 版本可能功能受限。

安装步骤

1. 使用 wget 或 curl 下载 wp-cli.phar 文件：

   curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
   

2. 验证 wp-cli.phar 文件是否正常工作：

   php wp-cli.phar --info
   

3. 将 wp-cli.phar 文件设置为可执行，并将其移动到系统路径中：

   chmod +x wp-cli.phar
   sudo mv wp-cli.phar /usr/local/bin/wp
   

4. 验证安装是否成功：

   wp --info
   

更新 WP-CLI

您可以使用以下命令更新 WP-CLI：

wp cli update

如果 WP-CLI 由 root 或其他系统用户拥有，您需要使用 sudo：

sudo wp cli update

自动补全

WP-CLI 提供了 Bash 和 ZSH 的自动补全脚本。下载 wp-completion.bash 并将其添加到 ~/.bash_profile 中：

source /FULL/PATH/TO/wp-completion.bash

如果使用 ZSH，请在 .zshrc 中添加以下内容：

autoload bashcompinit
bashcompinit
source /FULL/PATH/TO/wp-completion.bash

2. 项目使用说明

WP-CLI 提供了命令行界面，用于执行许多在 WordPress 后台中可以执行的操作。例如，安装并激活插件：

wp plugin install user-switching --activate

删除所有 transients：

wp transient delete --all

更多使用示例和详细命令列表，请参考 WP-CLI 命令文档。

3. 项目 API 使用文档

WP-CLI 提供了丰富的命令行 API，涵盖了插件管理、主题管理、数据库操作等多个方面。以下是一些常用命令的示例：

• 插件管理：

  wp plugin install <plugin-name> --activate
  wp plugin update --all
  wp plugin delete <plugin-name>
  

• 主题管理：

  wp theme install <theme-name>
  wp theme activate <theme-name>
  wp theme delete <theme-name>
  

• 数据库操作：

  wp db export
  wp db import <filename>
  wp db search <search-string>
  

更多命令和详细参数，请参考 WP-CLI 命令文档。

4. 项目安装方式

WP-CLI 的推荐安装方式是下载 wp-cli.phar 文件。此外，您还可以通过以下方式安装：

• Composer：

  composer global require wp-cli/wp-cli-bundle
  

• Homebrew：

  brew install wp-cli
  

• Docker：

  docker pull wordpresscli/wordpress-cli
  

选择适合您环境的安装方式，并按照相应的步骤进行安装。