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

Amit Merchant

A blog on PHP, JavaScript, and more

Access application in maintenance mode using a secret token in Laravel 8

Apart from adding support for customizable maintenance mode views, Laravel 8 has also simplified the process of accessing the Laravel application in the maintenance mode.

Up until Laravel 8, the standard way of getting whitelisted from the maintenance mode was by using an “allow list” of IP addresses that were allowed to access the application like so.

$ php artisan down --allow=127.0.0.1

The secret token

It was quite an overhead and not very much manageable. So, from Laravel 8, you can use a secret option with php artisan down where you can specify a token. A token can be anything. A random string like so.

$ php artisan down --secret="harrypotter"

Once the application is in the maintenance mode, you can access it using the secret token like so.

https://example.com/harrypotter

This will redirect you to the / route of the application. And from this point onwards, you’ll be able to access the application as long as the application is in the maintenance mode using secret set to “harrypotter”.

Now, all you’ll need is to give the access token to anyone who wants to access your Laravel application instead of adding an array of IP addresses to the whitelist.

Under the hood

Behind the scenes, Laravel issues a cookie called laravel_maintenance in your browser which is the key thing that lets you access the application in the maintenance mode. If you clear the cookies, you’ll lose the ability to access the application once again.

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?