PHPackages jontsa/maintenance-bundle - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. jontsa/maintenance-bundle ActiveSymfony-bundle[Utility & Helpers](/categories/utility) jontsa/maintenance-bundle ========================= Symfony bundle to put your site in to maintenance mode. 1.0.0(2y ago)1736MITPHPPHP ^8.0CI failing Since Mar 25Pushed 2y ago1 watchersCompare [ Source](https://github.com/Jontsa/JontsaMaintenanceBundle)[ Packagist](https://packagist.org/packages/jontsa/maintenance-bundle)[ RSS](/packages/jontsa-maintenance-bundle/feed)WikiDiscussions master Synced today READMEChangelog (7)Dependencies (8)Versions (8)Used By (0) Symfony maintenance mode bundle =============================== [](#symfony-maintenance-mode-bundle) A small bundle for Symfony 4/5 which provides commands to put your application in maintenance break during which all requests receive HTTP 503 response. This is done by throwing `ServiceUnavailableHttpException` and clients will receive either default Symfony error page or JSON message with correct HTTP status code. [![Tests](https://github.com/Jontsa/JontsaMaintenanceBundle/workflows/Tests/badge.svg)](https://github.com/Jontsa/JontsaMaintenanceBundle/workflows/Tests/badge.svg) Features -------- [](#features) - Put your site to maintenance mode with single command - Responds with HTTP 503 to requests during maintenance - Optional IP-address whitelist. For example to allow access for load balancer health checks during maintenance. - Lightweight bundle - [Recipes for Deployer](https://github.com/Jontsa/JontsaMaintenanceBundle/Resources/doc/deployer-recipe.md) Requirements ------------ [](#requirements) - Symfony 5+ - PHP 7.4+ - composer Installation ------------ [](#installation) Make sure Composer is installed globally, as explained in the [installation chapter](https://getcomposer.org/doc/00-intro.md)of the Composer documentation. Open a command console, enter your project directory and execute: ``` $ composer require jontsa/maintenance-bundle ``` ### Applications not using Symfony Flex [](#applications-not-using-symfony-flex) When not using Symfony Flex, you need to enable the bundle by adding it to the list of registered bundles in the `config/bundles.php` file of your project: ``` // config/bundles.php return [ // ... Jontsa\Bundle\MaintenanceBundle\JontsaMaintenanceBundle::class => ['all' => true], ]; ``` Usage ----- [](#usage) To put your site under maintenance mode ``` $ bin/console jontsa:maintenance enable ``` To disable maintenance mode ``` $ bin/console jontsa:maintenance disable ``` Configuration ------------- [](#configuration) To change default settings, create a configuration file. ``` # config/packages/jontsa_maintenance.yaml jontsa_maintenance: whitelist: ip: [127.0.0.1, 192.168.0.0/24] lock_path: '%kernel.project_dir%/var/cache/maintenance' ``` - `ip` is an array of IP-addresses or networks which are allowed to access applications even during maintenance - `lock_path` is the file path which is created during maintenance ### Custom error page [](#custom-error-page) If you want to customize the error page, check out [Symfony documentation](https://symfony.com/doc/current/controller/error_pages.html). ### Health Score 31 — LowBetter than 68% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community7 Small or concentrated contributor base Maturity66 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~229 days Recently: every ~284 days Total 7 Last Release 860d ago Major Versions 0.4.0 → 1.0.02024-01-02 PHP version history (4 changes)0.1.0PHP ^7.1 0.2.0PHP ^7.1|^8.0 0.3.0PHP ^7.4|^8.0 1.0.0PHP ^8.0 ### Community Maintainers ![](https://www.gravatar.com/avatar/c2a67d0735c369b66ead8965287687bc06f212aa3d5aab87f71aae057071556d?d=identicon)[jontsa](/maintainers/jontsa) --- Top Contributors [![Jontsa](https://avatars.githubusercontent.com/u/17642317?v=4)](https://github.com/Jontsa "Jontsa (23 commits)") ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/jontsa-maintenance-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/jontsa-maintenance-bundle/health.svg)](https://phpackages.com/packages/jontsa-maintenance-bundle) ``` ### Alternatives [symfony/maker-bundle Symfony Maker helps you create empty commands, controllers, form classes, tests and more so you can forget about writing boilerplate code. 3.4k111.1M567](/packages/symfony-maker-bundle)[symplify/monorepo-builder Not only Composer tools to build a Monorepo. 5205.3M82](/packages/symplify-monorepo-builder)[netgen/layouts-core Netgen Layouts enables you to build and manage complex web pages in a simpler way and with less coding. This is the core of Netgen Layouts, its heart and soul. 3689.4k10](/packages/netgen-layouts-core)[netgen/content-browser Netgen Content Browser is a Symfony bundle that provides an interface which selects items from any kind of backend and returns the IDs of selected items back to the calling code. 14112.1k8](/packages/netgen-content-browser) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)