NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2986 most downloaded on Packagist
RoadRunner integration package
Latest stable
v4.1.0
Last release 1 months ago
21 Oct 2026
Release timing varies
gaps range from 4 weeks to 9 months
Nearly every release is documented
notes for 33 of 34 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
43 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
Fix Code Style CI and re-run it
Remove deprecations by @roxblnfk in https://github.com/spiral/roadrunner-bridge/pull/121
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v3.6.0...v4.0.0
Full integration with interceptors of Spiral v3.14. In interceptors, you can interact with the request context, modify the input, handle the output, a
Full integration with interceptors of Spiral v3.14. In interceptors, you can interact with the request context, modify the input, handle the output, and perform any actions just before calling the target method.
Added support for container scopes. Each worker will open the corresponding scopes immediately after initialization (dispatcher scope) and before running interceptors (context scope).
Dispatcher scopes are used to limit service bindings. Contextu scopes limits the context. For example, in the HTTP module, the context is ServerRequestInterface from PSR-7. Corresponding contexts have been added for the others as well.
HTTP:
http - dispatcher scopehttp-request - context scope\Psr\Http\Message\ServerRequestInterface - context classCentrifugo:
centrifugo - dispatcher scopecentrifugo-request - context scope\RoadRunner\Centrifugo\Request\RequestInterface - context classgRPC (server):
grpc - dispatcher scopegrpc-request - context scope\Spiral\RoadRunnerBridge\GRPC\UnaryCallInterface - context classQueue:
queue - dispatcher scopequeue-task - context scope\Spiral\Queue\TaskInterface - context classTCP:
tcp - dispatcher scopetcp-request - context scope\Spiral\RoadRunner\Tcp\RequestInterface - context classThe worker initialization time has been significantly optimized by using tokenizer listeners when searching for gRPC services.
The responsibility for making client gRPC calls has been moved to the spiral/grpc-client package, which is included by default.
Generating client classes is no longer required, as spiral/grpc-client generates the necessary proxy classes at runtime.
That's why all the extra generators (BootloaderGenerator, ConfigGenerator, ClientGenerator) and client-related classes have been removed from this package.
To configure spiral/grpc-client, a client section has been added to the gRPC configuration:
return [
// File 'app/config/grpc.php'
// ... other options ...
'client' => new GrpcClientConfig(
interceptors: [
SetTimoutInterceptor::createConfig(6_000),
RetryInterceptor::createConfig(
maximumAttempts: 1,
),
ExecuteServiceInterceptors::class,
],
services: [
new \Spiral\Grpc\Client\Config\ServiceConfig(
connections: ConnectionConfig::createInsecure('localhost:9001'),
interfaces: [
\GRPC\Mailer\MailerServiceInterface::class,
\GRPC\Mailer\PingerServiceInterface::class,
],
),
],
)
];
Refer to the spiral/grpc-client documentation for more information.
Full integration with interceptors of Spiral v3.14. In interceptors, you can interact with the request context, modify the input, handle the output, a
<details>
Full integration with interceptors of Spiral v3.14. In interceptors, you can interact with the request context, modify the input, handle the output, and perform any actions just before calling the target method.
Added support for container scopes. Each worker will open the corresponding scopes immediately after initialization (dispatcher scope) and before running interceptors (context scope).
Dispatcher scopes are used to limit service bindings. Contextu scopes limits the context. For example, in the HTTP module, the context is ServerRequestInterface from PSR-7. Corresponding contexts have been added for the others as well.
HTTP:
http - dispatcher scopehttp.request - context scope\Psr\Http\Message\ServerRequestInterface - context classCentrifugo:
centrifugo - dispatcher scopecentrifugo.request - context scope\RoadRunner\Centrifugo\Request\RequestInterface - context classgRPC (server):
grpc - dispatcher scopegrpc.request - context scope\Spiral\RoadRunnerBridge\GRPC\UnaryCallInterface - context classQueue:
queue - dispatcher scopequeue.task - context scope\Spiral\Queue\TaskInterface - context classTCP:
tcp - dispatcher scopetcp.request - context scope\Spiral\RoadRunner\Tcp\RequestInterface - context classThe worker initialization time has been significantly optimized by using tokenizer listeners when searching for gRPC services.
The responsibility for making client gRPC calls has been moved to the spiral/grpc-client package, which is included by default.
Generating client classes is no longer required, as spiral/grpc-client generates the necessary proxy classes at runtime.
That's why all the extra generators (BootloaderGenerator, ConfigGenerator, ClientGenerator) and client-related classes have been removed from this package.
To configure spiral/grpc-client, a client section has been added to the gRPC configuration:
return [
// File 'app/config/grpc.php'
// ... other options ...
'client' => new GrpcClientConfig(
interceptors: [
SetTimoutInterceptor::createConfig(6_000),
RetryInterceptor::createConfig(
maximumAttempts: 1,
),
ExecuteServiceInterceptors::class,
],
services: [
new \Spiral\Grpc\Client\Config\ServiceConfig(
connections: ConnectionConfig::createInsecure('localhost:9001'),
interfaces: [
\GRPC\Mailer\MailerServiceInterface::class,
\GRPC\Mailer\PingerServiceInterface::class,
],
),
],
)
];
Refer to the spiral/grpc-client documentation for more information.
</details>
Remove deprecations by @roxblnfk in https://github.com/spiral/roadrunner-bridge/pull/121
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-RC6...v4.0.0-RC7
Fix handling RoadRunner Worker Exit command by @roxblnfk in https://github.com/spiral/roadrunner-bridge/pull/118
[$request] instead of ['request' => $request]Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-RC5...v4.0.0-RC6
Make implementations internal by @roxblnfk in https://github.com/spiral/roadrunner-bridge/pull/115 All the internal implementations were marked with t
@internal annotation and moved into Internal namespaces.[!NOTE] If there are files affected here that you use directly in your project, please open an issue.
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-RC4...v4.0.0-RC5
Handler log level and bubble by @gam6itko in https://github.com/spiral/roadrunner-bridge/pull/114
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-RC3...v4.0.0-RC4
Update Logger Handler by @thebbstudio in https://github.com/spiral/roadrunner-bridge/pull/112 \ New constants added:
RR_LOGGER_PREFIXRR_LOGGER_MODE with RoadRunnerLogsMode enum with cases development and productionFull Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-RC2...v4.0.0-RC3
Logger Handler: fix Alert and Emergency levels by @Kaspiman in https://github.com/spiral/roadrunner-bridge/pull/109
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-RC1...v4.0.0-RC2
## What was changed - Sync with Spiral 3.14 Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-alpha2...v4.0.0-RC1
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v4.0.0-alpha2...v4.0.0-RC1
Add Distributed Locking to Prevent Race Conditions in Pipeline Declaration by @butschster in https://github.com/spiral/roadrunner-bridge/pull/116
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v3.7.0...v3.8.0
Support Container scopes by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/101
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v3.6.2...v3.7.0
Change log level from error to warning for pipeline declarations when a pipeline with the same name already exists by @butschster in https://github.co
error to warning for pipeline declarations when a pipeline with the same name already exists by @butschster in https://github.com/spiral/roadrunner-bridge/pull/107proto_path params order in a protoc command when PHP classes are generated by @roxblnfk in https://github.com/spiral/roadrunner-bridge/pull/106Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v3.6.1...v3.6.2
TCP: clear error variable before next request by @roxblnfk in https://github.com/spiral/roadrunner-bridge/pull/105
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v3.6.0...v3.6.1
Inject interceptors to a GRPC clients by @butschster in https://github.com/spiral/roadrunner-bridge/pull/103
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/v3.5.0...v3.6.0
Added support for spiral/roadrunner-tcp v4.0.0. by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/102
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.4.0...v3.5.0
Add support for monolog/monolog 3.x by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/98
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.3.1...3.4.0
Adding Exception handling when searching for a handler by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/96
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.3.0...3.3.1
Enhancements to Centrifugo Handler Class Generator by @butschster in https://github.com/spiral/roadrunner-bridge/pull/95
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.2.0...3.3.0
RoadRunner Lock Plugin Integration by @butschster in https://github.com/spiral/roadrunner-bridge/pull/94
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.1.0...3.2.0
[queue] Payload Type Detector for Enhanced Payload Data Deserialization by @butschster in https://github.com/spiral/roadrunner-bridge/pull/81
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.0.2...3.1.0
Remove abandoned package by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/88
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.0.1...3.0.2
Adding the ability to generate TCP service and Centrifugo handler via Scaffolder by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/80
initServices method generation by @MeidoNoHitsuji in https://github.com/spiral/roadrunner-bridge/pull/83Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/3.0.0...3.0.1
Updates spiral/roadrunner-jobs package up to 4.0 version
spiral/roadrunner-jobs package up to 4.0 versionspiral/serializer component to deserialize it.return [
'default' => env('QUEUE_CONNECTION', 'roadrunner'),
'connections' => [
'in-memory' => [
'driver' => 'roadrunner',
'pipeline' => 'memory', // <======= Pipeline that will be used in connection
],
],
'defaultSerializer' => 'closure',
'pipelines' => [ // <=============== Pipelines section
'memory' => [
'connector' => new MemoryCreateInfo('local'),
'consume' => true,
],
],
];
Adds earlier declaration of pipelines with consuming.
consume=true declaration, it will be declared automatically during application bootstrapping.rr:jobs:consume console command declares a pipeline if it wasn't declared and there is a declaration in config for it
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.6.0...3.0.0
Updates console commands for queue and cache component by @butschster in https://github.com/spiral/roadrunner-bridge/pull/68
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.5.1...2.6.0
Fixed OptionsInterface assert by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/66
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.5.0...2.5.1
Added the ability to define default options in the pipeline config by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/65
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.4.0...2.5.0
Adding the ability to generate client, config, bootloader in the GRPC by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/58
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.3.2...2.4.0
Fixes problem with making cache storage with container factory. by @butschster in https://github.com/spiral/roadrunner-bridge/pull/57
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.3.1...2.3.2
Replace MonologBootloader with RoadRunnerBootloader in LoggerBootloader dependencies by @kastahov in https://github.com/spiral/roadrunner-bridge/pull/
Protoc plugin binary was not found... by @kastahov in https://github.com/spiral/roadrunner-bridge/pull/53Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.3.0...2.3.1
Added integration with centrifuge RoadRunner plugin by @butschster in https://github.com/spiral/roadrunner-bridge/pull/43
Warning RoadRunner supports centrifuge since v2.12.0-beta.1 You can download it using
spiral/roadrunner-clipackage./vendor/bin/rr get -s RC
Spiral\RoadRunnerBridge\GRPC\ProtoRepository\ProtoFilesRepositoryInterface by @kastahov in https://github.com/spiral/roadrunner-bridge/pull/49generatedPath and servicesBasePath to GRPC config by @kastahov in https://github.com/spiral/roadrunner-bridge/pull/48Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.2.0...2.3.0
Added grpc interceptors by @kastahov in https://github.com/spiral/roadrunner-bridge/pull/41
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.1.0...2.2.0
Added headers in the context by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/35
Is active in the roadrunner:list command by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/39Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.0.1...2.1.0
Adds support for spiral/roadrunner-kv:^3.0 by @butschster in https://github.com/spiral/roadrunner-bridge/pull/30
spiral/roadrunner-kv:^3.0 by @butschster in https://github.com/spiral/roadrunner-bridge/pull/30laminas/laminas-diactoros by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/33Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.0.0...2.0.1
Added integration with SF serializer by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/14
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/1.1.0...2.0.0
Added RoadRunner metrics support by @butschster in https://github.com/spiral/roadrunner-bridge/pull/21
Add Spiral\RoadRunnerBridge\Bootloader\MetricsBootloader to application bootloaders list:
use Spiral\RoadRunnerBridge\Bootloader as RoadRunnerBridge;
protected const LOAD = [
// ...
RoadRunnerBridge\MetricsBootloader::class,
// ...
];
First, you have to register a metric in your configuration file:
metrics:
address: localhost:2112
collect:
app_metric_counter:
type: counter
help: "Application counter."
or declare metrics in PHP code
use Spiral\RoadRunner\Metrics\MetricsInterface;
use Spiral\RoadRunner\Metrics\Collector;
class AppBootloader extends Bootloader
{
//...
public function boot(MetricsInterface $metrics): void
{
$metrics->declare(
'app_metric_counter',
Collector::counter()->withHelp('Application counter.')
);
}
}
// file app/app/config/queue.php
return [
'defaultSerializer' => \Spiral\Queue\PhpSerializer::class,
// ...
'registry' => [
'serializers' => [
\App\Job\Ping::class => \Spiral\Queue\PhpSerializer::class,
// other ways
// \App\Job\Ping::class => new \Spiral\Queue\PhpSerializer(),
// \App\Job\Ping::class => new \Spiral\Core\Container\Autowire(\Spiral\Queue\PhpSerializer::class),
]
],
];
Warning Queue serializers configuration will only work with Spiral Framework 2.14
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/1.2.0...1.3.0
Adds an ability to connect to a pipeline without configuration. by @butschster in https://github.com/spiral/roadrunner-bridge/pull/18
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/1.1.0...1.2.0
Adding TCP support by @msmakouz in https://github.com/spiral/roadrunner-bridge/pull/12
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/1.0.0...1.1.0
Nothing published for this version
Adds an ability to connect to a pipeline without configuration. by @butschster in https://github.com/spiral/roadrunner-bridge/pull/18
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.0-beta1...2.0-beta2
Adds RoadRunnerMode enum by @butschster in https://github.com/spiral/roadrunner-bridge/pull/15
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.0-beta...2.0-beta1
Added support for Spiral Framework 3.0
Full Changelog: https://github.com/spiral/roadrunner-bridge/compare/2.0.0...2.0-beta
One column per quarter.