websoftwares/monolog-zmq-handler

Sends your logs over a ZeroMQ (ØMQ) socket.

MonologZMQHandler (v0.2.2)

This package lets u send your Monolog logs over a ZeroMQ (ØMQ) socket., _(*1)

, _(*2)

System requirements

ZeroMQ library needs to be available on your system on Ubuntu easily install with APT package manager:, _(*3)

sudo apt-get install libzmq3 libzmq3-dev

The PHP ZeroMQ extension is required follow the installation from the zeromq guide., _(*4)

Installing via Composer (recommended)

Install composer in your project:, _(*5)

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

Create a composer.json file in your project root:, _(*6)

{
    "require": {
        "websoftwares/monolog-zmq-handler": ~2.0"
    }
}

Install via composer, _(*7)

php composer.phar install

Usage

Basic usage of the ZMQHandler class., _(*8)

use Websoftwares\Monolog\Handler\ZMQHandler;
use Monolog\Logger;

// Create ZeroMQ PUB socket
$context = new \ZMQContext();
$publisher = new \ZMQSocket($context, ZMQ::SOCKET_PUB);
$publisher->bind("tcp://*:5556");

// Create new handler class instance
// First argument is an instance of \ZMQSocket type PUSH OR PUB
// Second argument \ZMQ::MODE_*
// Thirth argument set to true wil make the first message the log channel. (multipart)
// Default operation is \ZMQ::MODE_DONTWAIT
$handler = new ZMQHandler($publisher, \ZMQ::MODE_SNDMORE, true); 

// Create new logger instance
$log = new Logger('channelName');
$log->pushHandler($handler);

// Log something
$log->addWarning("Something is going wrong...");

Examples

in the examples/ folder u can find some basic examples for PUB/SUB and PUSH/PULL, _(*9)

PUB/SUB, _(*10)

php publisher.php
php subscriber.php

PUSH/PULL, _(*11)

php pusher.php
php puller.php

Changelog

• v0.2.0: Allowing multiple \ZMQ::MODE_* options thx for @reenl pointing this out.
• v0.1.0: Initial

Testing

In the tests folder u can find several tests., _(*12)

Acknowledgement

The logging package Monolog developers., _(*13)

License

The MIT License (MIT)., _(*14)