Get "PHP 8 in a Nuthshell" (Soon includes PHP 8.4)
Amit Merchant

Amit Merchant

A blog on PHP, JavaScript, and more

Get up and running with Laravel blazing fast using Sail

Imagine you just bought a new computer and the next thing you want to do is create a brand new Laravel application in your brand new machine.

The usual way to do this is to install a server (Apache or Nginx) PHP, MySQL, and a lot of other software yourself. Not to forget a lot of required PHP extensions as well. That’s a lot of work do to if you ask me. On top of this, if you are stuck somewhere in this process, god saves you!

To remove this overhead, Taylor Otwell has just released a brand new command-line interface called Sail for Laravel.

What is Sail?

Quoting the official documentation

Laravel Sail is a light-weight command-line interface for interacting with Laravel’s default Docker development environment.

In a nutshell, Sail is just a convenient interface to interact with the Docker container that runs a Laravel application.

Sail provides an easy way to get started with Laravel without all the overhead I mentioned previously. The good thing about this is even though Sail is built on top of Docker, you wouldn’t require prior Docker experience.

Get started with Sail

Sail comes bundled with all new Laravel applications so you may start using it immediately.

To get started with it, the only requirement is you should have Docker Desktop on your (macOS and Linux) machine and you are good to go!

Note: Using Sail on Windows machine requires slightly tweaked workflow. You can check it out here.

Next, you can create a new Laravel application with Sail using the following command.

$ curl -s https://laravel.build/example-app | bash

Once run, the command will create a new Laravel application in a directory named “example-app”. You can change the name of the application by replacing “example-app” with your desired name in the URL above.

After the project has been created, you can navigate to the application directory and start Sail using the following command.

$ cd example-app

$ ./vendor/bin/sail up

Running this command the first time will build application containers on your machine. So, it might take a while. The subsequent attempts to start Sail will be much faster.

Once the application’s Docker containers have been started, you can access the application in your web browser at: http://localhost.

And that’s about it! You have your brand new Laravel application running without a lot of fuss.

Starting and stopping Sail

We have seen the sail up command to start Docker containers but you can also start all of the Docker containers in the background. To do this, you may start Sail in “detached” mode like so.

$ ./vendor/bin/sail up -d

To stop all of the containers, you may simply press Control + C to stop the container’s execution. Or, if the containers are running in the background, you may use the down command like so.

$ ./vendor/bin/sail down

In closing

Since Sail is just Docker, you can customize nearly everything about it. To do so, you can customize the docker-compose.yml file that is stored at the root of your project.

Apart from this, using Sail, you can run various commands against your application such as arbitrary PHP commands, Artisan commands, Composer commands, and Node / NPM commands. You can run tests, interact with databases, redis and a lot of other things.

You can learn about Sail further at its official documentation.

Learn the fundamentals of PHP 8 (including 8.1, 8.2, and 8.3), the latest version of PHP, and how to use it today with my new book PHP 8 in a Nutshell. It's a no-fluff and easy-to-digest guide to the latest features and nitty-gritty details of PHP 8. So, if you're looking for a quick and easy way to PHP 8, this is the book for you.

Like this article?

Buy me a coffee

👋 Hi there! I'm Amit. I write articles about all things web development. You can become a sponsor on my blog to help me continue my writing journey and get your brand in front of thousands of eyes.

Comments?