Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/artgris/maintenancebundle

Symfony Bundle to place your Symfony website in maintenance mode
https://github.com/artgris/maintenancebundle

maintenance-mode symfony symfony-bundle symfony3

Last synced: 2 months ago
JSON representation

Symfony Bundle to place your Symfony website in maintenance mode

Awesome Lists containing this project

README

        

# MaintenanceBundle
Symfony Bundle to place your Symfony website in maintenance mode - [**Default Maintenance Page**](https://artgris.github.io/MaintenanceBundle/)

Installation
============

### 1) Download

`composer require artgris/maintenance-bundle`

### 2) Configure the Bundle

Adds following configurations

to ` config/packages/artgris_maintenance.yaml` :

```yml
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:
```twig
{% extends "@!ArtgrisMaintenance/maintenance.html.twig" %}

{% block content %}

Site en cours de maintenance


Nous reviendrons bientôt. Désolé pour le dérangement.


{% 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