Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/weprovide/valet-plus

Blazing fast macOS PHP development environment
https://github.com/weprovide/valet-plus

development-environment php

Last synced: 4 days ago
JSON representation

Blazing fast macOS PHP development environment

Awesome Lists containing this project

README

        

[![Latest Version on Packagist](https://img.shields.io/packagist/v/weprovide/valet-plus.svg?style=flat)](https://packagist.org/packages/weprovide/valet-plus)
[![Downloads on Packagist](https://img.shields.io/packagist/dt/weprovide/valet-plus.svg?style=flat)](https://packagist.org/packages/weprovide/valet-plus)

## Introduction

Valet+ is a development environment for macOS. No Vagrant, no Docker, no `/etc/hosts` file. This project uses
[laravel/valet](https://github.com/laravel/valet) as a dependency.

## Installation

> :warning: Valet+ requires macOS and [Homebrew](https://brew.sh/). Before installation, you should make sure that no
> other programs such as Apache or Nginx are binding to your local machine's port 80.

> :warning: Valet+ requires [Composer](https://getcomposer.org/) to be installed.

To get started, you first need to ensure that Homebrew is up-to-date using the update command:
```shell
brew update
```

Next, you should use Homebrew to install PHP 8.1 (using `shivammathur/php`):
```shell
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:
```shell
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.
```shell
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 ` instead of `valet-plus use elasticsearch|es `.
- 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](https://p9.zdassets.com/hc/theme_assets/138842/200037786/logo.png)](https://join.slack.com/t/valet-plus/shared_invite/enQtNDE2MjU2NzgyNjQwLWFiYWNjOWFhOWQ2ZDcyOTEyZTA2MzAzOWYyYzYwMTYzODVlMGE3ZDg3ZWQ1M2JmN2M0OGY3OGUwMDI3NDM1NDU)

We have a slack workspace available [which you can join](https://join.slack.com/t/valet-plus/shared_invite/enQtNDE2MjU2NzgyNjQwLWFiYWNjOWFhOWQ2ZDcyOTEyZTA2MzAzOWYyYzYwMTYzODVlMGE3ZDg3ZWQ1M2JmN2M0OGY3OGUwMDI3NDM1NDU).

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