Centrifugo Laravel Package

2.5.0 (2026-10-10)

Features

• rename the package to roadrunner/centrifugo (97e864e)
• support RoadRunner v3 (55884a8)

What's Changed

• Add support of google/protobuf v5.x by @roxblnfk in https://github.com/roadrunner-php/centrifugo/pull/15

New Contributors

• @roxblnfk made their first contribution in https://github.com/roadrunner-php/centrifugo/pull/15

Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/2.2.1...2.3.0

What's Changed

• Update composer.json to support roadrunner v2025.1 by @wispoz in https://github.com/roadrunner-php/centrifugo/pull/14

New Contributors

• @wispoz made their first contribution in https://github.com/roadrunner-php/centrifugo/pull/14

Full Changelog: https://github.com/roadrunner-php/centrifugo/compare/v2.2.0...2.2.1

What's Changed

• 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

What's Changed

• 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

Bug fixes

• In the 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

Features

• Upgraded to PHP 8.1
• Upgraded to PHPUnit 10
• Upgraded to Psalm 5
• Added reusable Gh Actions
• Added metapackage spiral/roadrunner:^2023

Breaking Changes

Generated proto DTO files

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\...

Added sub refresh proxy request

<?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

Added invalid request type

<?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