PHPackages helppc/supervisor-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. [API Development](/categories/api) 4. / 5. helppc/supervisor-bundle ActiveSymfony-bundle[API Development](/categories/api) helppc/supervisor-bundle ======================== Manage your Supervisor instances from a Symfony application. v2.0.0(1mo ago)013311MITPHPPHP >=8.2CI passing Since Oct 11Pushed 1mo ago1 watchersCompare [ Source](https://github.com/helppc/supervisor-bundle)[ Packagist](https://packagist.org/packages/helppc/supervisor-bundle)[ Docs](https://github.com/helppc/supervisor-bundle)[ RSS](/packages/helppc-supervisor-bundle/feed)WikiDiscussions master Synced yesterday READMEChangelog (3)Dependencies (29)Versions (10)Used By (1) HelpPC Supervisor Bundle ======================== [](#helppc-supervisor-bundle) [![CI](https://github.com/helppc/supervisor-bundle/actions/workflows/ci.yml/badge.svg)](https://github.com/helppc/supervisor-bundle/actions/workflows/ci.yml)[![License](https://camo.githubusercontent.com/0f97114fa4e05685ccaa1f44529f4125f83d5694b7699ab9177905e8d2a59128/68747470733a2f2f706f7365722e707567782e6f72672f68656c7070632f73757065727669736f722d62756e646c652f6c6963656e7365)](https://packagist.org/packages/helppc/supervisor-bundle) Symfony bundle for managing [Supervisor](http://supervisord.org/) processes over its XML-RPC API — list processes, start/stop/restart them and tail their logs from a small web UI. Implemented on top of the [supervisorphp/supervisor](https://github.com/supervisorphp/supervisor) library. Requirements ------------ [](#requirements) - PHP 8.2 or greater - Symfony 6.4, 7.x or 8.x Upgrading from 1.x? See [UPGRADE-2.0.md](UPGRADE-2.0.md). Installation ------------ [](#installation) 1. Require the bundle with Composer: ``` composer require helppc/supervisor-bundle ``` The bundle ships its own PSR-17/PSR-18 stack (`nyholm/psr7` + `symfony/http-client`) — no extra wiring is needed. 2. Enable the bundle in `config/bundles.php`: ``` HelpPC\Bundle\SupervisorBundle\SupervisorBundle::class => ['all' => true], ``` 3. Create `config/packages/helppc_supervisor.yaml`. Full reference: ``` helppc_supervisor: default_environment: prod servers: prod: localhost: scheme: http # default host: 127.0.0.1 # required port: 9001 # default username: '%env(SUPERVISOR_RPC_USERNAME)%' # optional — HTTP basic auth password: '%env(SUPERVISOR_RPC_PASSWORD)%' # optional hidden_processes: [] # process/group names that must never # be listed or controlled (see below) log_tail_bytes: 16384 # how much of a log tail to render ``` 4. Import the routes in `config/routes/helppc_supervisor.yaml`: ``` helppc_supervisor: resource: '@SupervisorBundle/config/routes.php' prefix: /supervisor ``` 5. Restrict access — the bundle does no authorization by itself. All state-changing routes are `POST`-only, but you still want an `access_control` rule (or your own means) limiting who can reach the UI: ``` security: access_control: - { path: ^/supervisor, roles: ROLE_ADMIN } ``` Supervisord configuration ------------------------- [](#supervisord-configuration) The bundle talks to supervisord's HTTP XML-RPC endpoint. Enable it in `supervisord.conf`, ideally bound to loopback and protected by credentials (supervisord expands real environment variables via `%(ENV_...)s`): ``` [inet_http_server] port=127.0.0.1:9001 username=%(ENV_SUPERVISOR_RPC_USERNAME)s password=%(ENV_SUPERVISOR_RPC_PASSWORD)s [rpcinterface:supervisor] supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface ``` Note on timeouts: `stopProcess`/`restartProcess` wait for the process to stop, which can take up to the program's `stopwaitsecs`. Make sure your PHP HTTP client timeout (default 60 s with `symfony/http-client`) exceeds the largest `stopwaitsecs` you use. Hidden processes ---------------- [](#hidden-processes) `hidden_processes` is a per-server deny-list of process **names or group names**. A hidden process: - never appears in the process list, and - cannot be targeted at all — start/stop/restart/log routes return **404**before any RPC call is made. Matching the group as well covers `numprocs > 1` programs (process `worker_00`in group `worker`) and event listeners (whose group equals their name). Typical use: hide the processes that keep the container itself alive: ``` hidden_processes: [php-fpm, nginx, fatal_exit] ``` Anything you later add to `supervisord.conf` becomes manageable automatically — only processes that must stay untouchable need to be listed here. Templates --------- [](#templates) Every page renders inside the `@Supervisor/layout.html.twig` layout. To embed the UI into your application chrome, override that single file (`templates/bundles/SupervisorBundle/layout.html.twig`): ``` {% extends 'base.html.twig' %} {% block body %}{% block supervisor_content %}{% endblock %}{% endblock %} ``` Translations ship in English and Czech (domain `SupervisorBundle`). Reporting issues ---------------- [](#reporting-issues) Use the [issue tracker](https://github.com/helppc/supervisor-bundle/issues) to report any issues you might have. License ------- [](#license) See the [LICENSE](LICENSE.md) file for license rights and limitations (MIT). ### Health Score 51 — FairBetter than 95% of packages Maintenance93 Actively maintained with recent releases Popularity15 Limited adoption so far Community12 Small or concentrated contributor base Maturity73 Established project with proven stability Bus Factor1 Top contributor holds 75% 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 ~262 days Recently: every ~520 days Total 9 Last Release 33d ago Major Versions v1.0.6 → v2.x-dev2026-07-14 PHP version history (3 changes)1.0.0PHP ^7.4 v1.0.6PHP ^7.4|^8 v2.x-devPHP >=8.2 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7447745?v=4)[Tomáš Kulhánek](/maintainers/tomas-kulhanek)[@tomas-kulhanek](https://github.com/tomas-kulhanek) --- Top Contributors [![tomas-kulhanek](https://avatars.githubusercontent.com/u/7447745?v=4)](https://github.com/tomas-kulhanek "tomas-kulhanek (3 commits)")[![pmiroslawski](https://avatars.githubusercontent.com/u/2961647?v=4)](https://github.com/pmiroslawski "pmiroslawski (1 commits)") --- Tags apisymfonyrpcsupervisorsupervisordsupervisorctl ### Code Quality TestsPHPUnit Static AnalysisPHPStan Type Coverage Yes ### Embed Badge ![Health badge](/badges/helppc-supervisor-bundle/health.svg) ``` [![Health](https://phpackages.com/badges/helppc-supervisor-bundle/health.svg)](https://phpackages.com/packages/helppc-supervisor-bundle) ``` ### Alternatives [sylius/sylius E-Commerce platform for PHP, based on Symfony framework. 8.5k6.0M777](/packages/sylius-sylius)[shopware/core Shopware platform is the core for all Shopware ecommerce products. 595.8M672](/packages/shopware-core)[shopware/platform The Shopware e-commerce core 3.4k1.5M3](/packages/shopware-platform)[contao/core-bundle Contao Open Source CMS 1301.7M3.1k](/packages/contao-core-bundle)[sulu/sulu Core framework that implements the functionality of the Sulu content management system 1.3k1.4M235](/packages/sulu-sulu)[pimcore/pimcore Content & Product Management Framework (CMS/PIM/E-Commerce) 3.8k3.9M535](/packages/pimcore-pimcore) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)