Download the PHP package konsulting/laravel-maintenance-mode without Composer
On this page you can find all versions of the php package konsulting/laravel-maintenance-mode. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download konsulting/laravel-maintenance-mode
More information about konsulting/laravel-maintenance-mode
Files in konsulting/laravel-maintenance-mode
Package laravel-maintenance-mode
Short Description Programmatically manage maintenance mode in Laravel apps across multiple servers.
License MIT
Informations about the package laravel-maintenance-mode
Laravel Maintenance Mode
Installation
Install via Composer:
Laravel 5.5+ will automatically discover the provider and facade.
Config
Publish the config file with:
Middleware
The file driver is compatible with Laravel's existing maintenance mode middleware when using the default configuration values.
To use a different driver or a different file path, add the provided CheckForMaintenanceMode
middleware to app/Http/Kernel.php
.
Basic usage
By default, the Laravel artisan up
and artisan down
commands are overridden and so may be used to activate and
deactivate maintenance mode using the selected driver.
If override_illuminate_commands
is set to false
in the config, the commands for maintenance mode are site:up
and
site:down
.
The behaviour of maintenance mode is similar to Laravel's default artisan up
/artisan down
commands.
When activated, the a payload containing information about the outage is stored using the chosen driver.
This is picked up by the middleware, which throws Illuminate\Foundation\Http\Exceptions\MaintenanceModeException
if
maintenance mode is active. Laravel's exception handler deals with returning the correct response.
Drivers
By default there are three drivers included: file, cache and storage. The file driver is very similar to Laravel's built in maintenance mode in that it stores a payload file in the local filesystem. The cache and storage drivers are useful for when multiple webservers are serving the application, as they can be easily configured to store the payload at an external location such as a cache server.
See the configuration file for more information about the drivers.
Programmatic usage
Instantiation
The available drivers are: cache, file, and storage. More detail is contained in config/maintenance_mode.php
.
Activating maintenance mode
Maintenance mode is activated with the MaintenanceMode::on()
method.
When maintenance mode is activated, a payload object is created with the information given and stored by the chosen driver. This contains information about the site being taken down, including the at which maintenance mode was activated, the seconds between retry requests, any IP addresses that are allowed to access the site during maintenance mode, and a message associated with the downtime.
Retrieving down information
Deactivating maintenance mode
Maintenance mode is deactivated with the MaintenanceMode::off()
method.