PHPackages                             symsensor/actuator-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. [Logging & Monitoring](/categories/logging)
4. /
5. symsensor/actuator-maintenance-bundle

ActiveSymfony-bundle[Logging & Monitoring](/categories/logging)

symsensor/actuator-maintenance-bundle
=====================================

Extension for the ActuatorBundle which provides health checking capabilities for maintenance modes.

v1.0.1(2y ago)0540MITPHP

Since Mar 22Pushed 2y ago1 watchersCompare

[ Source](https://github.com/SymSensor/ActuatorMaintenanceBundle)[ Packagist](https://packagist.org/packages/symsensor/actuator-maintenance-bundle)[ RSS](/packages/symsensor-actuator-maintenance-bundle/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (10)Versions (3)Used By (0)

ActuatorMaintenanceBundle
=========================

[](#actuatormaintenancebundle)

[![](https://github.com/SymSensor/ActuatorMaintenanceBundle/raw/main/docs/logo.png?raw=true)](https://github.com/SymSensor/ActuatorMaintenanceBundle/blob/main/docs/logo.png?raw=true)

ActuatorMaintenanceBundle extends [ActuatorBundle](https://github.com/SymSensor/ActuatorBundle) by providing health indicator which will signal if the application is in maintenance mode.

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.

### Applications that use Symfony Flex

[](#applications-that-use-symfony-flex)

Open a command console, enter your project directory and execute:

```
$ composer require symsensor/actuator-maintenance-bundle
```

### Applications that don't use Symfony Flex

[](#applications-that-dont-use-symfony-flex)

#### Step 1: Download the Bundle

[](#step-1-download-the-bundle)

Open a command console, enter your project directory and execute the following command to download the latest stable version of this bundle:

```
$ composer require symsensor/actuator-maintenance-bundle
```

#### Step 2: Enable the Bundle

[](#step-2-enable-the-bundle)

Then, 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 [
    // ...
    SymSensor\ActuatorBundle\SymSensorActuatorMaintenanceBundle::class => ['all' => true],
];
```

Configuration
-------------

[](#configuration)

The Bundle can be configured with a configuration file named `config/packages/sym_sensor_actuator.yaml`. Following snippet shows the default value for all configurations:

```
sym_sensor_actuator_maintenance:
  enabled: true
  files:
    - /tmp/maintenance
    - /var/www/html/maintenance
```

List all files which should be monitored. This extension will turn the health red if the file exists, is readable by the user and contains the content "1" (without newline). If multiple files are declared, then only one of the file has to meet the criteria.

License
-------

[](#license)

ActuatorBundle is released under the MIT Licence. See the bundled LICENSE file for details.

Author
------

[](#author)

Originally developed by [Arkadiusz Kondas](https://twitter.com/ArkadiuszKondas)

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity42

Maturing project, gaining track record

 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 ~0 days

Total

2

Last Release

786d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/905dd52f3e3496d49f533a665ce4563dd944876be109503e36efd57bf9885c5b?d=identicon)[kreemer](/maintainers/kreemer)

---

Top Contributors

[![kreemer](https://avatars.githubusercontent.com/u/292258?v=4)](https://github.com/kreemer "kreemer (4 commits)")

---

Tags

actuator

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/symsensor-actuator-maintenance-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/symsensor-actuator-maintenance-bundle/health.svg)](https://phpackages.com/packages/symsensor-actuator-maintenance-bundle)
```

###  Alternatives

[liip/monitor-bundle

Liip Monitor Bundle

4728.7M16](/packages/liip-monitor-bundle)[inspector-apm/inspector-symfony

Code Execution Monitoring for Symfony applications.

2830.1k2](/packages/inspector-apm-inspector-symfony)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)