artgris/maintenance-bundle

Symfony Bundle to place your Symfony website in maintenance mode

Maintainers

Details

github.com/artgris/MaintenanceBundle

Homepage

Source

Issues

Installs: 70 666

Dependents: 0

Suggesters: 0

Security: 0

Stars: 23

Watchers: 3

Forks: 7

Open Issues: 0

Type:symfony-bundle

1.2.4 2024-03-06 07:10 UTC

Requires

Requires (Dev)

MIT 5fcd1042c7ad539caa412bb06ca9f3e5fa51cffc

  • Arthur Gribet <a.gribet.woop@gmail.com>

symfonybundlemaintenance

This package is auto-updated.

Last update: 2024-12-06 08:40:30 UTC

README

Symfony Bundle to place your Symfony website in maintenance mode - Default Maintenance Page

Installation

1) Download

composer require artgris/maintenance-bundle

2) Configure the Bundle

Adds following configurations

to config/packages/artgris_maintenance.yaml :

artgris_maintenance:
    enable: true                 # Enable|Disable maintenance - default: false
    ips: ["127.0.0.1","::1",...] # IPs allow (prod) - default: []
    response: 503                # Maintenance Page HTTP Status Code - default: 503

3) Override maintenance.html.twig (optional)

in templates/bundles/ArtgrisMaintenanceBundle/maintenance.html.twig

ex:

{% extends "@!ArtgrisMaintenance/maintenance.html.twig" %}

{% block content %}
    <h1>Site en cours de maintenance</h1>
    <h2>Nous reviendrons bientôt. Désolé pour le dérangement.</h2>
{% endblock %}

Usage

The dev environment was not affected by maintenance.

  • Enable|Disable maintenance : enable: true|false
  • Add authorized IPs to prod : ips: ["127.0.0.1","::1",...]
  • Maintenance Page HTTP Status Code : response: 503

Don't forget to clear the prod cache :

php bin/console cache:clear