cretueusebiu / valet-windows by cretueusebiu
forked from laravel/valet

A more enjoyable local development experience for Windows.
104,843
903
22
Package Data
Maintainer Username: cretueusebiu
Maintainer Contact: taylor@laravel.com (Taylor Otwell)
Package Create Date: 2016-05-05
Package Last Update: 2024-02-06
Home Page:
Language: PHP
License: MIT
Last Refreshed: 2024-04-25 15:01:47
Package Statistics
Total Downloads: 104,843
Monthly Downloads: 904
Daily Downloads: 25
Total Stars: 903
Total Watchers: 22
Total Forks: 86
Total Open Issues: 14

Introduction

Valet is a Laravel development environment for Windows. No Vagrant, no /etc/hosts file. You can even share your sites publicly using local tunnels. Yeah, we like it too.

Laravel Valet configures your Windows to always run Nginx in the background when your machine starts. Then, using Acrylic DNS, Valet proxies all requests on the *.test domain to point to sites installed on your local machine.

Documentation

Before installation, make sure that no other programs such as Apache or Nginx are binding to your local machine's port 80. Also make sure to open your preferred terminal (CMD, Git Bash, PowerShell, etc.) as Administrator.

  • If you don't have PHP installed, open PowerShell (3.0+) as Administrator and run:
# PHP 7.3
Set-ExecutionPolicy RemoteSigned; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri "https://github.com/cretueusebiu/valet-windows/raw/master/bin/php73.ps1" -OutFile $env:temp\php73.ps1; .$env:temp\php73.ps1

# PHP 7.2
Set-ExecutionPolicy RemoteSigned; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.SecurityProtocolType]::Tls12; Invoke-WebRequest -Uri "https://github.com/cretueusebiu/valet-windows/raw/master/bin/php72.ps1" -OutFile $env:temp\php72.ps1; .$env:temp\php72.ps1

This script will download and install PHP for you and add it to your environment path variable. PowerShell is only required for this step.

  • If you don't have Composer installed, make sure to install it.

  • Install Valet with Composer via composer global require cretueusebiu/valet-windows.

  • Run the valet install command. This will configure and install Valet and register Valet's daemon to launch when your system starts.

  • If you're installing on Windows 10, you may need to manually configure Windows to use the Acrylic DNS proxy.

Valet will automatically start its daemon each time your machine boots. There is no need to run valet start or valet install ever again once the initial Valet installation is complete.

For more please refer to the official documentation on the Laravel website.

Known Issues

  • When sharing sites the url will not be copied to the clipboard.
  • You must run the valet commands from the drive where Valet is installed, except for park and link. See #12.
  • If your machine is not connected to the internet you'll have to manually add the domains in your hosts file or you can install the "Microsoft Loopback Adapter" as this simulates an active local network interface that Valet can bind too.

Useful Links

Changelog

Please see CHANGELOG for more information what has changed recently.

License

Laravel Valet is open-sourced software licensed under the MIT license.