GithubAcademyAPI ReferenceCommunity
Search…
v6.4.0 (stable)
Home
Concepts
Commerce
Framework
Extensions
API
Products
Editions
Plugins
Cloud
PWA
Guides
Installation
Installation overview
Dockware
Docker
Installation from scratch
Valet+
MAMP
Extensions
Hosting
Integrations / API
Resources
References
Guidelines
Tooling
Powered By GitBook
Valet+

Overview

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.

Prerequisites

You should have a look at our overview before proceeding with this guide. Also, your system should be running brew and composer already.

If you have Valet installed

Run composer remove laravel/valet.

Installing Valet-PHP

  1. 1.
    Update Homebrew via brew update
  2. 2.
    Add the Homebrew PHP tap for Valet+ via brew tap henkrehorst/php
  3. 3.
    Install PHP 7.4 using Homebrew via brew install [email protected]
  4. 4.
    Link your PHP version using the brew link [email protected] --force command

Installing Valet+

  1. 1.
    If needed, install composer via brew install composer
  2. 2.
    Install Valet+ via composer global require weprovide/valet-plus
  3. 3.
    Make sure ~/.composer/vendor/bin is in your path by adding export PATH="$PATH:$HOME/.composer/vendor/bin" to your bash_profile or .zshrc
  4. 4.
    Check for the following, common problem with valet fix. Warning: This will uninstall all other PHP installations
  5. 5.
    Run the valet install command. Optionally add --with-mariadb to 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

  1. 1.
    Create a new empty folder for example ~/sites
  2. 2.
    Clone the development template like you normally would (dev + platform) into this folder
  3. 3.
    Adjust params instalation editing .psh.yaml.dist
  4. 4.
    Run ./psh.phar install
  5. 5.
    Move to ~/sites and run valet park to 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 ~/sites
  6. 6.
    Optional: Disable SSL via valet unsecure because this might cause problems with the watcher

Troubleshooting

Testing your installation

  1. 1.
    Make sure ping something.test responds from 127.0.0.1.
  2. 2.
    Run nginx -t or sudo nginx -t and check for any errors.
    1. 1.
      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 protected] 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 valet install.

Missing Elasticsearch stub fix

1
sudo cp ~/.composer/vendor/weprovide/valet-plus/cli/stubs/elasticsearch.conf /usr/local/etc/nginx/valet/elasticsearch.conf
Copied!
1
valet domain test
Copied!

Watchers not working

Try disabling SSL via valet unsecure.

Next steps

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.
Previous
Installation from scratch
Next
MAMP
Last modified 3d ago
Copy link
Edit on GitHub
Contents
Overview
Prerequisites
If you have Valet installed
Installing Valet-PHP
Installing Valet+
Using Valet+ with Shopware 6
Troubleshooting
Testing your installation
Install Error: "The process has been signaled with signal 9"
Missing Elasticsearch stub fix
Watchers not working
Next steps