PHPackages                             aaemnnosttv/wp-cli-valet-command - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [CLI & Console](/categories/cli)
4. /
5. aaemnnosttv/wp-cli-valet-command

ActiveWp-cli-package[CLI & Console](/categories/cli)

aaemnnosttv/wp-cli-valet-command
================================

White-glove services for turn-key installs in seconds.

v1.3.1(1y ago)3142.4k31[6 issues](https://github.com/aaemnnosttv/wp-cli-valet-command/issues)[3 PRs](https://github.com/aaemnnosttv/wp-cli-valet-command/pulls)MITPHPPHP >=5.5CI failing

Since Sep 20Pushed 2mo ago14 watchersCompare

[ Source](https://github.com/aaemnnosttv/wp-cli-valet-command)[ Packagist](https://packagist.org/packages/aaemnnosttv/wp-cli-valet-command)[ Docs](https://aaemnnost.tv/wp-cli-commands/valet/)[ RSS](/packages/aaemnnosttv-wp-cli-valet-command/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (6)Dependencies (14)Versions (10)Used By (0)

aaemnnosttv/wp-cli-valet-command
================================

[](#aaemnnosttvwp-cli-valet-command)

White-glove services for turn-key installs in seconds.

[![Packagist](https://camo.githubusercontent.com/04ee1afc839525ed03016407ab2481937056c80491772a82d120874908c41d57/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6161656d6e6e6f737474762f77702d636c692d76616c65742d636f6d6d616e642e737667)](https://packagist.org/packages/aaemnnosttv/wp-cli-valet-command)

Quick links: [Using](#using) | [Installing](#installing) | [Troubleshooting](#troubleshooting) | [Support](#support) | [Contributing](#contributing)

Using
-----

[](#using)

This package implements the following commands:

### wp valet new

[](#wp-valet-new)

Create a new WordPress install -- fast

```
wp valet new  [--project=] [--in=] [--version=] [--locale=] [--db=] [--dbname=] [--dbuser=] [--dbpass=] [--dbhost=] [--dbprefix=] [--admin_user=] [--admin_password=] [--admin_email=] [--unsecure] [--portable]

```

This command will spin up a new WordPress installation -- complete with database and https *ready-to-use in your browser* faster than you can put your pants on.

**NB** If you have not used `valet park` for the directory or parent directory you are running the installation in you need to do a `valet link` to make sure the site will run without running into 404s.

**OPTIONS**

```

	Site domain name without TLD. This will become the directory name of the project root.
	Eg: To create an install for example.dev, `wp valet new example`

[--project=]
	The WordPress project to install. Choose from any project supported by Laravel Valet.
	---
	default: wp
	options:
	  - wp
	  - bedrock
	---

[--in=]
	Specify the path to the parent directory to create the install in.
	Defaults to the current working directory.

[--version=]
	WordPress version to install.
	---
	default: latest
	---

[--locale=]
	Select which language you want to install.

[--db=]
	Database driver to provision the site with.
	---
	default: mysql
	options:
	  - mysql
	  - sqlite
	---

[--dbname=]
	Database name (MySQL only).
	Defaults to 'wp_'.

[--dbuser=]
	Database User (MySQL only).
	---
	default: root
	---

[--dbpass=]
	Set the database user password (MySQL only).
	---
	Default: ''
	---

[--dbhost=]
	Set the database host.
	---
	default: localhost
	---

[--dbprefix=]
	Set the database table prefix.
	---
	default: 'wp_'
	---

[--admin_user=]
	The username to create for the WordPress admin user.
	---
	default: admin
	---

[--admin_password=]
	The password to create for the WordPress admin user.
	---
	default: admin
	---

[--admin_email=]
	The email to use for the WordPress admin user.

[--unsecure]
	Provision the site for http rather than https.

[--portable]
	Provision the site to be portable. Implies --unsecure and --db=sqlite.

```

### wp valet destroy

[](#wp-valet-destroy)

Completely remove an installation.

```
wp valet destroy  [--yes]

```

This will drop the database, and delete all of the files as well as remove any self-signed TLS certificate that was generated for serving this install over https.

**OPTIONS**

```

	Site domain name without TLD. It should match the directory name of the project root.

[--yes]
	Pre-approve the confirmation to delete all files and drop the database.

```

Installing
----------

[](#installing)

This command leverages [Laravel Valet](https://laravel.com/docs/valet) -- an open source development environment for Mac + \*nix minimalists.

It runs various commands lightning fast, allowing you to spin up a site in your browser immediately after creating it, without any other configuration, all from a single command.

You should also understand how Valet works, especially the portion on [Serving Sites](https://laravel.com/docs/5.2/valet#serving-sites).

#### Environment Setup

[](#environment-setup)

1. MacOS users should install [Homebrew](https://brew.sh/) first.
2. Follow the [Valet installation instructions](https://laravel.com/docs/valet#installation) on the Laravel documentation to get started.

> *Note: Linux users should use [Valet-linux](https://github.com/cpriego/valet-linux) instead, a fork of the original project that shares most of the same `valet` commands powering this `wp-cli` plugin.*

2. Confirm your `wp-cli` environment works and meets the minimum version specified below by running `wp cli info` and proceed if the output looks something like:

```
PHP binary:	/usr/bin/php7.0
PHP version:	7.0.22-0ubuntu0.16.04.1
php.ini used:	/etc/php/7.0/cli/php.ini
WP-CLI root dir:	phar://wp-cli.phar
WP-CLI vendor dir:	phar://wp-cli.phar/vendor
WP_CLI phar path:	/home/user/wp-cli-valet-command
WP-CLI packages dir:	/home/user/.wp-cli/packages/
WP-CLI global config:	/home/user/.wp-cli/config.yml
WP-CLI project config:
WP-CLI version:	1.4.1

```

Update, if needed, to the latest stable release with `wp cli update`.

#### Loading the wp-cli-valet-command package

[](#loading-the-wp-cli-valet-command-package)

Installing this package requires WP-CLI v1 || v2 or greater. Update to the latest stable release with `wp cli update`.

Once you've done so, you can install the latest stable version of this package with:

```
wp package install aaemnnosttv/wp-cli-valet-command:@stable
```

To install the latest development version of this package, use the following command instead:

```
wp package install aaemnnosttv/wp-cli-valet-command:dev-master
```

Troubleshooting
---------------

[](#troubleshooting)

`Error: ERROR 1045 (28000): Access denied for user 'root'@'localhost'`The installer halts at the database creation stage because it doesn't have a password for your local `MySQL` instance.

Prevent this from happening by appending your `wp valet` commands like such: `wp valet new site --dbpass=local_root_password`.

At this point, you can:

1. Either create a `wp-config.php` file manually,
2. use `wp config`command to have wp-cli create one for you, or
3. use `wp valet destroy site` and try running your `wp valet new` command again, this time using the `--dbpass` attribute.

### Configuring Alternate Defaults

[](#configuring-alternate-defaults)

As with other `wp-cli` commands, you can set default attributes when running `wp valet`.

Simply add the appropriate details in `~/.wp-cli/config.yml`:

```
valet new:
  ## Uncomment or update the relevant lines when necessary to set your own defaults.
  project: wp # or bedrock
  # in: # override - defaults to current directory
  version: latest
  # locale:  # use if not English
  db: mysql # or sqlite
  # dbname: # defaults to wp_name
  dbuser: root # or any other local user capable of creating databases (MySQL only)
  # dbpass: # enter the appropriate password if necessary (MySQL only)
  dbprefix: wp_
  admin_user: admin
  admin_password: admin
  ## Boolean options can also be configured, too.
  # unsecure: false # set to true to override
  # portable: false # set to true to override
```

The `wp valet new` defaults are shown here as an example for clarity.

One simple usage for the `config.yml` could look like

```
valet new:
  dbuser: root # or any db creating user
  dbpass: password # set yours here
```

to enable `wp valet new site` to spin up a full, live, running local WordPress site in ~3 seconds without any additional parameters.

Support
-------

[](#support)

GitHub issues aren't for general support questions, but there are other venues you can try:

Contributing
------------

[](#contributing)

We appreciate you taking the initiative to contribute to this project.

Contributing isn’t limited to just code. We encourage you to contribute in the way that best fits your abilities, by writing tutorials, giving a demo at your local meetup, helping other users with their support questions, or revising our documentation.

For a more thorough introduction, [check out WP-CLI's guide to contributing](https://make.wordpress.org/cli/handbook/contributing/). This package follows those policy and guidelines.

### Reporting a bug

[](#reporting-a-bug)

Think you’ve found a bug? We’d love for you to help us get it fixed.

Before you create a new issue, you should [search existing issues](https://github.com/aaemnnosttv/wp-cli-valet-command/issues?q=label%3Abug%20) to see if there’s an existing resolution to it, or if it’s already been fixed in a newer version.

Once you’ve done a bit of searching and discovered there isn’t an open or fixed issue for your bug, please [create a new issue](https://github.com/aaemnnosttv/wp-cli-valet-command/issues/new). Include as much detail as you can, and clear steps to reproduce if possible. For more guidance, [review our bug report documentation](https://make.wordpress.org/cli/handbook/bug-reports/).

### Creating a pull request

[](#creating-a-pull-request)

Want to contribute a new feature? Please first [open a new issue](https://github.com/aaemnnosttv/wp-cli-valet-command/issues/new) to discuss whether the feature is a good fit for the project.

Once you've decided to commit the time to seeing your pull request through, [please follow our guidelines for creating a pull request](https://make.wordpress.org/cli/handbook/pull-requests/) to make sure it's a pleasant experience. See "[Setting up](https://make.wordpress.org/cli/handbook/pull-requests/#setting-up)" for details specific to working on this package locally.

*This README.md is generated dynamically from the project's codebase using `wp scaffold package-readme` ([doc](https://github.com/wp-cli/scaffold-package-command#wp-scaffold-package-readme)). To suggest changes, please submit a pull request against the corresponding part of the codebase.*

###  Health Score

50

—

FairBetter than 96% of packages

Maintenance63

Regular maintenance activity

Popularity38

Limited adoption so far

Community22

Small or concentrated contributor base

Maturity64

Established project with proven stability

 Bus Factor1

Top contributor holds 95.6% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~572 days

Recently: every ~712 days

Total

6

Last Release

666d ago

PHP version history (2 changes)v1.0.0PHP ^5.5|^7.0

v1.2.0PHP >=5.5

### Community

Maintainers

![](https://www.gravatar.com/avatar/b443f89936449a1c048fcc223ea03b285a4e9c9667ffd21c0c4b3f33e46f72c9?d=identicon)[aaemnnosttv](/maintainers/aaemnnosttv)

---

Top Contributors

[![aaemnnosttv](https://avatars.githubusercontent.com/u/1621608?v=4)](https://github.com/aaemnnosttv "aaemnnosttv (172 commits)")[![postphotos](https://avatars.githubusercontent.com/u/963672?v=4)](https://github.com/postphotos "postphotos (4 commits)")[![jasperf](https://avatars.githubusercontent.com/u/344138?v=4)](https://github.com/jasperf "jasperf (2 commits)")[![danielbachhuber](https://avatars.githubusercontent.com/u/36432?v=4)](https://github.com/danielbachhuber "danielbachhuber (1 commits)")[![johavik](https://avatars.githubusercontent.com/u/2488437?v=4)](https://github.com/johavik "johavik (1 commits)")

---

Tags

laravelwordpresszondavalet

### Embed Badge

![Health badge](/badges/aaemnnosttv-wp-cli-valet-command/health.svg)

```
[![Health](https://phpackages.com/badges/aaemnnosttv-wp-cli-valet-command/health.svg)](https://phpackages.com/packages/aaemnnosttv-wp-cli-valet-command)
```

###  Alternatives

[wp-cli/wp-cli-bundle

WP-CLI bundle package with default commands.

896.3M131](/packages/wp-cli-wp-cli-bundle)[cpriego/valet-linux

A more enjoyable local development experience for Linux.

1.5k135.9k](/packages/cpriego-valet-linux)[wp-cli/wp-cli-tests

WP-CLI testing framework

422.7M87](/packages/wp-cli-wp-cli-tests)[genesisweb/valet-linux-plus

Advanced local development experience for Linux.

18215.3k](/packages/genesisweb-valet-linux-plus)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)