Maintenance mode in Laravel - Cheat Sheet & Quick Revision

Recall & Review

beginner

What is Laravel's maintenance mode?

Maintenance mode temporarily disables access to your Laravel application for users, showing a custom message while you perform updates or fixes.

beginner

How do you enable maintenance mode in Laravel?

Run the command php artisan down in your terminal to enable maintenance mode.

beginner

How do you disable maintenance mode in Laravel?

Run the command php artisan up to bring your application back online.

intermediate

How can you allow certain IP addresses to access the app during maintenance mode?

You can pass the --allow=IP_ADDRESS option with php artisan down to whitelist IPs that can still access the app.

intermediate

What is the purpose of the retry option in Laravel's maintenance mode?

The --retry=SECONDS option tells browsers how often to retry accessing the app, improving user experience during downtime.

Which command enables maintenance mode in Laravel?

A php artisan maintenance

B php artisan up

C php artisan down

D php artisan start

The command php artisan down puts the app into maintenance mode.

How do you bring the Laravel app back online after maintenance?

A php artisan up

B php artisan resume

C php artisan start

D php artisan restart

Use php artisan up to disable maintenance mode.

What does the --allow option do when enabling maintenance mode?

A Allows all users to bypass maintenance

B Allows caching during maintenance

C Allows database access only

D Allows specific IPs to access the app

The --allow option whitelists IP addresses during maintenance.

Which HTTP header does Laravel set to tell browsers when to retry during maintenance?

A Content-Type

B Retry-After

C Authorization

D Cache-Control

Laravel sets the Retry-After header to control retry timing.

What will users see when the Laravel app is in maintenance mode?

A A custom maintenance page

B The homepage

C A 404 error page

D A login form

Users see a maintenance page explaining the app is temporarily offline.

Explain how to enable and disable maintenance mode in Laravel and why it is useful.

Think about commands and the purpose of maintenance mode.

Describe how you can allow certain users to access the Laravel app during maintenance mode.

Consider how to whitelist IPs with artisan.

Practice

1. What does enabling maintenance mode in Laravel do?

easy

A. Deletes all application data

B. Automatically updates the application

C. Temporarily stops user access to the application

D. Restarts the web server

Solution

1. Step 1: Understand maintenance mode purpose

   Maintenance mode is designed to prevent users from accessing the app temporarily during updates or fixes.

2. Step 2: Identify what happens when enabled

   When enabled, users see a maintenance page instead of the app, stopping normal access.

3. Final Answer:

   Temporarily stops user access to the application -> Option C

4. Quick Check:

   Maintenance mode = stops user access [OK]

Hint: Maintenance mode blocks users temporarily [OK]

Common Mistakes:

• Thinking it deletes data
• Assuming it updates app automatically
• Confusing with server restart

2. Which command correctly enables maintenance mode in Laravel?

easy

A. php artisan down

B. php artisan up

C. php artisan start

D. php artisan maintenance

Solution

1. Step 1: Recall Laravel maintenance commands

   To enable maintenance mode, the command is php artisan down.

2. Step 2: Verify other commands

   php artisan up disables maintenance mode; others are invalid.

3. Final Answer:

   php artisan down -> Option A

4. Quick Check:

   Enable maintenance = php artisan down [OK]

Hint: Use 'down' to enable maintenance mode [OK]

Common Mistakes:

• Using 'php artisan up' to enable
• Typing non-existent commands
• Confusing start with down

3. What will be the output when a user visits the Laravel app URL while maintenance mode is enabled?

medium

A. The normal application homepage loads

B. A 404 Not Found error appears

C. The user is redirected to the login page

D. A 503 Service Unavailable maintenance page is shown

Solution

1. Step 1: Understand Laravel's maintenance response

   When maintenance mode is enabled, Laravel returns a 503 status with a maintenance page.

2. Step 2: Check other options

   The normal homepage does not load, a 404 Not Found error is unrelated, and users are not redirected to the login page.

3. Final Answer:

   A 503 Service Unavailable maintenance page is shown -> Option D

4. Quick Check:

   Maintenance mode shows 503 page [OK]

Hint: Maintenance mode returns 503 status page [OK]

Common Mistakes:

• Expecting normal homepage
• Confusing 404 with maintenance
• Thinking it redirects to login

4. You ran php artisan down but users still access the app normally. What is the likely problem?

medium

A. The down command was run in the wrong directory

B. You need to restart the web server manually

C. You forgot to clear the cache after enabling maintenance mode

D. Maintenance mode only works in production environment

Solution

1. Step 1: Check command context

   Running php artisan down outside the Laravel project folder does nothing.

2. Step 2: Evaluate other options

   Cache clearing is not required; web server restart is unnecessary; maintenance mode works in all environments.

3. Final Answer:

   The down command was run in the wrong directory -> Option A

4. Quick Check:

   Run artisan commands in project folder [OK]

Hint: Run artisan commands inside Laravel project folder [OK]

Common Mistakes:

• Assuming cache clear is needed
• Restarting server unnecessarily
• Thinking maintenance mode is environment-limited

5. How can you allow a specific IP address to access the Laravel app while it is in maintenance mode?

hard

A. Maintenance mode cannot allow exceptions for IP addresses

B. Use php artisan down --allow=IP_ADDRESS to whitelist the IP

C. Add the IP to config/app.php under 'maintenance_ips'

D. Edit .env to add the IP under MAINTENANCE_ALLOWED_IP

Solution

1. Step 1: Recall Laravel maintenance mode options

   Laravel supports allowing IPs during maintenance using php artisan down --allow=IP_ADDRESS.

2. Step 2: Verify other options

   Environment variables or config files do not control allowed IPs by default; maintenance mode does allow exceptions.

3. Final Answer:

   Use php artisan down --allow=IP_ADDRESS to whitelist the IP -> Option B

4. Quick Check:

   Allow IP with artisan down --allow [OK]

Hint: Use --allow option with down command [OK]

Common Mistakes:

• Editing .env for allowed IPs
• Modifying config/app.php incorrectly
• Believing exceptions are impossible