spiral/roadrunner-bridge
RoadRunner integration package
v3.8.0
2.2M downloads/mo
#1672 most downloaded on Packagist
spiral/roadrunner-bridge
What this package is like to depend on
Last release 9 months ago
25 Nov 2025
Ships fairly regularly
a new release about every 2 months
Rarely documented
notes for 2 of 32 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
41 releases · first in 2022
1 release in the last 12 months
see the full history below
Release timeline
41 releases · Feb 2022 to Nov 2025Releases
latest 41-
v4.0.0-alpha202 Sep 2024 pre-releaseRelease notes
Open source →Interceptors
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.Container Scopes
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 isServerRequestInterfacefrom PSR-7. Corresponding contexts have been added for the others as well.HTTP:
http- dispatcher scopehttp-request- context scope\Psr\Http\Message\ServerRequestInterface- context class
Centrifugo:
centrifugo- dispatcher scopecentrifugo-request- context scope\RoadRunner\Centrifugo\Request\RequestInterface- context class
gRPC (server):
grpc- dispatcher scopegrpc-request- context scope\Spiral\RoadRunnerBridge\GRPC\UnaryCallInterface- context class
Queue:
queue- dispatcher scopequeue-task- context scope\Spiral\Queue\TaskInterface- context class
TCP:
tcp- dispatcher scopetcp-request- context scope\Spiral\RoadRunner\Tcp\RequestInterface- context class
gRPC
Performance
The worker initialization time has been significantly optimized by using
tokenizer listeners
when searching for gRPC services.Client
The responsibility for making client gRPC calls has been moved to the
spiral/grpc-clientpackage, which is included by default.Generating client classes is no longer required, as
spiral/grpc-clientgenerates 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, aclientsection 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-clientdocumentation for more information. -
v4.0.0-alpha02 Aug 2024 pre-releaseNothing published for this version
-
v4.0.0-RC725 Nov 2025 pre-releaseRelease notes
Open source →What's Changed
- Nnormalize logs by @popkovkirill in #120
- Remove deprecations by @roxblnfk in #121
New Contributors
- @popkovkirill made their first contribution in #120
Full Changelog: v4.0.0-RC6...v4.0.0-RC7
-
v4.0.0-RC607 Jun 2025 pre-releaseRelease notes
Open source →What's Changed
- Fix handling RoadRunner Worker Exit command by @roxblnfk in #118
- Normalize TCP and Centrifugo interceptor arguments by @roxblnfk in #119
Now request is provided in non-assoc array like[$request]instead of['request' => $request]
Full Changelog: v4.0.0-RC5...v4.0.0-RC6
-
v4.0.0-RC518 Apr 2025 pre-releaseRelease notes
Open source →What's Changed
- Make implementations internal by @roxblnfk in #115
All the internal implementations were marked with the@internalannotation 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: v4.0.0-RC4...v4.0.0-RC5
- Make implementations internal by @roxblnfk in #115
-
v4.0.0-RC405 Mar 2025 pre-release -
v4.0.0-RC326 Feb 2025 pre-releaseRelease notes
Open source →What's Changed
- Update Logger Handler by @thebbstudio in #112
New constants added:RR_LOGGER_PREFIXRR_LOGGER_MODEwithRoadRunnerLogsModeenum with casesdevelopmentandproduction
New Contributors
- @thebbstudio made their first contribution in #112
Full Changelog: v4.0.0-RC2...v4.0.0-RC3
- Update Logger Handler by @thebbstudio in #112
-
v4.0.0-RC211 Dec 2024 pre-releaseRelease notes
Open source →What's Changed
- Logger Handler: fix Alert and Emergency levels by @Kaspiman in #109
- Maintenance (code style, PHP 8.4) by @roxblnfk in #110
New Contributors
Full Changelog: v4.0.0-RC1...v4.0.0-RC2
-
v4.0.0-RC102 Sep 2024 pre-releaseRelease notes
Open source → -
v3.8.005 Jun 2025Release notes
Open source →What's Changed
- Add Distributed Locking to Prevent Race Conditions in Pipeline Declaration by @butschster in #116
Full Changelog: v3.7.0...v3.8.0
-
v3.7.003 Sep 2024Release notes
Open source →What's Changed
- Support Container scopes by @msmakouz in #101
- Sync context scope names with Spiral 3.14 by @roxblnfk in #108
Full Changelog: v3.6.2...v3.7.0
-
v3.6.202 Aug 2024Nothing published for this version
-
v3.6.125 Jun 2024Nothing published for this version
-
v3.6.020 May 2024Nothing published for this version
-
v3.5.012 Apr 2024Nothing published for this version
-
3.4.003 Jan 2024Nothing published for this version
-
3.3.128 Dec 2023Nothing published for this version
-
3.3.021 Dec 2023Nothing published for this version
-
3.2.020 Dec 2023Nothing published for this version
-
3.1.012 Dec 2023Nothing published for this version
-
3.0.218 Oct 2023Nothing published for this version
-
3.0.110 Aug 2023Nothing published for this version
-
3.0.014 Apr 2023Nothing published for this version
-
2.6.028 Mar 2023Nothing published for this version
-
2.5.101 Mar 2023Nothing published for this version
-
2.5.024 Feb 2023Nothing published for this version
-
2.4.020 Feb 2023Nothing published for this version
-
2.3.216 Dec 2022Nothing published for this version
-
2.3.123 Nov 2022Nothing published for this version
-
2.3.018 Nov 2022Nothing published for this version
-
2.2.009 Nov 2022Nothing published for this version
-
2.1.021 Oct 2022Nothing published for this version
-
2.0.128 Sep 2022Nothing published for this version
-
2.0.013 Sep 2022Nothing published for this version
-
1.3.024 Aug 2022Nothing published for this version
-
1.2.021 Jul 2022Nothing published for this version
-
1.1.029 Apr 2022Nothing published for this version
-
1.0.003 Feb 2022Nothing published for this version
-
2.0-beta204 Aug 2022Nothing published for this version
-
2.0-beta128 Jun 2022Nothing published for this version
-
2.0-beta21 Jun 2022Nothing published for this version