README

提供快速安装服务的白手套服务。

使用

此包实现了以下命令

wp valet new

快速创建一个新的WordPress安装

wp valet new <name> [--project=<project>] [--in=<dir>] [--version=<version>] [--locale=<locale>] [--db=<db>] [--dbname=<dbname>] [--dbuser=<dbuser>] [--dbpass=<dbpass>] [--dbhost=<dbhost>] [--dbprefix=<dbprefix>] [--admin_user=<username>] [--admin_password=<password>] [--admin_email=<email>] [--unsecure] [--portable]

此命令将启动一个新的WordPress安装 - 包括数据库和https 准备在浏览器中使用，比穿上裤子还快。

注意如果你没有在运行的安装目录或父目录中使用 valet park，你需要执行一个 valet link 来确保网站运行时不会遇到404错误。

选项

<name>
	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=<project>]
	The WordPress project to install. Choose from any project supported by Laravel Valet.
	---
	default: wp
	options:
	  - wp
	  - bedrock
	---

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

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

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

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

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

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

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

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

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

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

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

[--admin_email=<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 <name> [--yes]

这将删除数据库，删除所有文件，以及删除为通过https提供此安装而生成的任何自签名TLS证书。

选项

<name>
	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.

安装

此命令利用 Laravel Valet - 一个针对Mac + *nix极简主义者开源的开发环境。

它运行各种命令非常快，允许你在创建网站后立即在浏览器中启动它，无需其他配置，只需一个命令即可。

您还应该了解Valet的工作原理，特别是关于服务网站的部分。

环境设置

MacOS用户应首先安装 Homebrew。
按照Laravel文档中的 Valet安装说明开始。

注意：Linux用户应使用 Valet-linux，它是原始项目的分支，与这个 wp-cli 插件的 valet 命令共享大部分功能。

通过运行 wp cli info 来确认您的 wp-cli 环境正常工作并满足以下最低版本要求，如果输出类似于以下内容，请继续操作：

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

如有必要，使用 wp cli update 更新到最新稳定版本。

加载 wp-cli-valet-command 包

安装此包需要WP-CLI v1 || v2或更高版本。使用 wp cli update 更新到最新稳定版本。

完成此操作后，您可以使用以下命令安装此包的最新稳定版本：

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

要安装此包的最新开发版本，请使用以下命令代替：

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

故障排除

错误：ERROR 1045 (28000)：用户 'root'@'localhost' 没有访问权限 安装程序在数据库创建阶段停止，因为它没有您的本地 MySQL 实例的密码。

通过将您的 wp valet 命令附加如下来防止这种情况： wp valet new site --dbpass=local_root_password。

此时，您可以

手动创建一个 wp-config.php 文件，
使用wp config命令让wp-cli为您创建，或者
使用wp valet destroy site并再次尝试运行您的wp valet new命令，这次使用--dbpass属性。

配置备用默认值

与其他wp-cli命令一样，在运行wp valet时可以设置默认属性。

只需在~/.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

以下以示例形式显示了wp valet new的默认值，以便于理解。

对config.yml的一个简单使用方法可以是

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

启用wp valet new site在~3秒内启动一个完整、实时、运行中的本地WordPress网站，无需任何附加参数。

支持

GitHub问题不是用于一般支持问题的地方，但您可以尝试其他方式：https://wp-cli.org/#support

贡献

我们感谢您积极为这个项目做出贡献。

贡献不仅限于代码。我们鼓励您以最适合您能力的方式做出贡献，例如编写教程、在当地的聚会中演示、帮助其他用户解决支持问题或修订我们的文档。

要了解更多信息，请查看WP-CLI的贡献指南。此包遵循这些政策和指南。

报告一个错误

认为您已经发现了一个错误？我们希望您能帮助我们将其修复。

在您创建新的问题之前，您应该搜索现有问题，看看是否有现有的解决方案，或者它是否已经在新版本中修复。

在您进行了一些搜索并发现没有开放或修复的问题与您的错误相关之后，请创建一个新的问题。尽可能提供详细信息，并在可能的情况下提供清晰的复现步骤。有关更多指导，请查阅我们的错误报告文档。

创建一个pull request

想贡献一个新功能？请首先打开一个新的问题，讨论该功能是否适合本项目。

一旦您决定投入时间来实施您的pull request，请遵循我们创建pull request的指南，以确保它是一个愉快的体验。有关在本地处理此包的详细信息，请参阅"设置"。

此README.md文件是使用wp scaffold package-readme（文档）从项目的代码库动态生成的。要建议更改，请提交对代码库对应部分的pull request。

aaemnnosttv / wp-cli-valet-command

维护者

详情