Continuous maintenance is made possible by:
The current stable version is 2.5.0. To stay up to date, follow @wpcli on Twitter or sign up for email updates. See the roadmap for an overview of what’s planned for upcoming releases.
WP-CLI provides a command line interface for many actions you can perform on the WordPress desktop. For example, wp plugin install –activate (doc) allows you to install and activate a WordPress plugin:
$ wp plugin install user-switching –activate Installing
User Switching (1.0.9) Downloading install package from https://downloads.wordpress.org/plugin/user-switching.1.0.9.zip… Unpacking the package… Installing the plugin…
The plugin was installed successfully. Activating ‘user-switching’… Plugin ‘user-switching’ activated. Success: Installed 1 of 1 plugin.
WP-CLI also includes commands for many things you can’t do on the WordPress desktop. For example, wp transient delete –all (doc) allows you to delete one or all transient data:
$ wp transient delete –all
Success: 34 transients deleted from the database.
Already comfortable with the basics? Go to the full list of commands for detailed information on managing themes and plugins, importing and exporting data, performing database search and replace operations, and more.
Downloading the Phar archive is our recommended installation method for most users. If needed, see also our documentation about alternative installation methods (Composer, Homebrew, Docker).
Before installing WP-CLI, make sure that your environment meets the minimum requirements:
- UNIX-like environment (OS X, Linux, FreeBSD, Cygwin); limited support in Windows environment
- PHP 5.6 or later
- WordPress 3.7 or later. Versions prior to the latest version of WordPress may have degraded functionality.
Once you have verified the requirements, download the wp-cli.phar file using wget or curl :
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar
Next, check the Phar archive to verify that it is working:
php wp-cli.phar –info
To use WP-CLI from the command line by typing wp, make the file executable and move it somewhere in your PATH. For example:
chmod +x wp-cli.phar
sudo mv wp-cli.phar /usr/local/bin/wp
If WP-CLI was installed correctly, you should see something like this when you run: wp –info:
$ wp –info
OS: Linux 4.19.128-microsoft-standard #1 SMP Tue Jun 23 12:58:10 UTC 2020 x86_64
PHP binary: /usr/bin/php
PHP version: 8.0.5
php.ini used: /etc/php/8.0/cli/php.ini
MySQL binary: /usr/bin/mysql
MySQL version: mysql Ver 8.0.23-0ubuntu0.20.04.1 for Linux on x86_64 ((Ubuntu))
SQL modes: WP-CLI
root dir: /home/wp-cli/ WP-CLI
vendor dir: /home/wp-cli/vendor
WP_CLI phar path: WP-CLI packages
dir: /home/wp-cli/.wp-cli/packages/ WP-CLI
global config: WP-CLI project config: /home/wp-cli/wp-cli.yml WP-CLI version: 2.5.0
You can update WP-CLI with wp cli update (doc), or by repeating the installation steps.
If WP-CLI is owned by root or another system user, you will need to run sudo wp cli update.
Want to live life on the edge? Run wp cli update –nightly to use the latest nightly build of WP-CLI. A nightly build is more or less stable enough for you to use in your development environment and always includes the latest and greatest WP-CLI features.
Autocomplete with the tab key
WP-CLI also comes with an autocompletion script with the tabulator for Bash and ZSH. Just download wp-completion.bash and use the source command from ~/.bash_profile:
Don’t forget to run source ~/.bash_profile afterward.
If you use the zsh shell, you may need to load and start bashcompinit before using the source command. Put the following in your .zshrc:
bashcompinit source /RUTA/COMPLETA/HASTA/wp-completion.bash