Skip to content

v3.0.0-rc.1

Pre-release
Pre-release

Choose a tag to compare

@marcosmarcolin marcosmarcolin released this 23 Oct 19:54
· 1 commit to master since this release
3a6981b

What's new since v3.0.0-beta.3

First release candidate for v3.0.0. Unless a blocking problem is reported, v3.0.0 will ship with this code.

composer require workerman/phpsocket.io:^3.0@RC

Bug fixes

  • ChannelAdapter broke with more than one namespace (#321): declaring any namespace besides / (e.g. $io->of('/chat')) silently stopped cross-worker delivery in every namespace, / included. Each namespace now has its own channels (socket.io#/chat#, socket.io#/chat#<room>#), so the same room name in two namespaces no longer shares a subscription either. Root-namespace channels are unchanged. The workerman/channel minimum is now 1.0.1.
  • ChannelAdapter set outside the event loop (#322): passing it as the constructor option at script level always died with an unrelated Channel\Client error. It now throws a RuntimeException that names the supported setup:
    $io->on('workerStart', function () use ($io) {
        $io->adapter(\PHPSocketIO\ChannelAdapter::class);
    });

Documentation

  • New README section, Multiple processes: Channel\Server, worker count, and why clients must use the WebSocket transport when processes share a port (#322).
  • The README's Install section explains how to install the v3 pre-release (#324).

Development

  • CI runs the ChannelAdapter integration test against a real channel server and two workers: 8 cross-worker scenarios, plus a scale check asserting 1 subscribed channel at 10,000 connections (#323).
  • The Docker image builds again after Debian 11 reached end of life (#320), and CI uses actions/checkout@v7 (Node.js 24).

Upgrade notes

If you run ChannelAdapter with multiple workers, restart all of them at once (stop + start, not reload). See UPGRADING.md.

Full changelog: v3.0.0-beta.3...v3.0.0-rc.1