Valet+ is a fork of laravel/valet. It supports automatic virtual host configuration based on the folder structure.
This is a modified version of the official Installation Guide.
If you have Valet installed
composer remove laravel/valet.
- Update Homebrew via
- Add the Homebrew PHP tap for Valet+ via
brew tap henkrehorst/php
- Install PHP 7.4 using Homebrew via
brew install email@example.com
- Link your PHP version using the
brew link firstname.lastname@example.org --forcecommand
If needed, install composer via
brew install composer
Install Valet+ via
composer global require weprovide/valet-plus
~/.composer/vendor/binis in your path by adding
export PATH="$PATH:$HOME/.composer/vendor/bin"to your
Check for the following, common problem with
valet fix. Warning: This will uninstall all other PHP installations
valet installcommand. Optionally add
--with-mariadbto use MariaDB instead of MySQL. This will configure and install Valet+ and DnsMasq.
Additionally, it registers Valet's daemon to launch when your system starts.
Using Valet+ with Shopware 6
- Create a new empty folder for example
- Clone the development template like you normally would (dev + platform) into this folder
- Move to
valet parkto register valet for this directory. Shopware should now be accessible via the
folder-name.test. Notice: "folder-name" is the name of the Shopware development template in
- Optional: Disable SSL via
valet unsecurebecause this might cause problems with the watcher
Testing your installation
- Make sure
ping something.testresponds from 127.0.0.1.
sudo nginx -tand check for any errors.
- If there is a missing elastisearch file, follow "Missing Elasticsearch stub fix" further below
Install Error: "The process has been signaled with signal 9"
This is due to
valet fix uninstalling
email@example.com for some reason. You can fix it by reinstalling Valet-PHP (Step 3 + 4 of "Installing Valet-PHP"). Make sure to NOT run
valet fix afterwards and just proceed with
Missing Elasticsearch stub fix
sudo cp ~/.composer/vendor/weprovide/valet-plus/cli/stubs/elasticsearch.conf /usr/local/etc/nginx/valet/elasticsearch.conf
valet domain test
Watchers not working
Try disabing SSL via
Now, that you've got a running Shopware 6 instance, you could try to create your first plugin. Head over to our plugin base guide for more information.