l5-stomp-queue

STOMP Queue and Broadcaster Driver for Laravel 5 and above.

Installation

In order to install l5-stomp-queue, just add

"mayconbordin/l5-stomp-queue": "dev-master"

to your composer.json. Then run composer install or composer update.

Add the Service Provider to the providers array in config/app.php:

'providers' => array(
    ...
    'Mayconbordin\L5StompQueue\StompServiceProvider',
)

And add the driver configuration to the connections array in config/queue.php:

'connections' => array(
    'stomp' => [
            'driver' => 'stomp',
            'broker_url' => env('STOMP_URL', 'tcp://localhost:61613'),
            'queue' => '/queue/MainQueueOfTheApplication',

            'stomp-config' => [
                'default-job' => DefaultDistributionJob::class,
                'disable-broadcaster' => true, // optional, default is false
                'disable-connector' => true, // optional, default is false
                'queues' => [
                    '/queue/Queue1' => QueueOneProcessing::class,
                    '/queue/Queue2' => QueueTwoProcessing::class,
                ],
            ],
            'system' => 'activemq',
            'username' => env('STOMP_USERNAME', null),
            'password' => env('STOMP_PASSWORD', null),
            'heartbeat_interval_ms' => env('STOMP_HEARTBEAT_INTERVAL', 10000),
        ],
)

And for the broadcaster add the same configuration to the connections array in config/broadcasting.php:

'connections' => array(
    'stomp' => [
        'driver'     => 'stomp',
        'broker_url' => 'tcp://localhost:61613',
        'queue'      => 'default',
        'system'     => 'activemq',
        'username'   => 'usernamehere',
        'password'   => 'passwordhere',
    ]
)

Configuration Options

queue

The name of the queue.

system

The name of the system that implements the Stomp protocol. Default: null.

This value is used for setting custom headers (not defined in the protocol). In the case of ActiveMQ, it will set the AMQ_SCHEDULED_DELAY (see docs) header in order to give support for the later method, defined at Illuminate\Contracts\Queue.

sync

Whether the driver should be synchronous or not when sending messages. Default: false.

prefetchSize

The number of messages that will be streamed to the consumer at any point in time. Applicable only to ActiveMQ. Default: 1.

For more information see the ActiveMQ documentation.

clientId

Used for durable topic subscriptions. It will set the activemq.subcriptionName property. See documentation for more information.

username and password

Used for connecting to the Stomp server.