fresh/centrifugo-bundle

Provides communication with web-socket server Centrifugo in Symfony applications.

6.2.1 2024-12-19 13:01 UTC

Requires

• php: >=8.3
• fresh/datetime: ^4.0
• symfony/config: ~7.0
• symfony/console: ~7.0
• symfony/dependency-injection: ~7.0
• symfony/framework-bundle: ~7.0
• symfony/http-client: ~7.0
• symfony/http-foundation: ~7.0
• symfony/http-kernel: ~7.0
• symfony/security-core: ~7.0
• symfony/validator: ~7.0

Requires (Dev)

• escapestudios/symfony2-coding-standard: ^3.13
• friendsofphp/php-cs-fixer: ^v3.64
• jetbrains/phpstorm-attributes: ^1.0
• phpstan/phpstan: ^1.12
• phpstan/phpstan-deprecation-rules: ^1.1
• phpstan/phpstan-phpunit: ^1.4
• phpstan/phpstan-symfony: ^1.4
• phpunit/phpunit: ^11.3
• roave/security-advisories: dev-latest
• seec/phpunit-consecutive-params: ^1.1
• slam/phpstan-extensions: ^6.4

MIT

• Artem Henvald
• Community

• symfony
• bundle
• Socket
• real time
• web socket
• centrifugo
• web-socket

README

📦 Provides communication with web-socket server Centrifugo in Symfony applications.

Features 🎁

• Compatible with latest Centrifugo 5.4.7 🚀
• Wrapper over Centrifugo HTTP API 🔌
• Authentication with JWT token (HMAC algorithm) for anonymous, authenticated user and private channel 🗝️
• Batch request in JSON streaming format 💪
• Console commands ⚒️️
• Integration into Symfony Web-Profiler 🎛️

Requirements 🧐

• PHP >= 8.3
• Symfony 7.0

Installation 🌱

$ composer req fresh/centrifugo-bundle

Choose the version you need

Bundle Version (X.Y.Z)	PHP	Symfony	Comment
6.2.*	>= 8.3	7.*	Current version
5.3.*	>= 8.2	7.*	Previous version

By default, Symfony Flex adds this bundle to the config/bundles.php file and adds required environment variables into .env file. In case when you ignored contrib-recipe during bundle installation it would not be done. Then you have to do this manually.

Check the config/bundles.php file

# config/bundles.php

return [
    // Other bundles...
    Fresh\CentrifugoBundle\FreshCentrifugoBundle::class => ['all' => true],
    // Other bundles...
];

Check the .env file and add you configuration

# .env

###> fresh/centrifugo-bundle ###
CENTRIFUGO_API_KEY=secret-api-key
CENTRIFUGO_API_ENDPOINT=http://localhost:8000/api
CENTRIFUGO_SECRET=secret
###< fresh/centrifugo-bundle ###

CENTRIFUGO_API_KEY should be the same value as option api_key in your Centrifugo config file.
CENTRIFUGO_SECRET should be the same value as option token_hmac_secret_key in your Centrifugo config file.

ℹ️ Customize bundle configuration

Using 🧑‍🎓

Centrifugo service

<?php
declare(strict_types=1);

namespace App\Service;

use Fresh\CentrifugoBundle\Service\CentrifugoInterface;

class YourService
{
    public function __construct(private readonly CentrifugoInterface $centrifugo)
    {
    }

    public function example(): void
    {
        $this->centrifugo->publish(['foo' => 'bar'], 'channelName');
    }
}

ℹ️ More examples of using Centrifugo service

Authentication with JWT tokens 🗝️

• For anonymous
• For authenticated User
• For private channel

Console commands ⚒️

• centrifugo:publish
• centrifugo:broadcast
• centrifugo:subscribe
• centrifugo:unsubscribe
• centrifugo:disconnect
• centrifugo:refresh
• centrifugo:presence
• centrifugo:presence-stats
• centrifugo:history
• centrifugo:history-remove
• centrifugo:channels
• centrifugo:info

ℹ️ More examples of using console commands

Integration into Symfony Web-Profiler 🎛️

Autocomplete channels in console commands 🪄

Contributing 🤝

Read the CONTRIBUTING file.