Varying Vagrant Vagrants logo Varying Vagrant Vagrants

WP-CLI is the command-line interface for WordPress. You can update plugins, configure multisite installations and much more, without using a web browser.

With this tool it is possible to manage the websites installed, like changing the password of users or exporting the database. This tool is used inside VVV from the default provisioners and internals and is very powerful.

VVV includes the nightly version of WP-CLI, but if you want to contribute to WP CLI development, you can install the wpcli-dev utility.

Examples

wp db import ~/db-export.sql # VVV automatically generated database bbackups on halt
wp search-replace http://olddomain.com https://newdomain.com --export=newdb.sql --all-tables # Generate a dump with the url replaced
wp media regenerate # Regenerate all the thumbnails and the various images
wp post generate --count=10 # Create posts with dummy content

Contribute to WP-CLI

VVV include a utility to install the official dev environment with all the various repositories from https://github.com/wp-cli/wp-cli-dev/. To use this new instance replace wp with wp-dev.

To use this, SSH into the virtual machine with vagrant ssh.

From the WP-CLI dev folder it is possible to run the unit tests of the various commands:

Unit test

composer behat # all the unit tests of a command
composer behat -- ./features/yourtest.feature # for a specific test

WP-CLI has exhaustive documentation on how to utilize and on how to contribute.

We recommend adding a new git remote to the repository, so that you can push changes to GitHub for pull requests.

Resources

There are already a lot of guides about WP CLI: