By
Laravel Valet is a super lightweight development environment for macOS. It allows Laravel developers to host and run applications locally in the local development environment, yet be referred to with the "*.test" domain. This eliminates the need to manage the host files (/etc/hosts). What's more, by using ngrok, local applications can be made publicly available.
Use cases for Valet
Launch applications locally: with Valet, PHP, and by extension, Laravel applications can be launched on the local development machine without requiring MAMP or Vagrant. This cuts the need for a time-intensive setup and configuration. In short, it does this by serving PHP applications with NGINX, and uses DnsMasq to proxy all requests on the "*.test" domain to the sites served by NGINX.
Generate custom URLs: By default, PHP applications are expected to run on http://localhost with, optionally, a port other than 80. Valet scaffolds that process and allows for a local domain name to be created based on the project's directory name. By doing this, you can use a URL such as "http://xzy.test" in your browser and run your application effortlessly.
Secure links: Securing sites in Valet means making them unique to the specified directory. Valet then creates a unique SSL certificate and binds it to the directory. The SSL certificate keeps user data secure, verifies ownership, and prevents hacks.
Share local environments: With Valet, locally developed applications can be shared using generated URLs for public access and interaction. This enables collaboration on projects, and simplifies reviews before applications are pushed to a production server.
Prerequisites
- Prior knowledge of PHP
- PHP
- Your preferred text editor or IDE. I recommend using Visual Studio Code.
- Homebrew
- Composer installed globally
- ngrok, plus a free ngrok account
Install Valet
To install (and start) Valet, open the terminal on your Mac and run the below commands
brew update
composer global require laravel/valet
valet install
composer global update
Once the installation is completed, check that Valet is installed using the command below.
valet --version
If you see output similar to the following in your terminal, then Valet has been successfully installed on your Mac.
Laravel Valet 3.3.0
Serve a new site using Valet
Now, it's time to go through how to use Valet to serve a PHP application. This will show the simplicity of Valet, regardless of how bulky, complex, or simple the application you are building locally is.
Generate a link
Using your preferred text editor or IDE, create a new folder with the name valet_article. Then, change into that directory and create a new file named index.php. Inside index.php, add the following code:
<?php
echo "Hello world";
When that is done, link the directory to a *.text domain, by running the command below.
valet link
You should then see output, similar to the example below, printed to the terminal.
// A [valet_article] symbolic link has been created in [/Users/MAC_NAME/.config/valet/Sites/valet_article].
Now that the link has been created and the domain generated, open it in your Mac's default browser. To do that, run the command below.
valet open
Below is an example from my Mac.
Note the URL http://valet_article.test is opened. This matches the name of the folder that you created and linked to. Also, if you were to open your browser's Developer Tools, and then open the Network tab, as shown in the Chrome screenshot below. You should see that Valet is using 127.0.0.1 as the remote address and generating a random port for the application.
Secure the site
The next thing to do is to secure the application to prevent hacks. To do that, run the command below. Enter your password or use Touch ID when prompted.
valet secure
The command will create SSL/TLS certificates for the generated URL, load them into and restart NGINX (which was installed by Valet). Please be a little patient while this happens
Once an application has been secured, if you need to, you can make the application directory insecure again, by using the following command. This will remove the security certificate generated and embedded in the project directory.
valet insecure valet_article
Share the site publicly
Valet uses ngrok to make local applications publicly accessible on the internet.
valet share
The above code will start an ngrok session, launch the PHP application, and then publish the URL with its port to a random ngrok address. The image below is an example of what you should see in the terminal.
The link in the Forwarding keys are the ngrok auto-generated URLs that can be opened in the browser, which you can see an example of below.
Note that it still points to http://valet_article.test:60 as the origin URL.
That's how to use Laravel Valet to share a PHP site
In this article, we discussed Laravel Valet and its use primary case. We also went through the process of installing and using it on macOS to act as a development environment for hosting PHP applications. Later, we discussed how to run, secure, and share our project publicly for other users for reviewing or testing.
Kenneth Ekandem is a full-stack developer from Nigeria currently in the blockchain space, but interested in learning everything computer science has to offer. He'd love to go to space one day and own his own vlogging channel to teach the next generation of programmers.
In this tutorial, you will learn how you can use the Mercure protocol in your Symfony applications to broadcast updates to the frontend.
In this tutorial, you will learn how to upload files in CakePHP
In this tutorial, you're going to learn how to store files using Google Cloud Storage and PHP's Flysystem package.
In this short tutorial, you will learn how to mock Twilio's Lookup API.
In this tutorial, you will learn the Intervention Image's features, and use it to build a simple meme generator using it with Laravel.
In this short tutorial, you're going to learn how to optimise images in PHP with only a negligible loss of quality — if any.