indigophp/supervisor

PHP library for Supervisor

Wednesday, January 14, 2015
by mark.sagikazar
Repository
0 Watchers
0 Stars
10,081 Installations

4 Dependents
0 Suggesters
0 Forks
0 Open issues
15 Versions
0 % Grown

The README.md

Indigo Supervisor

, _(*1)

PHP library for managing supervisord through XML-RPC API., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require indigophp/supervisor, _(*4)



## Usage

``` php
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:, _(*5)

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., _(*6)

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., _(*7)

Exception handling

For each possible fault response there is an exception. These exceptions extend a common exception, 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., _(*8)

``` php use Indigo\Supervisor\Exception\Fault; use Indigo\Supervisor\Exception\Fault\BadName;, _(*9)

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


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


## 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

You can find the XML-RPC documentation here:
[http://supervisord.org/api.html](http://supervisord.org/api.html)


## 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

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

``` bash
$ phpspec run

Contributing

Please see CONTRIBUTING for details., _(*11)

Credits

License

The MIT License (MIT). Please see License File for more information., _(*12)

The Versions

14/01 2015

dev-develop

dev-develop https://indigophp.com

PHP library for Supervisor

library supervisor

PHP library for Supervisor

indigophp/supervisor

The README.md

Indigo Supervisor

Install

Authentication

Exception handling

Contributing

Credits

License

The Versions

dev-develop

The Requires

The Development Requires

by Márk Sági-Kazár

dev-master

The Requires

The Development Requires

by Márk Sági-Kazár

v3.0.0

The Requires

The Development Requires

by Márk Sági-Kazár

v3.0.0-beta2

The Requires

The Development Requires

by Márk Sági-Kazár

v3.0.0-beta

The Requires

The Development Requires

by Márk Sági-Kazár

v3.0.0-alpha

The Requires

The Development Requires

by Márk Sági-Kazár

v2.0.2

The Requires

The Development Requires

by Márk Sági-Kazár

v2.0.1

The Requires

The Development Requires

by Márk Sági-Kazár

v2.0.0

The Requires

The Development Requires

by Márk Sági-Kazár

v1.2.1

The Requires

The Development Requires

by Márk Sági-Kazár

v1.2.0

The Requires

The Development Requires

by Márk Sági-Kazár

v1.1.1

The Requires

The Development Requires

by Márk Sági-Kazár

v1.1.0

The Requires

The Development Requires

by Márk Sági-Kazár

v1.0.0

The Requires

The Development Requires

by Márk Sági-Kazár

v1.0-alpha

The Requires

by Márk Sági-Kazár