indigophp/supervisor-event

Listen to Supervisor events in PHP

Indigo Supervisor Event

, _(*1)

Listen to Supervisor events in PHP., _(*2)

Install

Via Composer, _(*3)

``` bash $ composer require indigophp/supervisor-event, <sub>(*4)</sub>

## Usage

Supervisor has this pretty good feature: notify you(r listener) about it's events.

The main entry point is the `Listener`. `Listeners`s wait for a `Handler` in the main listening logic. `Handler`s get a `Notification` when an event occurs.


``` php
use Indigo\Supervisor\Event\Listener\Standard;
use Indigo\Supervisor\Event\Handler\Callback;
use Indigo\Supervisor\Event\Notification;

$handler = new Callback(function(Notification $notification) {
    echo $notification->getHeader('eventname');
});

$listener = new Standard;

$listener->listen($handler);

Currently available listeners:, <sub>(*5)</sub>

• Standard: Listents to standard input stream, writes to standard output
• Guzzle: Uses StreamInterface to provide an easy interface for reading/writting

Additionally you can use two exceptions to control the listeners itself:, <sub>(*6)</sub>

• Indigo\Supervisor\Exception\StopListener: indicates that the Listener should stop listening for further events.
• Indigo\Supervisor\Exception\EventHandlingFailed: indicates that handling the event failed, Listener should return with a FAIL response.

Any other unhandled exceptions/errors will cause the listener to stop., <sub>(*7)</sub>

Check the Supervisor docs for more about Events., <sub>(*8)</sub>

Testing

bash $ phpspec run, <sub>(*9)</sub>

Contributing

Please see CONTRIBUTING for details., <sub>(*10)</sub>

Credits

• Márk Sági-Kazár
• All Contributors

License

The MIT License (MIT). Please see License File for more information., <sub>(*11)</sub>