Maintenance mode in Laravel - Step-by-Step Execution

Concept Flow - Maintenance mode

Start Laravel App

↓

Check if Maintenance Mode is ON?

No→Serve Normal Requests

Yes↓

Serve Maintenance Page

↓

End Request

Laravel checks if maintenance mode is active before serving requests. If yes, it shows a maintenance page; otherwise, it serves the app normally.

Execution Sample

Laravel

php artisan down
// App now in maintenance mode
// Requests show maintenance page
php artisan up
// App back to normal mode

This code puts the Laravel app into maintenance mode and then brings it back to normal.

Execution Table

Step	Action	Maintenance Mode Status	Request Handling	Output
1	Run 'php artisan down'	ON	Check mode -> Maintenance ON	Maintenance page shown
2	User sends request	ON	Serve maintenance page	User sees maintenance message
3	Run 'php artisan up'	OFF	Check mode -> Maintenance OFF	Normal app serves requests
4	User sends request	OFF	Serve normal app	User sees normal app content
5	End	OFF	No maintenance	Normal operation

💡 Maintenance mode OFF, app serves normal requests

Variable Tracker

Variable	Start	After Step 1	After Step 3	Final
maintenance_mode	OFF	ON	OFF	OFF

Key Moments - 3 Insights

Why does the app show a maintenance page after running 'php artisan down'?

Because the maintenance_mode variable changes to ON at Step 1, so Laravel serves the maintenance page as shown in Step 2.

What happens if you try to access the app while maintenance mode is ON?

The app serves the maintenance page instead of normal content, as seen in Step 2 of the execution table.

How do you bring the app back to normal operation?

By running 'php artisan up' which sets maintenance_mode to OFF at Step 3, allowing normal requests to be served.

Visual Quiz - 3 Questions

Look at the execution table, what is the maintenance_mode status after running 'php artisan down'?

A UNKNOWN

B OFF

C ON

D ERROR

💡 Hint

Check Step 1 in the execution_table under 'Maintenance Mode Status'

At which step does the app start serving normal requests again?

A Step 2

B Step 4

C Step 3

D Step 1

💡 Hint

Look at 'Request Handling' and 'Output' columns in execution_table rows

If you skip running 'php artisan up', what will users see when they send requests?

A Maintenance page

B Error 404

C Normal app content

D Blank page

💡 Hint

Refer to Step 2 where maintenance_mode is ON and maintenance page is served

Concept Snapshot

Laravel Maintenance Mode:
- Run 'php artisan down' to enable maintenance mode.
- While ON, users see a maintenance page.
- Run 'php artisan up' to disable and return to normal.
- Laravel checks mode on each request.
- Useful for safe app updates.

Full Transcript

Laravel maintenance mode lets you temporarily disable your app for users by running 'php artisan down'. When enabled, Laravel shows a maintenance page instead of normal content. This is useful during updates or fixes. To return to normal, run 'php artisan up'. The app checks the maintenance mode status on every request and serves content accordingly.