{"id":159854,"date":"2016-10-17T13:00:01","date_gmt":"2016-10-17T13:00:01","guid":{"rendered":"https:\/\/premium.wpmudev.org\/blog\/?p=159854"},"modified":"2017-05-12T11:10:25","modified_gmt":"2017-05-12T11:10:25","slug":"advanced-wordpress-development-wordpress-wp-cli","status":"publish","type":"post","link":"https:\/\/wpmudev.com\/blog\/advanced-wordpress-development-wordpress-wp-cli\/","title":{"rendered":"Advanced WordPress Development: WordPress Automation With WP-CLI"},"content":{"rendered":"

Whether you’re a developer or an admin overseeing multiple WordPress sites, I’m sure you’ve thought to yourself: “I wish I could do this faster.” From creating a fresh install for testing to updating the same plugin on multiple sites, there are so<\/em> many tasks you’ll find yourself doing over and over again.<\/p>\n

WP-CLI<\/a> is the answer to your woes and one of my favorite time-saving tools for web development.<\/p>\n

This is the final post in our six-part series focusing on WordPress for advanced developers. This series follows on from our popular WordPress Development for Intermediate Users<\/a>, which introduced you to some meaty coding topics, including theme development in detail, making themes customizer-ready, building plugins, custom post types and taxonomies, queries and loops, custom fields and metadata, and localization.<\/p>\n

WP-CLI is a command-line utility (hence the CLI part) that gives you control over many aspects of WordPress. In this tutorial, I’ll show you how to use WP-CLI, how to create powerful bash scripts for even more powerful automation, and how to manage multiple WordPress sites at once.<\/p>\n

That’s a tall order; we’d better get started!<\/p>\n

Note: It\u2019s important that you have a working knowledge of PHP<\/a> as this is the foundational language of WordPress for this series, which covers advanced topics aimed at developers. I\u2019ll be referring to code snippets throughout this series.<\/em><\/p>\n

Installing WP-CLI<\/h2>\n

Installing WP-CLI is super-easy. Just issue the following commands, which can also be found on the WP-CLI home page:<\/p>\n

Loading gist 071f0d29a37a62f1d78ff09dda004383<\/a>

Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

Regretfully, Windows has limited support; you get the most mileage out of WP-CLI on Unix-like environments. You can find some additional notes on Windows installation in the documentation<\/a>. If you’re having trouble, use what we learned in the terminal tutorial and SSH<\/a> into a remote server, which is most likely to be a Unix environment, and practice there.<\/em> <\/strong><\/p>\n

Basic WP-CLI Usage<\/h2>\n

The use of WP-CLI is easy and intuitive once you’ve used a few commands. It always starts with the base wp<\/code> command, followed by one or more subcommands. Subcommands are used for grouping, which makes things logical. For example, here are commands to get and update a specific option in the database:<\/p>\n

Loading gist ef639adde53571f8e951511620f1e5a0<\/a>

Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

One of my favorite \u2013 and most frequently used \u2013 commands is search-replace<\/code>. This enables you to search-replace a term within the WordPress database. It handles serialized strings properly; unserializing them, making the replacement and then re-serializing them.<\/p>\n

Loading gist 0742cfb4e7151f170e2886a7dfdaa785<\/a>

Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

As you can see, using WP-CLI is not difficult. Take a look at the WP-CLI commands documentation<\/a>\u00a0for more information. I’ll be going through some more commands shortly, but first I want to show you some advanced setup and options.<\/p>\n

Global Parameters<\/h2>\n

WP-CLI has a bunch of global parameters that can be added to any command. You can read about them on any documentation page in the right-hand sidebar block. I’ll go through the most useful ones.<\/p>\n

–quiet<\/h3>\n

This parameter will suppress info messages that are normally displayed when executing a command. I use this when creating bash scripts that execute a bunch of WP-CLI commands at once. More on this later.<\/p>\n

–ssh<\/h3>\n

By adding this parameter, you can execute the WP-CLI command on a remote server instead of locally. This is what we’ll be using to control multiple WordPress instances by issuing local commands.<\/p>\n

–path<\/h3>\n

You can explicitly set the path of the WordPress installation. Normally, WP-CLI is run from within the root directory of the WP installation. If this isn’t the case, you can use --path<\/code> to tell WP-CLI where WP is.<\/p>\n

–prompt<\/h3>\n

This will prompt you to fill out all parameters. Useful if you don’t know the parameters off the top of your head or if you add WP-CLI as part of a larger script that others will use.<\/p>\n

–allow-root<\/h3>\n

Not a global parameter per se because it doesn’t apply to all commands, but I use it sometimes on remote servers where I must use sudo for some reason. If you use sudo, you must use this parameter to make sure WP-CLI performs this action. That said: try to avoid using sudo for commands when possible.<\/p>\n

Configuring WP-CLI<\/h2>\n

If you use these parameters a lot, you can set them in a configuration file. There are three configuration files that are parsed and used (if found) in the following order:<\/p>\n

    \n
  1. wp-cli.local.yml<\/code> inside the current directory or above<\/li>\n
  2. wp-cli.yml<\/code> inside the current directory or above<\/li>\n
  3. ~\/.wp-cli\/config.yml<\/code><\/li>\n<\/ol>\n

    Use the first two for project-specific configuration. The final file can be used to configure global options that you want to use on every project. The config file can also include defaults for sub-commands. Let’s look at an example:<\/p>\n

    Loading gist 8b4a39bb10b60921433727eef609c34e<\/a>

    Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

    Note how I’ve used the global parameters. There are a couple of global parameters like disabled_commands<\/code> which can not be set inline with commands; you must use the yml file.<\/p>\n

    I’ve added some defaults for the wp core config<\/code> command which sets up the wp-config.php<\/code> file. This is a setup I’d use for development; I’ve added my database username\/password and additional PHP constants to define which can be useful while developing.<\/p>\n

    Using SSH With WP-CLI to Automate WordPress Tasks<\/h2>\n

    As of version 0.24.0, WP-CLI natively supports SSH<\/a>. Previously you needed a third party command to get things done. WP-CLI has implemented SSH usage extremely efficiently. Let’s see how it works.<\/p>\n

    Let’s think like a WordPress agency that hosts websites for clients might think for a minute. Our websites all have a common “agency” plugin, which gives our users some useful information and a common control panel. We now have three client websites and a local test site, which we use to test the agency plugin. Let’s see how we can manage all of these sites at once.<\/p>\n

    Our first task is to make sure WP-CLI is available on all servers. Once that’s done, let’s go into the wp-cli.yml<\/code> file within the local WordPress installation.<\/p>\n

    Loading gist ad025c51329254ca241612ca81521bb9<\/a>

    Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

    I’ve added aliases for each website, followed by another alias that groups all websites together. I could update all plugins on all sites using the following command:<\/p>\n

    Loading gist 0fb8c9987d0f3c2fcda64aa1776e86b0<\/a>

    Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

    Just replace “@all” with the alias for a specific site to execute a command against that single site.<\/p>\n

    Further Automation With Bash Scripts<\/h2>\n

    Bash scripts are available in Unix environments and are like bat files in windows. I use them frequently to bundle together commands that can then be run at once using a single command.<\/p>\n

    BASH Scripts: The Basics<\/h3>\n

    Navigate to one directory above your WordPress root folder and create a file named test.sh<\/code>. Edit this file, adding the following content:<\/p>\n

    Loading gist 8512c55bd8bcdefa424f0bac8ae4fe4a<\/a>

    Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

    You should be familiar with both lines. The first one creates a directory named “test” and navigates into it. The second line downloads the core files needed for WordPress using WP-CLI.<\/p>\n

    To execute both commands at once simply run bash test.sh<\/code>.<\/p>\n

    Creating a New Installation<\/h3>\n

    When testing plugins and themes it’s always a good idea to see what happens using a fresh installation of WordPress. You might have already added some options that your product relies on but doesn’t check for \u2013 all sorts of things could go wrong.<\/p>\n

    Here’s a little script that you can use to create or remove-and-recreate a WordPress installation in a given folder:<\/p>\n

    Loading gist 0e5cea558cc4c888ceb32a65a3a0bda3<\/a>

    Please update your cookie preferences<\/a> to enable preference cookies to view this gist.<\/p><\/div><\/div>\n

    It takes one parameter: the name of the directory you want your WordPress installation in. If it doesn’t exist it creates the directory, goes into it and configures and installs WordPress. If it already exists it just resets the database and reinstalls WordPress.<\/p>\n

    You can run it using bash install.sh mydir<\/code>. Super simple and super helpful. You can add all the bells and whistles in there like adding PHP constants.<\/p>\n

    Streamlining Your Web Development Workflow With WP-CLI<\/h2>\n

    WP-CLI is a worthy addition to any WordPress power user’s toolbox. As a site manager, it allows you to perform common tasks across multiple sites. And as a developer, it provides you with automation tools to lessen your workload.<\/p>\n

    When combined with bash scripts it becomes even more powerful allowing you to define your own workflow, creating shortcuts that can shave hours off your day.<\/p>\n","protected":false},"excerpt":{"rendered":"

    Whether you’re a developer or an admin overseeing multiple WordPress sites, I’m sure you’ve thought to yourself: “I wish I could do this faster.” From creating a fresh install for testing to updating the same plugin on multiple sites, there are so many tasks you’ll find yourself doing over and over again. WP-CLI is the […]<\/p>\n","protected":false},"author":344049,"featured_media":159985,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"blog_reading_time":"","wds_primary_category":0,"wds_primary_tutorials_categories":0,"footnotes":""},"categories":[557,263],"tags":[9770,10189],"tutorials_categories":[],"class_list":["post-159854","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-development","category-tutorials","tag-development-2","tag-wp-cli"],"_links":{"self":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/159854","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/users\/344049"}],"replies":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/comments?post=159854"}],"version-history":[{"count":12,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/159854\/revisions"}],"predecessor-version":[{"id":198611,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/posts\/159854\/revisions\/198611"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/media\/159985"}],"wp:attachment":[{"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/media?parent=159854"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/categories?post=159854"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/tags?post=159854"},{"taxonomy":"tutorials_categories","embeddable":true,"href":"https:\/\/wpmudev.com\/blog\/wp-json\/wp\/v2\/tutorials_categories?post=159854"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}