NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #977 most downloaded on Packagist
Base PHP worker for the RoadRunner application server: receives payloads over Goridge, sends responses and manages the worker pool
Latest stable
v3.8.2
Last release 1 months ago
19 Oct 2026
Release timing varies
gaps range from 9 days to 1.4 years
Most releases are documented
notes for 19 of 25 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
25 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
detect the RoadRunner version from roadrunner/roadrunner
require roadrunner/roadrunner instead of spiral/roadrunner
Your coding agent can read these notes before it upgrades. Set up the MCP server →
rename the package to roadrunner/worker
## 3.7.0 (2026-10-09) ### Features * support RoadRunner v3
Update dependencies by @roxblnfk in https://github.com/roadrunner-php/worker/pull/40
Full Changelog: https://github.com/roadrunner-php/worker/compare/v3.6.1...v3.6.2
fixed PHP 8.4 deprecations by @okorneliuk in https://github.com/roadrunner-php/worker/pull/39
Full Changelog: https://github.com/roadrunner-php/worker/compare/v3.6.0...v3.6.1
Added getVersion method to the Spiral\RoadRunner\Environment class by @Kaspiman in https://github.com/roadrunner-php/worker/pull/37
Spiral\RoadRunner\Environment class by @Kaspiman in https://github.com/roadrunner-php/worker/pull/37Full Changelog: https://github.com/roadrunner-php/worker/compare/v3.5.0...v3.6.0
Added the codec parameter to the worker's respond method by @msmakouz in https://github.com/roadrunner-php/worker/pull/36
codec parameter to the worker's respond method by @msmakouz in https://github.com/roadrunner-php/worker/pull/36Full Changelog: https://github.com/roadrunner-php/worker/compare/v3.4.0...v3.5.0
Added the getWorkers and countWorkers methods to the Spiral\RoadRunner\WorkerPool class. These methods allow retrieval of information about the plugin
Spiral\RoadRunner\WorkerPool class. These methods allow retrieval of information about the plugin workers in the pool and their count by @FluffyDiscord and @msmakouz in https://github.com/roadrunner-php/worker/pull/34, https://github.com/roadrunner-php/worker/pull/35Full Changelog: https://github.com/roadrunner-php/worker/compare/3.3.0...v3.4.0
Allow symfony/var-dumper 7.0 by @msmakouz in #32
Full Changelog: https://github.com/roadrunner-php/worker/compare/3.2.0...3.3.0
Dynamic Workers Scaling via RPC by @butschster in #31
Full Changelog: https://github.com/roadrunner-php/worker/compare/3.1.0...3.2.0
Implemented Ping-Pong strategy for worker with blocking relay when data is streaming by @roxblnfk in #30
Full Changelog: 3.0.0...3.1.0
Full Changelog: https://github.com/roadrunner-php/worker/compare/3.0.0...3.1.0
Please note that these changes may require updates to your existing code, so be sure to review the breaking changes before upgrading to version 3.0.0.
spiral/roadrunner:^2023Spiral\RoadRunner\WorkerInterface ChangesIt has been updated with two new methods:
hasPayload(string $class = null): boolgetPayload(string $class = null): ?PayloadIf your code uses Spiral\RoadRunner\WorkerInterface, you will need to update it to include these new methods.
Spiral\RoadRunne\Worker ChangesIt has been updated to include a new constructor argument, allowing for a custom logger to be set.
The constructor signature is now:
public function __construct(
private readonly RelayInterface $relay,
bool $interceptSideEffects = true,
private readonly LoggerInterface $logger = new Logger(), // <====== new argument
) {
...
}Spiral\RoadRunner\Payload ChangesIt has been marked as internal, which means that it can no longer be used directly by user code.
Additionally, the body and header properties have been marked as readonly, which means that they cannot be modified once set.
Spiral\RoadRunner\Exception\RoadRunnerException ChangesIt has been marked as final, which means that it can no longer be extended by user code. If your code extends it, you will need to update it to handle exceptions in a different way.
Please note that these changes may require updates to your existing code, so be sure to review the breaking changes before upgrading to version 3.0.0.
Full Changelog: v2.3.0...3.0.0
Adds centrifuge mode by @butschster in https://github.com/spiral/roadrunner-worker/pull/23
Full Changelog: https://github.com/spiral/roadrunner-worker/compare/v2.2.0...v2.3.0
Support for streamed output by @roxblnfk in https://github.com/spiral/roadrunner-worker/pull/22
Full Changelog: https://github.com/spiral/roadrunner-worker/compare/v2.1.5...v2.2.0
Nothing published for this version
Nothing published for this version
Nothing published for this version
Fix output interceptor (use direct output instead of psr-3)
Nothing published for this version
Added Mode::MODE_JOBS environment support
Mode::MODE_JOBS environment supportAdded RR_MODE environment variable enum
RR_MODE environment variable enumNothing published for this version
Nothing published for this version
HTTP worker extracted from the package
One column per quarter.