WP-CLI 是一款用于管理 WordPress 的命令行交互界面,无需浏览器即可完成插件更新,可以数据库备份创建、插件和主题的安装和删除、发布和删除帖子、更改站点的URL设置、执行升级、可以生成备份、可以发布新帖子、多站点设置、并且可以使用一组命令来执行大多数常规管理操作。
注意,WP-CLI需要SSH访问,对于虚拟机有插件支持。
安装
在安装 WP-CLI 之前,请确保您的操作环境满足最低要求:
- UNIX 环境(OS X,Linux,FreeBSD,Cygwin),某些功能在 Windows 中将受到限制。
- PHP 5.4 或更高版本。
- WordPress 3.7 或更高版本,较旧版本在功能上可能会有所减少。
再次检查操作环境,使用 wget
或 curl
下载 wp-cli.phar:
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
接下来,检查 Phar 文件确保其正常运行:
php wp-cli.phar --info
要使用 wp
执行 WP-CLI 命令,必须有执行权限并且 PATH
已在环境变量中注册,例如:
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
如果 WP-CLI 安装成功,使用 wp --info
命令,将看到以下输出信息:
$ wp --info
OS: Darwin 16.7.0 Darwin Kernel Version 16.7.0: Thu Jan 11 22:59:40 PST 2018; root:xnu-3789.73.8~1/RELEASE_X86_64 x86_64
Shell: /bin/zsh
PHP binary: /usr/local/bin/php
PHP version: 7.0.22
php.ini used: /etc/local/etc/php/7.0/php.ini
WP-CLI root dir: /home/wp-cli/.wp-cli/vendor/wp-cli/wp-cli
WP-CLI vendor dir: /home/wp-cli/.wp-cli/vendor
WP-CLI packages dir: /home/wp-cli/.wp-cli/packages/
WP-CLI global config: /home/wp-cli/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version: 2.4.0
更新 WP-CLI
如果需要更新 WP-CLI ,可以运行 wp cli update
(说明文档)或者重复上述安装方法。
如果 WP-CLI 的所有者是 root 或其他系统管理员,则需要执行 sudo wp cli update
操作。
如果您想体验最新版本,可以运行 wp cli update --nightly
来安装最新的 Nightly Builds 版本(每天更新的版本,不要用到生产环境) WP-CLI 工具。该版本在开发环境中有一定的稳定性,并且始终包含最新和最出色的 WP-CLI 功能。
使用
WP-CLI 可以为您在 WordPress 后台管理中执行的许多操作提供命令行工具。例如,使用 wp plugin install --activate
(说明文档)安装并激活插件:
$ wp plugin install user-switching --activate
Installing User Switching (1.0.9)
Downloading installation package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
Activating 'user-switching'...
Plugin 'user-switching' activated.
Success: Installed 1 of 1 plugins.
WP-CLI 还包含许多您无法在 WordPress 后台管理中执行的操作命令。例如,wp transient delete --all
(说明文档)可以删除一个或所有的 Transients :
$ wp transient delete --all
Success: 34 transients deleted from the database.
有关如何使用 WP-CLI 的更多内容请阅读《Quick Start》。您也可以在 Shell Friends 了解实用的命令行工具。
如果您已经熟悉基本命令,可以到 WP-CLI Commands 了解更多有关主题及插件管理、数据导入与导出和数据库操作的内容。
需要注意的是不建议使用root用户直接操作,因为不安全。但是如果非要使用的话也可以,在命令上添加--allow-root
即可。
演示
例如,因为您可以从WordPress管理员安装插件,所以也可以使用WP-CLI 安装插件:
$ wp plugin install akismet
Installing Akismet (3.1.8)
Downloading install package from https://downloads.wordpress.org/plugin/akismet.3.1.8.zip...
Unpacking the package...
Installing the plugin...
Plugin installed successfully.
并且,因为您还可以从WordPress管理员激活插件,所以可以使用WP-CLI 激活插件:
$ wp plugin activate akismet
Success: Plugin 'akismet' activated.
使用wp core download
(doc)下载最新版本的WordPress 。
$ wp core download --path=wpclidemo.dev
Creating directory '/srv/www/wpclidemo.dev/'.
Downloading WordPress 4.6.1 (en_US)...
Using cached file '/home/vagrant/.wp-cli/cache/core/wordpress-4.6.1-en_US.tar.gz'...
Success: WordPress downloaded.
使用wp core install
(doc)安装WordPress 。
$ wp core install --url=wpclidemo.dev --title="WP-CLI" --admin_user=wpcli --admin_password=wpcli --admin_email=info@wp-cli.org
Success: WordPress installed successfully.
将插件更新到最新版本
使用wp plugin update --all
(doc)将所有插件更新为最新版本。
$ wp plugin update --all
Enabling Maintenance mode...
Downloading update from https://downloads.wordpress.org/plugin/akismet.3.1.11.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the plugin...
Plugin updated successfully.
Downloading update from https://downloads.wordpress.org/plugin/nginx-champuru.3.2.0.zip...
Unpacking the update...
Installing the latest version...
Removing the old version of the plugin...
Plugin updated successfully.
Disabling Maintenance mode...
Success: Updated 2/2 plugins.
+------------------------+-------------+-------------+---------+
| name | old_version | new_version | status |
+------------------------+-------------+-------------+---------+
| akismet | 3.1.3 | 3.1.11 | Updated |
| nginx-cache-controller | 3.1.1 | 3.2.0 | Updated |
+------------------------+-------------+-------------+---------+
将用户添加为超级管理员
在多站点上,使用wp super-admin add
(doc)将超级管理员功能授予现有用户。
$ wp super-admin add wpcli
Success: Granted super-admin capabilities.
重新产生缩图
如果您已添加或更改了向注册的图像尺寸add_image_size()
,则可能需要使用wp media regenerate
(doc),以便您的主题显示正确的图像尺寸。
wp media regenerate --yes
Found 1 image to regenerate.
1/1 Regenerated thumbnails for "charlie-gpa" (ID 4).
Success: Finished regenerating the image.
想查看更多命令,浏览WP-CLI的所有命令库。
官方文档:WP-CLI
使用命令,备份很重要。