Valet+ is a development environment for macOS. No Vagrant, no Docker, no /etc/hosts
file. This project uses
laravel/valet as a dependency.
⚠️ Valet+ requires macOS and Homebrew. Before installation, you should make sure that no other programs such as Apache or Nginx are binding to your local machine's port 80.
⚠️ Valet+ requires Composer to be installed.
To get started, you first need to ensure that Homebrew is up-to-date using the update command:
brew update
Next, you should use Homebrew to install PHP 8.1 (using shivammathur/php
):
brew tap shivammathur/php
brew install shivammathur/php/[email protected]
brew link [email protected] --force
brew services restart [email protected]
Install Valet+ 3.x-dev with composer:
composer global require weprovide/valet-plus:3.x-dev
Finally, you may execute the Valet+ install
command. This will configure and install Valet+, Nginx, DnsMasq and other
services. In addition, use --help
to see all installation options.
valet-plus install
The daemons Valet+ depends on will be configured to launch when your system starts. Once Valet+ is installed, try pinging
any *.test
domain on your terminal using a command such as ping foobar.test
. If Valet+ is installed correctly you
should see this domain responding on 127.0.0.1
.
Here are a few key differences compared to the original Valet:
- Nginx config optimization
- PHP extensions (
mcrypt,intl,opcache, yaml, apcu, ds, imagick) - MySQL ([email protected], [email protected], [email protected], mariadb)
- DB commands (list, create, drop, reset, (re)import, export,
open)
- DB commands (list, create, drop, reset, (re)import, export,
- Mailhog (on/off mode)
- Varnish (on/off mode)
- Redis (on/off mode)
- Rabbitmq (on/off mode)
- Xdebug (on/off mode)
- Memcache (on/off mode)
- Elasticsearch v6, v7, v8 (on/off mode) using Docker
- Opensearch (on/off mode)
Ioncube- Rewrite/unrewrite public domain to local environment
DevTools- Binaries (magerun, magerun2, drush, wp-cli)
- Use command
valet-plus
instead ofvalet
. - Rename
.env.valet
to.valet-env.php
. - Use command
valet-plus elasticsearch|es use <version>
instead ofvalet-plus use elasticsearch|es <version>
. - Use
127.0.0.1
as Redis host instead of/tmp/redis.sock
. - Choose which binaries to install (default all) and self-update on
valet-plus install
command. - Adds dependency on Docker for Elasticsearch, see https://docs.docker.com/desktop/install/mac-install/
- Mischa Braam (@mischabraam)
- Tim Neutkens (@timneutkens)
- Sam Granger (@samgranger)
- Lou van der Laarse (@Neodork)
We have a slack workspace available which you can join.
Yes, we have a Valet+ fan page https://www.weprovide.com/valet-plus