PHPackages                             mybuilder/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. [CLI &amp; Console](/categories/cli)
4. /
5. mybuilder/supervisor-bundle

ActiveLibrary[CLI &amp; Console](/categories/cli)

mybuilder/supervisor-bundle
===========================

Symfony 3/4/5 bundle which allows you to use @Supervisor annotations to configure how Supervisor runs your console commands.

2.2.0(3y ago)3455.0kMITPHPPHP &gt;=7.4

Since Oct 25Pushed 3y ago14 watchersCompare

[ Source](https://github.com/mybuilder/supervisor-bundle)[ Packagist](https://packagist.org/packages/mybuilder/supervisor-bundle)[ RSS](/packages/mybuilder-supervisor-bundle/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (9)Dependencies (7)Versions (10)Used By (0)

Supervisor Bundle
=================

[](#supervisor-bundle)

[![Build Status](https://camo.githubusercontent.com/ebbb652525706157c787a7624663259a106677a2f383960427853dec7fda4fe3/68747470733a2f2f7472617669732d63692e6f72672f6d796275696c6465722f73757065727669736f722d62756e646c652e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/mybuilder/supervisor-bundle)

A bundle for Symfony 4/5 which allows you to use `@Supervisor` annotations to configure how [Supervisor](http://supervisord.org/) runs your console commands.

Installation
------------

[](#installation)

### Install with composer

[](#install-with-composer)

Run the composer require command:

```
$ php composer.phar require mybuilder/supervisor-bundle
```

### Enable the bundle

[](#enable-the-bundle)

Enable the bundle in the `config/bundles.php` for Symfony:

```
return [
    MyBuilder\Bundle\SupervisorBundle\MyBuilderSupervisorBundle::class => ['all' => true],
];
```

### Configure the bundle

[](#configure-the-bundle)

You can add the following to `packages/my_builder_supervisor.yaml` for Symfony to define your global export configuration:

```
my_builder_supervisor:
    exporter:
        # any Supervisor program options can be specified within this block
        program:
            autostart: 'true'

        # allows you to specify a program that all commands should be passed to
        executor: php

        # allows you to specify the console that all commands should be passed to
        console: bin/console
```

Usage
-----

[](#usage)

The first step is to add the `use` case for the annotation to the top of the command you want to use the `@Supervisor` annotations in.

```
use MyBuilder\Bundle\SupervisorBundle\Annotation\Supervisor;
```

Then define the `@Supervisor` annotation within the command's PHPDoc, which tells Supervisor how to configure this program. The example below declares that three instances of this command should be running at all times on the server entitled 'web', with the provided parameter `--send`.

```
/**
 * Command for sending our email messages from the database.
 *
 * @Supervisor(processes=3, params="--send", server="web")
 */
class SendQueuedEmailsCommand extends Command {}
```

Exporting the Supervisor configuration
--------------------------------------

[](#exporting-the-supervisor-configuration)

You should run `bin/console supervisor:dump` and review what the Supervisor configuration will look like based on the current specified definition. If you are happy with this you can write out the configuration to a `conf` file:

```
$ bin/console supervisor:dump --user=mybuilder --server=web > "/etc/supervisor.d/symfony.conf"

```

And then reload Supervisor:

```
$ kill -SIGHUP $(supervisorctl pid)

```

### Environment

[](#environment)

You can choose which environment you want to run the commands in Supervisor under like this:

```
$ bin/console supervisor:dump --server=web --env=prod

```

---

Created by [MyBuilder](http://www.mybuilder.com/) - Check out our [blog](http://tech.mybuilder.com/) for more insight into this and other open-source projects we release.

###  Health Score

37

—

LowBetter than 83% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity31

Limited adoption so far

Community16

Small or concentrated contributor base

Maturity69

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

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

Recently: every ~260 days

Total

9

Last Release

1324d ago

Major Versions

1.1.1 → 2.0.02020-05-05

PHP version history (4 changes)1.0.0PHP &gt;=5.6.0

1.1.0PHP ~7.0

2.0.0PHP &gt;=7.3

2.2.0PHP &gt;=7.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/7441f1c0c4066b13108d5a5381fac0c548008328a90b7a55b6e5b00ef95a4c92?d=identicon)[mybuilder](/maintainers/mybuilder)

---

Top Contributors

[![eddmann](https://avatars.githubusercontent.com/u/801020?v=4)](https://github.com/eddmann "eddmann (12 commits)")[![angelsk](https://avatars.githubusercontent.com/u/606510?v=4)](https://github.com/angelsk "angelsk (11 commits)")[![rainerkraftmb](https://avatars.githubusercontent.com/u/11923165?v=4)](https://github.com/rainerkraftmb "rainerkraftmb (6 commits)")[![gavinlove](https://avatars.githubusercontent.com/u/308682?v=4)](https://github.com/gavinlove "gavinlove (4 commits)")[![maxbaldanza](https://avatars.githubusercontent.com/u/2786820?v=4)](https://github.com/maxbaldanza "maxbaldanza (3 commits)")[![CyExy](https://avatars.githubusercontent.com/u/179921?v=4)](https://github.com/CyExy "CyExy (1 commits)")

---

Tags

bundlephpsupervisordsymfonysymfony-bundlesupervisorsupervisord

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/mybuilder-supervisor-bundle/health.svg)

```
[![Health](https://phpackages.com/badges/mybuilder-supervisor-bundle/health.svg)](https://phpackages.com/packages/mybuilder-supervisor-bundle)
```

###  Alternatives

[simplesamlphp/simplesamlphp

A PHP implementation of a SAML 2.0 service provider and identity provider.

1.1k12.4M193](/packages/simplesamlphp-simplesamlphp)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.3M152](/packages/sulu-sulu)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[ec-cube/ec-cube

EC-CUBE EC open platform.

78527.0k1](/packages/ec-cube-ec-cube)[crunzphp/crunz

Schedule your tasks right from the code.

2292.0M6](/packages/crunzphp-crunz)[contao/core-bundle

Contao Open Source CMS

1231.6M2.4k](/packages/contao-core-bundle)

PHPackages © 2026

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