By default, this bundle registers server middleware by finding all services with the babdev_websocket_server.server_middleware tag and sorting them by priority.

Below is the list of middleware provided by this bundle and the library and their default priorities:

New middleware should be added with a priority lower than 0 as the BabDev\WebSocket\Server\WAMP\Middleware\DispatchMessageToHandler middleware should be the last middleware in the stack.

Middleware must have the decorated middleware as the first parameter in the constructor, and cannot use a named parameter in the service definition (i.e. $middleware: !abstract decorated middleware for YAML); this is required for the compiler pass which builds the middleware stack to correctly set the arguments.

The bundle supports autoconfiguration of BabDev\WebSocket\Server\ServerMiddleware classes using the #[AsServerMiddleware] attribute on your middleware class.

<?php declare(strict_types=1);

namespace App\WebSocket\Middleware;

use BabDev\WebSocket\Server\ServerMiddleware;
use BabDev\WebSocketBundle\Attribute\AsServerMiddleware;

#[AsServerMiddleware(priority: -75)]
final readonly class EarlyMiddleware implements ServerMiddleware
{
    public function __construct(
        private ServerMiddleware $middleware,
    ) {}

    /* Class implementation */
}

If you are not using autoconfiguration, the service should be tagged with the babdev_websocket_server.server_middleware service tag and the priority specified.

# config/services.yaml
services:
  App\WebSocket\Middleware\EarlyMiddleware:
    arguments:
      - !abstract decorated middleware
    tags:
      - { name: babdev_websocket_server.server_middleware, priority: -75 }