NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2271 most downloaded on Packagist
PHP API for the RoadRunner Jobs (queues) plugin: manage pipelines, push tasks and consume them in workers
Latest stable
4.9.1
Last release 1 months ago
19 Oct 2026
Release timing varies
gaps range from 8 days to 11 months
Nearly every release is documented
notes for 32 of 35 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
37 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
require roadrunner/roadrunner instead of spiral/roadrunner
Your coding agent can read these notes before it upgrades. Set up the MCP server →
migrate tests to Testo, require PHP 8.2
feature: add ackwait config by @shellphy in https://github.com/roadrunner-php/jobs/pull/75
Full Changelog: https://github.com/roadrunner-php/jobs/compare/v4.6.3...v4.7.0
Optimize .gitattributes for smaller dist, delete non-existent files by @Kaspiman in https://github.com/roadrunner-php/jobs/pull/73
Full Changelog: https://github.com/roadrunner-php/jobs/compare/v4.6.2...v4.6.3
Fixed PHP 8.4 deprecations by @acelaya in https://github.com/roadrunner-php/jobs/pull/72
Full Changelog: https://github.com/roadrunner-php/jobs/compare/v4.6.1...v4.6.2
The redelivery option in the nack method has been fixed by @msmakouz in https://github.com/roadrunner-php/jobs/pull/71
Full Changelog: https://github.com/roadrunner-php/jobs/compare/v4.6.0...v4.6.1
Added support for the Google Pub/Sub driver. This driver is available since RoadRunner v2024.2.0.
Full Changelog: https://github.com/roadrunner-php/jobs/compare/v4.5.0...v4.6.0
Added support for ack, nack, and requeue methods, which were introduced in RoadRunner v2024.1.5 by @msmakouz in https://github.com/roadrunner-php/jobs
ack, nack, and requeue methods, which were introduced in RoadRunner v2024.1.5 by @msmakouz in https://github.com/roadrunner-php/jobs/pull/66topic parameter name in the AMQP driver configuration by @realization in https://github.com/roadrunner-php/jobs/pull/65Full Changelog: https://github.com/roadrunner-php/jobs/compare/v4.4.0...v4.5.0
Added support for RoadRunner v2024.1 by @msmakouz in https://github.com/roadrunner-php/jobs/pull/64
Full Changelog: https://github.com/roadrunner-php/jobs/compare/v4.3.1...v4.4.0
Changed the default value for the prefetch option in the Memory driver by @gam6itko in https://github.com/roadrunner-php/jobs/pull/62
prefetch option in the Memory driver by @gam6itko in https://github.com/roadrunner-php/jobs/pull/62Full Changelog: https://github.com/roadrunner-php/jobs/compare/4.3.0...v4.3.1
Add additional options when creating a pipeline by @msmakouz in #60
Full Changelog: 4.1.0...4.3.0
Full Changelog: https://github.com/roadrunner-php/jobs/compare/4.1.0...4.3.0
Feature: AMQP queue headers by @danilin-em in #59
Full Changelog: 4.0.1...4.2.0
Full Changelog: https://github.com/roadrunner-php/jobs/compare/4.0.1...4.2.0
feat(AMQP): Add Header constants for consistent AMQP header usage by @butschster in https://github.com/roadrunner-php/jobs/pull/58
Full Changelog: https://github.com/roadrunner-php/jobs/compare/4.0.0...4.0.1
Nothing published for this version
Added metapackage spiral/roadrunner:^2023
spiral/roadrunner:^2023It now allows application to implement their own serialization methods and send the payload as a string or an instance of a Stringable object.
by @butschster in https://github.com/roadrunner-php/jobs/pull/47
use Spiral\RoadRunner\Jobs\Queue\KafkaCreateInfo;
use Spiral\RoadRunner\Jobs\Queue\Kafka\ProducerOptions;
use Spiral\RoadRunner\Jobs\Queue\Kafka\ConsumerOptions;
use Spiral\RoadRunner\Jobs\Queue\Kafka\ConsumerGroupOptions;
$info = new KafkaCreateInfo(
name: 'foo',
priority: 10,
autoCreateTopicsEnable: false,
producerOptions: new ProducerOptions(...),
consumerOptions: new ConsumerOptions(...),
groupOptions: new ConsumerGroupOptions(...),
);
by @butschster in https://github.com/roadrunner-php/jobs/pull/51
Full Changelog: https://github.com/roadrunner-php/jobs/compare/v2.6.0...4.0.0
Removed opis/closure serializer by @msmakouz in https://github.com/spiral/roadrunner-jobs/pull/19
opis/closure serializer by @msmakouz in https://github.com/spiral/roadrunner-jobs/pull/19Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.3.0...v3.0.0
Adds consume_all option to the AMQPCreateInfo DTO by @butschster in https://github.com/spiral/roadrunner-jobs/pull/44
consume_all option to the AMQPCreateInfo DTO by @butschster in https://github.com/spiral/roadrunner-jobs/pull/44Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.8.1...v2.9.0
Update AMQPCreateInfo by @rauanmayemir in https://github.com/spiral/roadrunner-jobs/pull/42
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.8.0...v2.9.0
Added options to the create method by @msmakouz in https://github.com/spiral/roadrunner-jobs/pull/39
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.7.0...v2.8.0
Adding ReceivedTaskFactory, adding KafkaReceivedTask by @msmakouz in https://github.com/spiral/roadrunner-jobs/pull/36
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.6.0...v2.7.0
Adding headers to Options by @msmakouz in https://github.com/spiral/roadrunner-jobs/pull/27
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.5.1...v2.6.0
Fixes problem with receiving empty payload body. by @butschster in https://github.com/spiral/roadrunner-jobs/pull/25
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.5.0...v2.5.1
Mark Jobs::isAvailable method as deprecated. by @butschster in https://github.com/spiral/roadrunner-jobs/pull/23
Jobs::isAvailable method as deprecated. by @butschster in https://github.com/spiral/roadrunner-jobs/pull/23Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.4.0...v2.5.0
Adds support for kafka and boltdb pipelines by @butschster and @msmakouz in https://github.com/spiral/roadrunner-jobs/pull/22
kafka pipelineuse Spiral\RoadRunner\Jobs\Queue\KafkaCreateInfo;
use Spiral\RoadRunner\Jobs\Jobs;
$jobs = new Jobs(RPC::create('tcp://127.0.0.1:6001'));
$kafkaCreateInfo = new KafkaCreateInfo(
name: 'kafka-queue',
topic: 'subscription',
maxOpenRequests: 1000
);
$queue = $jobs->create($kafkaCreateInfo);
kafka pipelineuse Spiral\RoadRunner\Jobs\KafkaOptions;
use Spiral\RoadRunner\Jobs\Queue\Kafka\PartitionOffset;
$queue->dispatch(
$queue->create(
'job:name',
['foo' => 'bar'],
new KafkaOptions(
topic: 'some-topic',
metadata: 'foo-bar',
offset: PartitionOffset::OFFSET_NEWEST
)
)
);
$queue = $jobs->create($kafkaCreateInfo);
$task = $queue->create(
'job:name',
['foo' => 'bar'],
new KafkaOptions(
topic: 'some-topic',
metadata: 'foo-bar',
offset: PartitionOffset::OFFSET_NEWEST
)
);
$queue->dispatch($task->withOptions(new KafkaOptions(
topic: 'other',
metadata: 'foo-bar',
offset: PartitionOffset::OFFSET_NEWEST
)));
$queue->dispatch($task->withOptions($task->getOptions()->withTopic('other')));
$queue->dispatch($task->withDelay(10));
boltdb pipelineuse Spiral\RoadRunner\Jobs\Queue\BoltdbCreateInfo;
use Spiral\RoadRunner\Jobs\Jobs;
$jobs = new Jobs(RPC::create('tcp://127.0.0.1:6001'));
$boltdbCreateInfo = new BoltdbCreateInfo(
name: 'boltdb-queue',
file: 'rr.db'
);
$queue = $jobs->create($boltdbCreateInfo);
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.3.2...v2.4.0
Fixes default task priority in a queue. by @butschster in https://github.com/spiral/roadrunner-jobs/pull/21
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.3.1...v2.3.2
RR jobs plugin requires string map by @rauanmayemir in https://github.com/spiral/roadrunner-jobs/pull/20
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.3.0...v2.3.1
Allow to define durable queue info property by @kafkiansky in https://github.com/spiral/roadrunner-jobs/pull/17
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.2.0...v2.3.0
Adds support for NATS create info by @butschster in https://github.com/spiral/roadrunner-jobs/pull/16
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.1.1...v2.2.0
Nothing published for this version
Added auto_ack option to the Job class by @butschster in https://github.com/spiral/roadrunner-jobs/pull/14
auto_ack option to the Job class by @butschster in https://github.com/spiral/roadrunner-jobs/pull/14use Spiral\RoadRunner\Jobs\Queue\MemoryCreateInfo;
use Spiral\RoadRunner\Jobs\Options;
use Spiral\RoadRunner\Jobs\Jobs;
// Create with default values
$options = new Options();
// Jobs service
$jobs = new Jobs(RPC::create('tcp://127.0.0.1:6001'));
// Select "test" queue from jobs
$queue = $jobs->connect('test');
// or create a new queue
$queue = $jobs->create(new MemoryCreateInfo('local'));
// Set default auto ack for all tasks
$queue = $queue->withDefaultOptions(
$options->withAutoAck(true)
);
// Create a new task with custom auto ack
$task = $queue->push(
'task_name',
['foo' => 'bar'],
(new Options())->withAutoAck(false)
);
// or change auto ack for created task
$task = $queue->create(
'task_name',
['foo' => 'bar']
)->withAutoAck(false);
$queue->dispatch($task);
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.0.5...v2.1.0
Fixes problem with queue "is paused" state checking by @butschster in https://github.com/spiral/roadrunner-jobs/pull/12
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.0.4...v2.0.5
dont send the empty headers to RR by @sergey-telpuk in https://github.com/spiral/roadrunner-jobs/pull/11
Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.0.2...v2.0.4
Replace queue key with name by @roxblnfk in https://github.com/spiral/roadrunner-jobs/pull/7
queue key with name by @roxblnfk in https://github.com/spiral/roadrunner-jobs/pull/7Full Changelog: https://github.com/spiral/roadrunner-jobs/compare/v2.0.0...v2.0.1
Nothing published for this version
Rename "ephemeral" to "memory" driver and constants.
Initial release of RoadRunner Jobs plugins api library.
One column per quarter.