Skip to content

Latest commit

 

History

History
87 lines (62 loc) · 3.49 KB

README.MD

File metadata and controls

87 lines (62 loc) · 3.49 KB
Raw

Latest Version on Packagist Downloads on Packagist

Introduction

Valet+ is a development environment for macOS. No Vagrant, no Docker, no /etc/hosts file. This project uses laravel/valet as a dependency.

Installation

⚠️ 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.

Valet+ features

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)
  • 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 v2 (on/off mode) using Docker
  • Ioncube
  • Rewrite/unrewrite public domain to local environment
  • DevTools
  • Binaries (magerun, magerun2, drush, wp-cli, shopware-cli)

Changes vs Valet+ 2

  • Use command valet-plus instead of valet.
  • Rename .env.valet to .valet-env.php.
  • Use command valet-plus elasticsearch|es use <version> instead of valet-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/

Get in touch

slack

We have a slack workspace available which you can join.

Yes, we have a Valet+ fan page https://www.weprovide.com/valet-plus