linio/queue

Abstracts work queues, used to distribute time-consuming tasks among multiple workers.

Linio Queue

, _(*1)

Linio Queue abstracts work queues, used to distribute time-consuming tasks among multiple workers., _(*2)

Install

The recommended way to install Linio Queue is through composer., _(*3)

{
    "require": {
        "linio/queue": "~3.0"
    }
}

Tests

To run the test suite, you need install the dependencies via composer, then run PHPUnit., _(*4)

$ composer install
$ phpunit

Usage

The library is very easy to use: first, you have to register the service. For Silex, a service provider is included. Just register it:, _(*5)

<?php

use Linio\Component\Queue\QueueService;
use Linio\Component\Queue\Adapter;

$queue = new QueueService();
$queue->setAdapter(new Adapter\RabbitAdapter([
    'host' => 'localhost',
    'port' => 5672,
    'username' => 'guest',
    'password' => 'guest',
    'vhost' => '/'
]));

In order to create a work queue, you must extend the abstract class Job:, _(*6)

<?php

use Linio\Component\Queue\Job;

class HelloWorldJob extends Job
{
    public function perform()
    {
        echo sprintf("Hello %s!\n", $this->payload);
        $this->finish();
    }
}

Note that you must always finish() a job to remove it from the queue. You can also fail() jobs. Now, in order to publish messages to a work queue:, _(*7)

<?php

use Linio\Component\Queue\QueueService;

$queue = new QueueService();
$queue->add(new HelloWorldJob('John')); // "John" is the payload

And to consume messages from the work queue:, _(*8)

<?php

use Linio\Component\Queue\QueueService;

$queue = new QueueService();
$queue->perform(new HelloWorldJob());