PHPackages                             indigophp/supervisor - 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. [DevOps &amp; Deployment](/categories/devops)
4. /
5. indigophp/supervisor

Abandoned → [supervisorphp/supervisor](/?search=supervisorphp%2Fsupervisor)ArchivedLibrary[DevOps &amp; Deployment](/categories/devops)

indigophp/supervisor
====================

PHP library for Supervisor

v3.0.0(11y ago)2619.2k↓62.5%22MITPHPPHP &gt;=5.4.0

Since Dec 16Pushed 11y ago1 watchersCompare

[ Source](https://github.com/indigophp-archive/supervisor)[ Packagist](https://packagist.org/packages/indigophp/supervisor)[ Docs](https://indigophp.com)[ RSS](/packages/indigophp-supervisor/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (8)Dependencies (8)Versions (15)Used By (2)

> **DEPRECATION NOTICE**

> This package has been moved under SupervisorPHP.

>

> For details see

Indigo Supervisor
=================

[](#indigo-supervisor)

[![Latest Version](https://camo.githubusercontent.com/b3c1fa016c05cbb927857e7247b4222e099847f39518b2cb9de20181be0fe29b/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f72656c656173652f696e6469676f7068702f73757065727669736f722e7376673f7374796c653d666c61742d737175617265)](https://github.com/indigophp/supervisor/releases)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE)[![Build Status](https://camo.githubusercontent.com/1aeb43e2fc64e72daaac9b922b9af3014c03f9a0cd89f0814d286e38186e69e1/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f696e6469676f7068702f73757065727669736f722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/indigophp/supervisor)[![Code Coverage](https://camo.githubusercontent.com/ce641d3d44a65324742929f8ddd1e02d9a5511b26ebaf24e45a4f6517ee53105/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f636f7665726167652f672f696e6469676f7068702f73757065727669736f722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/indigophp/supervisor)[![Quality Score](https://camo.githubusercontent.com/53112c9338f5414301ec9ac6b190f5585a25d77966cf6889e59a0b89c8744dc2/68747470733a2f2f696d672e736869656c64732e696f2f7363727574696e697a65722f672f696e6469676f7068702f73757065727669736f722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/indigophp/supervisor)[![HHVM Status](https://camo.githubusercontent.com/c27ec776c0d211381e5d6469b124b6df69b93bc1f6718624284f5a486bd20a23/68747470733a2f2f696d672e736869656c64732e696f2f6868766d2f696e6469676f7068702f73757065727669736f722e7376673f7374796c653d666c61742d737175617265)](http://hhvm.h4cc.de/package/indigophp/supervisor)[![Total Downloads](https://camo.githubusercontent.com/76c2f6a17c1f7ec00a2f239e27fbef1cacae7935a8147142b2018a53181353fe/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f696e6469676f7068702f73757065727669736f722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/indigophp/supervisor)[![Dependency Status](https://camo.githubusercontent.com/cca6cf8382b0154353aef42f73c4de2245e1b621eaba117ed4dfa7f15b483d48/68747470733a2f2f696d672e736869656c64732e696f2f76657273696f6e6579652f642f7068702f696e6469676f7068703a73757065727669736f722e7376673f7374796c653d666c61742d737175617265)](https://www.versioneye.com/php/indigophp:supervisor)

**PHP library for managing supervisord through XML-RPC API.**

Install
-------

[](#install)

Via Composer

```
$ composer require indigophp/supervisor
```

Usage
-----

[](#usage)

```
use Indigo\Supervisor\Supervisor;
use Indigo\Supervisor\Connector\XmlRpc;
use fXmlRpc\Client;
use fXmlRpc\Transport\Guzzle4Bridge;

// Pass the url and the bridge to the XmlRpc Client
$client = new Client(
	'http://127.0.0.1:9001/RPC2',
	new Guzzle4Bridge(new \GuzzleHttp\Client(['defaults' => ['auth' => ['user', '123']]]))
);

// Pass the client to the connector
// See the full list of connectors bellow
$connector = new XmlRpc($client);

$supervisor = new Supervisor($connector);

// returns Process object
$process = $supervisor->getProcess('test_process');

// returns array of process info
$supervisor->getProcessInfo('test_process');

// same as $supervisor->stopProcess($process);
$supervisor->stopProcess('test_process');

// Don't wait for process start, return immediately
$supervisor->startProcess($process, false);

// returns true if running
// same as $process->checkState(Process::RUNNING);
$process->isRunning();

// returns process name
echo $process;

// returns process information
$process->getPayload();
```

**Currently available connectors:**

- [fXmlRpc](https://github.com/lstrojny/fxmlrpc)
- Zend XML-RPC

**Note:** fXmlRpc can be used with several HTTP Clients. See the list on it's website. This is the reason why Client specific connectors has been removed.

### Authentication

[](#authentication)

As of version 3.0.0 `setCredentials` is no longer part of the `Connector` interface (meaning responsibility has been fully removed).You have to provide authentication data to the HTTP Client of your choice. (For example Guzzle supports it out-of-the-box) Also, Bridges implemented by fXmlRpc supports to set custom headers.

### Exception handling

[](#exception-handling)

For each possible fault response there is an exception. These exceptions extend a [common exception](src/Exception/Fault.php), so you are able to catch a specific fault or all. When an unknown fault is returned from the server, an instance if the common exception is thrown. The list of fault responses and the appropriate exception can be found in the class.

```
use Indigo\Supervisor\Exception\Fault;
use Indigo\Supervisor\Exception\Fault\BadName;

try {
	$supervisor->restart('process');
} catch (BadName $e) {
	// handle bad name error here
} catch (Fault $e) {
	// handle any other errors here
}
```

**For developers:** Fault exceptions are automatically generated, there is no need to manually modify them.

Configuration and Event listening
---------------------------------

[](#configuration-and-event-listening)

[Configuration](https://github.com/indigophp/supervisor-configuration) and [Event](https://github.com/indigophp/supervisor-event) components have been moved into their own repository. See [\#24](https://github.com/indigophp/supervisor/issues/24) for explanation.

Further info
------------

[](#further-info)

You can find the XML-RPC documentation here:

Notice
------

[](#notice)

If you use PHP XML-RPC extension to parse responses (which is marked as *EXPERIMENTAL*). This can cause issues when you are trying to read/tail log of a PROCESS. Make sure you clean your log messages. The only information I found about this is a [comment](http://www.php.net/function.xmlrpc-decode#44213).

You will also have to make sure that you always call the functions with correct parameters. `Zend` connector will trigger an error when incorrect parameters are passed. See [this](https://github.com/zendframework/zf2/issues/6455) issue for details. (Probably this won't change in near future based on my inspections of the code.) Other connectors will throw a `Fault` exception.

Bundles
-------

[](#bundles)

Here is a list of framework specific bundle packages:

- [HumusSupervisorModule](https://github.com/prolic/HumusSupervisorModule) *(Zend Framework 2)*
- [Fuel Supervisor](https://github.com/indigophp/fuel-supervisor) *(FuelPHP 1.x)*

Testing
-------

[](#testing)

```
$ phpspec run
```

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Credits
-------

[](#credits)

- [Márk Sági-Kazár](https://github.com/sagikazarmark)
- [All Contributors](https://github.com/indigophp/supervisor/contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE) for more information.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity35

Limited adoption so far

Community19

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 98.8% 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 ~32 days

Recently: every ~43 days

Total

13

Last Release

4144d ago

Major Versions

v1.2.1 → v2.0.02014-07-13

v2.0.2 → v3.0.0-alpha2014-10-07

PHP version history (3 changes)v1.0.0PHP &gt;=5.3.3

v3.0.0-alphaPHP &gt;=5.4

v3.0.0-beta2PHP &gt;=5.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/0e4e105cea62b616d4cb376b08a849b6a428f646998537de150d16a8eb537b90?d=identicon)[mark.sagikazar](/maintainers/mark.sagikazar)

![](https://www.gravatar.com/avatar/1585b5a08e138e348f5b646231d0f16cb2eae06501fb9462bbc97a794d4de84a?d=identicon)[TamasBarta](/maintainers/TamasBarta)

---

Top Contributors

[![sagikazarmark](https://avatars.githubusercontent.com/u/1226384?v=4)](https://github.com/sagikazarmark "sagikazarmark (492 commits)")[![prolic](https://avatars.githubusercontent.com/u/394428?v=4)](https://github.com/prolic "prolic (4 commits)")[![gl3n](https://avatars.githubusercontent.com/u/965689?v=4)](https://github.com/gl3n "gl3n (1 commits)")[![raulp](https://avatars.githubusercontent.com/u/3310232?v=4)](https://github.com/raulp "raulp (1 commits)")

---

Tags

supervisorprocess manager

###  Code Quality

TestsBehat

### Embed Badge

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

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

###  Alternatives

[deployer/deployer

Deployment Tool

11.1k25.4M207](/packages/deployer-deployer)[appwrite/server-ce

End to end backend server for frontend and mobile apps.

55.3k84.2k](/packages/appwrite-server-ce)[pragmarx/health

Laravel Server &amp; App Health Monitor and Notifier

2.0k1.0M2](/packages/pragmarx-health)[felixfbecker/language-server-protocol

PHP classes for the Language Server Protocol

22476.7M6](/packages/felixfbecker-language-server-protocol)[supervisorphp/supervisor

PHP library for managing Supervisor through XML-RPC API

2482.0M15](/packages/supervisorphp-supervisor)[heroku/heroku-buildpack-php

Toolkit for starting a PHP application locally, with or without foreman, using the same config for PHP and Apache2/Nginx as on Heroku

8161.3M10](/packages/heroku-heroku-buildpack-php)

PHPackages © 2026

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