NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2954 most downloaded on Packagist
Centrifugo bridge for RoadRunner: handle Centrifugo proxy events in PHP workers and call the Centrifugo server API over RPC
Latest stable
2.5.1
Last release 1 months ago
19 Oct 2026
Release timing varies
gaps range from 8 days to 1.1 years
Nearly every release is documented
notes for 10 of 10 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
10 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
require roadrunner/roadrunner instead of spiral/roadrunner
rename the package to roadrunner/centrifugo
Your coding agent can read these notes before it upgrades. Set up the MCP server →
migrate tests to Testo, require PHP 8.2
Add support of google/protobuf v5.x by @roxblnfk in https://github.com/roadrunner-php/centrifugo/pull/15
Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/2.2.1...2.3.0
Update composer.json to support roadrunner v2025.1 by @wispoz in https://github.com/roadrunner-php/centrifugo/pull/14
Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/v2.2.0...2.2.1
Added support for google/protobuf v4.x by @msmakouz in https://github.com/roadrunner-php/centrifugo/pull/13
Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/v2.1.0...v2.2.0
Added support for RoadRunner v2024.1 by @msmakouz in https://github.com/roadrunner-php/centrifugo/pull/12
Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/v2.0.1...v2.1.0
In the RoadRunner\Centrifugo\Payload\Disconnect class, the reconnect parameter is declared as deprecated and is no longer used.
RoadRunner\Centrifugo\Payload\Disconnect class, the reconnect parameter is declared as deprecated and is no longer used.Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/2.0.0...v2.0.1
Added metapackage spiral/roadrunner:^2023
Local proto DTO files were replaced with files from roadrunner-php/roadrunner-api-dto package
RoadRunner\Centrifugo\Service\DTO\... => RoadRunner\KV\DTO\V1\...
RoadRunner\Centrifugo\DTO\... => RoadRunner\Centrifugal\Proxy\DTO\V1\...
<?php
require __DIR__ . '/vendor/autoload.php';
use RoadRunner\Centrifugo\CentrifugoWorker;
use RoadRunner\Centrifugo\Payload;
use RoadRunner\Centrifugo\Request;
use RoadRunner\Centrifugo\Request\RequestFactory;
use Spiral\RoadRunner\Worker;
$worker = Worker::create();
$requestFactory = new RequestFactory($worker);
// Create a new Centrifugo Worker from global environment
$centrifugoWorker = new CentrifugoWorker($worker, $requestFactory);
while ($request = $centrifugoWorker->waitRequest()) {
if ($request instanceof Request\SubRefresh) {
try {
// Do something
$request->respond(new Payload\SubRefreshResponse(
// ...
));
} catch (\Throwable $e) {
$request->error($e->getCode(), $e->getMessage());
}
continue;
}
}Note
Read more about Sub Refresh request on the official documentation
by @butschster in #8
<?php
require __DIR__ . '/vendor/autoload.php';
use RoadRunner\Centrifugo\CentrifugoWorker;
use RoadRunner\Centrifugo\Payload;
use RoadRunner\Centrifugo\Request;
use RoadRunner\Centrifugo\Request\RequestFactory;
use Spiral\RoadRunner\Worker;
$worker = Worker::create();
$requestFactory = new RequestFactory($worker);
// Create a new Centrifugo Worker from global environment
$centrifugoWorker = new CentrifugoWorker($worker, $requestFactory);
while ($request = $centrifugoWorker->waitRequest()) {
if ($request instanceof Request\Invalid) {
$errorMessage = $request->getException()->getMessage();
if ($request->getException() instanceof \RoadRunner\Centrifugo\Exception\InvalidRequestTypeException) {
$payload = $request->getException()->payload;
}
// Handle invalid request
// $logger->error($errorMessage, $payload ?? []);
continue;
}
}Full Changelog: 1.0.0...2.0.0
Local proto DTO files were replaced with files from roadrunner-php/roadrunner-api-dto package
RoadRunner\Centrifugo\Service\DTO\... => RoadRunner\KV\DTO\V1\...
RoadRunner\Centrifugo\DTO\... => RoadRunner\Centrifugal\Proxy\DTO\V1\...
<?php
require __DIR__ . '/vendor/autoload.php';
use RoadRunner\Centrifugo\CentrifugoWorker;
use RoadRunner\Centrifugo\Payload;
use RoadRunner\Centrifugo\Request;
use RoadRunner\Centrifugo\Request\RequestFactory;
use Spiral\RoadRunner\Worker;
$worker = Worker::create();
$requestFactory = new RequestFactory($worker);
// Create a new Centrifugo Worker from global environment
$centrifugoWorker = new CentrifugoWorker($worker, $requestFactory);
while ($request = $centrifugoWorker->waitRequest()) {
if ($request instanceof Request\SubRefresh) {
try {
// Do something
$request->respond(new Payload\SubRefreshResponse(
// ...
));
} catch (\Throwable $e) {
$request->error($e->getCode(), $e->getMessage());
}
continue;
}
}
Note Read more about Sub Refresh request on the official documentation
by @butschster in https://github.com/roadrunner-php/centrifugo/pull/8
<?php
require __DIR__ . '/vendor/autoload.php';
use RoadRunner\Centrifugo\CentrifugoWorker;
use RoadRunner\Centrifugo\Payload;
use RoadRunner\Centrifugo\Request;
use RoadRunner\Centrifugo\Request\RequestFactory;
use Spiral\RoadRunner\Worker;
$worker = Worker::create();
$requestFactory = new RequestFactory($worker);
// Create a new Centrifugo Worker from global environment
$centrifugoWorker = new CentrifugoWorker($worker, $requestFactory);
while ($request = $centrifugoWorker->waitRequest()) {
if ($request instanceof Request\Invalid) {
$errorMessage = $request->getException()->getMessage();
if ($request->getException() instanceof \RoadRunner\Centrifugo\Exception\InvalidRequestTypeException) {
$payload = $request->getException()->payload;
}
// Handle invalid request
// $logger->error($errorMessage, $payload ?? []);
continue;
}
}
Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/1.0.0...2.0.0
Init project Full Changelog: https://github.com/roadrunner-php/centrifugo/commits/1.0.0
Init project
Full Changelog: https://github.com/roadrunner-php/centrifugo/commits/1.0.0
One column per quarter.