mtdowling / php-supervisor-event

PHP classes for interacting with Supervisor event notifications

PHP Supervisor Event Framework

Receives event notifications from Supervisor and sends the parsed notification to a callback function.

Requirements

• PHP 5.3
• Supervisord

Installation

The recommended installation method is through Composer.

1. Add mtdowling/supervisor-event as a dependency in your project's composer.json file:

    {
        "require": {
            "mtdowling/supervisor-event": "*"
        }
    }
   

2. Download and install Composer:

    curl -s http://getcomposer.org/installer | php
   

3. Install your dependencies:

    php composer.phar install
   

4. Require Composer's autoloader

   Composer also prepares an autoload file that's capable of autoloading all of the classes in any of the libraries that it downloads. To use it, just add the following line to your code's bootstrap process:

    require 'vendor/autoload.php';
   

You can find out more on how to install Composer, configure autoloading, and other best-practices for defining dependencies at getcomposer.org.

Example event script

<?php

// include the composer autoloader
require_once __DIR__ . '/vendor/autoload.php';

use Mtdowling\Supervisor\EventListener;
use Mtdowling\Supervisor\EventNotification;

$listener = new EventListener();
$listener->listen(function(EventListener $listener, EventNotification $event) {
    $listener->log($event->getEventName());
    $listener->log($event->getServer());
    $listener->log($event->getPool());
    // Try messing around with supervisorctl to restart processes and see what
    // data is available
    $listener->log(var_export($event->getData(), true));
    return true;
});

Running the example

Open your supervisord.conf file and add the following:

[eventlistener:event_listener]
command=php /path/to/examples/log.php
process_name=%(program_name)s_%(process_num)02d
numprocs=1
events=PROCESS_STATE_STARTING,TICK_5
autostart=true
autorestart=unexpected

Replace /path/to with the correct path. More event listener options can be found at http://supervisord.org/events.html

Now run:

supervisorctl reload

php-supervisor-event's Issues

malformed stdin message

Introduction :

From the example provided, i have notice malformed event on stdin from Supervisord

Instead of receiving message like :
ver:3.0 server:supervisor serial:51 pool:monitoring poolserial:51 eventname:PROCESS_STATE_RUNNING len:76

i was received
]

On my following case, my monitored process throw an exception which are writed on stderr.
My eventListener must be informed and send me back a notification.

Way to reproduce :

My supervisor configuration looks like :

[program:myProgram]
command=/usr/local/bin/php /path/to/my/script.php
stdout_logfile=/path/to/my/logs/myProgram.stdout.log
stderr_logfile=/path/to/my/logs/myProgram.stderr.log
numprocs=2
process_name=%(program_name)s_%(process_num)02d
numprocs_start=1
autostart=true
autorestart=true
stderr_events_enabled=true

[eventlistener:monitoring]
command=/usr/local/bin/php /path/to/my/monitoring.php
process_name=%(program_name)s_%(process_num)02d
numprocs=1

stdout_logfile=/path/to/my/logs/monitoring.stdout.log
stderr_logfile=/path/to/my/logs/monitoring.stderr.log

events=PROCESS_STATE,PROCESS_LOG_STDERR
autostart=true
autorestart=unexpected

and my testing script.php

<?php 
sleep(10);
throw new Exception("foo");

Laravel Integration

How to integrate this with Laravel framework default event service provider.
Please help.