Title: Version 1.3.0 released
Author: Daniel Bachhuber
Published: August 8, 2017

---

 [  ](https://profiles.wordpress.org/danielbachhuber/) [Daniel Bachhuber](https://profiles.wordpress.org/danielbachhuber/)
4:16 pm _on_ August 8, 2017      

# Version 1.3.0 released

Happy release day! After 210 total merged pull requests, we’re excited to bring 
you WP-CLIWP-CLI WP-CLI is the Command Line Interface for WordPress, used to do 
administrative and development tasks in a programmatic way. The project page is 
[http://wp-cli.org/](http://wp-cli.org/) [https://make.wordpress.org/cli/](https://make.wordpress.org/cli/)
v1.3.0.

## Install packages with shortened identifiers

Recently, we have been [discussing the future of the WP-CLI package index](https://make.wordpress.org/cli/2017/07/05/how-should-we-embark-upon-new-feature-development/).
Our conclusion was to [deprecate the existing package index](https://make.wordpress.org/cli/2017/07/18/feature-development-discussion-recap/)
for now and provide a new mechanism for more easily installing external commands
that are hosted on GitHubGitHub GitHub is a website that offers online implementation
of git repositories that can easily be shared, copied and modified by other developers.
Public repositories are free to host, private repositories require a paid subscription.
GitHub introduced the concept of the ‘pull request’ where code changes done in branches
by contributors can be reviewed and discussed before being merged by the repository
owner. [https://github.com/](https://github.com/).

As of WP-CLI v1.3.0, whenever you provide a package identifier in the form of `<
vendor>/<package>`, WP-CLI will first check the deprecated package index (for backward
compatibility reasons), and then check for a GitHub repository that matches this
identifier. This also accepts all [version qualifiers/requirements that Composer can parse](https://getcomposer.org/doc/articles/versions.md).

Examples:

    ```
    # Install vendor/command from GitHub (uses https://github.com/vendor/command):
    $ wp package install vendor/command

    # Install version 1.0.5 of vendor/command:
    $ wp package install vendor/command:v1.0.5

    # Install commit 95ce52b of vendor/command:
    $ wp package install vendor/command:dev-master#95ce52b
    ```

## New commands

Wondering whether a specific string exists in your database? Wonder no more! Use
the new `wp db search` to search through all text columns in your database for your
specified string (or regex pattern) [[#29](https://github.com/wp-cli/db-command/pull/29),
[#33](https://github.com/wp-cli/db-command/pull/33)]:

    ```
    # Search through the database for the 'http://' regular expression, printing stats.
    $ wp db search 'http:\/\/' --regex --stats
    wp_comments:comment_author_url
    1:https://wordpress.org/
        ...
    Success: Found 99146 matches in 10.752s (10.559s searching). Searched 12 tables, 53 columns, 1358907 rows. 1 table skipped:
    wp_term_relationships.
    ```

Need easy access to the database prefix for chaining into other commands? Use `wp
db prefix` to print it out [[#22](https://github.com/wp-cli/db-command/pull/22)]:

    ```
    $ wp db prefix --url=example.com/foo
    wp_3_
    ```

## Everything else in v1.3.0

**Command improvements**

 * `wp config *`:
    - Errors early when no `wp-config.php` can be found [[#22](https://github.com/wp-cli/config-command/pull/22)].
 * `wp config create`:
    - Generates keys/salts locally and use WordPress.orgWordPress.org The community
      site where WordPress code is created and shared by the users. This is where
      you can download the source code for WordPress core, plugins and themes as
      well as the central location for community conversations and organization.
      [https://wordpress.org/](https://wordpress.org/) APIAPI An API or Application
      Programming Interface is a software intermediary that allows programs to interact
      with each other and share data in limited, clearly defined ways. as fallback[
      [#25](https://github.com/wp-cli/config-command/pull/25)].
 * `wp config get`:
    - Adds `--constant=<constant>` or `--global=<global>` to get the value of a 
      specific constant or global [[#16](https://github.com/wp-cli/config-command/pull/16)].
    - Indicates files included by `wp-config.php` [[#18](https://github.com/wp-cli/config-command/pull/18)].
 * `wp core (multisite-install|multisite-convert)`:
    - Use `--skip-config` to avoid addition of multisiteMultisite Multisite is a
      WordPress feature which allows users to create a network of sites on a single
      WordPress installation. Available since WordPress version 3.0, Multisite is
      a continuation of WPMU or WordPress Multiuser project. WordPress MultiUser
      project was discontinued and its features were included into WordPress core.
      [Advanced Administration Handbook -> Create A Network.](https://developer.wordpress.org/advanced-administration/multisite/create-network/)
      constants to `wp-config.php` file [[#18](https://github.com/wp-cli/core-command/pull/18)].
 * `wp import`:
    - Prevents non-existent directories from ending up in the list of files to import[
      [#8](https://github.com/wp-cli/import-command/pull/8)].
 * `wp media *`:
    - Changes media noun to ‘items’ in most cases, to reflect multi-type nature 
      of media [[#18](https://github.com/wp-cli/media-command/pull/18)].
 * `wp media import`:
    - Adds `--skip-copy` flag to allow import of media from local filesystem without
      moving on disk [[#21](https://github.com/wp-cli/media-command/pull/21)].
 * `wp package install`:
    - Adds support for short package identifiers [[#22](https://github.com/wp-cli/package-command/pull/22)].
 * `wp post term delete`:
    - Implements `--all` flag to remove all terms from a post [[#23](https://github.com/wp-cli/entity-command/pull/23)].
 * `wp scaffold *`:
    - Creates `phpcs.xml.dist` instead of custom-named `phpcs.ruleset.xml` [[#19](https://github.com/wp-cli/scaffold-command/pull/19)].
    - Better support for symbolic links [[#26](https://github.com/wp-cli/scaffold-command/pull/26)].
    - Changes the grunt config for `addtextdomain` to override all text domains 
      by default [[#28](https://github.com/wp-cli/scaffold-command/pull/28)].
 * `wp search-replace`:
    - Includes `--format=count` to only show number of rows affected [[#14](https://github.com/wp-cli/search-replace-command/pull/14)].
 * `wp term (get|update|delete)`:
    - Introduces `--by=<type>` argument to get/update/delete term by slug [[#27](https://github.com/wp-cli/entity-command/pull/27)].
 * `wp user *`:
    - Support fetching users with an email address in the login field [[#21](https://github.com/wp-cli/entity-command/pull/21)].
 * `wp super-admin remove`:
    - Allows revoking super-admin of non-existent user [[#6](https://github.com/wp-cli/super-admin-command/pull/6)].

**Framework enhancements**

 * Fixes autoload file names for `$custom_vendor` condition [[#4147](https://github.com/wp-cli/wp-cli/pull/4147)].
 * Saves runtime config so it can be passed as args to `Runner::run_alias_group()`
   invocation [[#4148](https://github.com/wp-cli/wp-cli/pull/4148)].
 * Manually loads comments if `opcache.save_comments` is disabled [[#4161](https://github.com/wp-cli/wp-cli/pull/4161)].
 * Allows numbers in subcommand names and arguments [[#4164](https://github.com/wp-cli/wp-cli/pull/4164),
   [#4269](https://github.com/wp-cli/wp-cli/pull/4269)].
 * Fixes double slash in `boot-phar.php` path [[#4169](https://github.com/wp-cli/wp-cli/pull/4169)].
 * Allows root use of `wp cli info`, in addition to `wp cli update` [[#4177](https://github.com/wp-cli/wp-cli/pull/4177)].
 * Updates SSHSSH Secure SHell - a protocol for securely connecting to a remote 
   system in addition to or in place of a password. URLURL A specific web address
   of a website or web page on the Internet, such as a website’s URL www.wordpress.
   org parser regexp to allow for null port number [[#4182](https://github.com/wp-cli/wp-cli/pull/4182)].
 * Add `WP_CLI\Utils\get_home_dir()` helper function [[#4184](https://github.com/wp-cli/wp-cli/pull/4184)].
 * Reduces included files (Behat/PHPUnit in particular) in built Phar [[#4185](https://github.com/wp-cli/wp-cli/pull/4185)].
 * Behat: Allows test DB user + pass to be set by environment variables [[#4196](https://github.com/wp-cli/wp-cli/pull/4196)].
 * Fixes output in JSONJSON JSON, or JavaScript Object Notation, is a minimal, readable
   format for structuring data. It is used primarily to transmit data between a 
   server and web application, as an alternative to XML. format in case of error
   while encoding [[#4199](https://github.com/wp-cli/wp-cli/pull/4199)].
 * Passes `WP_CLI_STRICT_ARGS_MODE` on to `--ssh=<ssh>` if set [[#4207](https://github.com/wp-cli/wp-cli/pull/4207)].
 * Displays a more helpful error message when site cannot be found [[#4212](https://github.com/wp-cli/wp-cli/pull/4212)].
 * Fixes broken indentation on Windows systems because of line endings [[#4221](https://github.com/wp-cli/wp-cli/pull/4221),
   [#4222](https://github.com/wp-cli/wp-cli/pull/4222)].
 * Adapts `--ssh=<ssh>` flag to work with Docker and Docker Compose [[#4240](https://github.com/wp-cli/wp-cli/pull/4240)].
 * Checks for availability of `proc_open/close` in various scenarios [[#4245](https://github.com/wp-cli/wp-cli/pull/4245)].

**Contributors to this release (45 total):** [aaemnnosttv](https://github.com/aaemnnosttv),
[BhargavBhandari90](https://github.com/BhargavBhandari90), [chetansatasiya](https://github.com/chetansatasiya),
[chriszarate](https://github.com/chriszarate), [cjhaas](https://github.com/cjhaas),
[colemanedwards](https://github.com/colemanedwards), [danielbachhuber](https://github.com/danielbachhuber),
[davetha](https://github.com/davetha), [drrobotnik](https://github.com/drrobotnik),
[electrokit](https://github.com/electrokit), [emgk](https://github.com/emgk), [emirpprime](https://github.com/emirpprime),
[erikjoling](https://github.com/erikjoling), [fjarrett](https://github.com/fjarrett),
[freegenie](https://github.com/freegenie), [gitlost](https://github.com/gitlost),
[greatislander](https://github.com/greatislander), [iansvo](https://github.com/iansvo),
[Ippey](https://github.com/Ippey), [jalavoy](https://github.com/jalavoy), [jameselks](https://github.com/jameselks),
[joehoyle](https://github.com/joehoyle), [johnbillion](https://github.com/johnbillion),
[@JPry](https://github.com/jpry), [junaidbhura](https://github.com/junaidbhura),
[kouratoras](https://github.com/kouratoras), [lucatume](https://github.com/lucatume),
[@mapk](https://github.com/mapk), [mikeschinkel](https://github.com/mikeschinkel),
[miya0001](https://github.com/miya0001), [@murtzsarialtun](https://github.com/murtzsarialtun)**,**
[nikolov-tmw](https://github.com/nikolov-tmw), [pierre-dargham](https://github.com/pierre-dargham),
[plastikdreams](https://github.com/plastikdreams), [rahul286](https://github.com/rahul286),
[ronaksampat](https://github.com/ronaksampat), [schlessera](https://github.com/schlessera),
[Sidsector9](https://github.com/Sidsector9), [soulseekah](https://github.com/soulseekah),
[szepeviktor](https://github.com/szepeviktor), [tfrommen](https://github.com/tfrommen),
[vbaranovskiy-plesk](https://github.com/vbaranovskiy-plesk), [westonruter](https://github.com/westonruter),
[wp-make-coffee](https://github.com/wp-make-coffee), [wpbullet](https://github.com/wpbullet)

### Share this:

 * [  Threads ](https://make.wordpress.org/cli/2017/08/08/version-1-3-0-released/?share=threads)
 * [  Mastodon ](https://make.wordpress.org/cli/2017/08/08/version-1-3-0-released/?share=mastodon)
 * [  Bluesky ](https://make.wordpress.org/cli/2017/08/08/version-1-3-0-released/?share=bluesky)
 * [  Facebook ](https://make.wordpress.org/cli/2017/08/08/version-1-3-0-released/?share=facebook)
 * [  X ](https://make.wordpress.org/cli/2017/08/08/version-1-3-0-released/?share=x)
 * [  LinkedIn ](https://make.wordpress.org/cli/2017/08/08/version-1-3-0-released/?share=linkedin)

 * [Login to Reply](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fcli%2F2017%2F08%2F08%2Fversion-1-3-0-released%2F%23respond&locale=en_US)

### Leave a Reply 󠀁[Cancel reply](https://make.wordpress.org/cli/2017/08/08/version-1-3-0-released/?output_format=md#respond)󠁿

You must be [logged in](https://login.wordpress.org/?redirect_to=https%3A%2F%2Fmake.wordpress.org%2Fcli%2F2017%2F08%2F08%2Fversion-1-3-0-released%2F&locale=en_US)
to post a comment.

# Post navigation

[← Good first issues for new contributors](https://make.wordpress.org/cli/2017/08/03/good-first-issues-for-new-contributors-3/)

[Free WP-CLI stickers for your event! →](https://make.wordpress.org/cli/2017/08/16/free-wp-cli-stickers-for-your-event/)