fresh/centrifugo-bundle

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

2.4.1 2022-07-28 14:05 UTC

Requires

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

Requires (Dev)

• escapestudios/symfony2-coding-standard: ^3.12
• jetbrains/phpstorm-attributes: ^1.0
• phpstan/phpstan: ^1.8
• phpstan/phpstan-deprecation-rules: ^1.0
• phpstan/phpstan-phpunit: ^1.1
• phpstan/phpstan-symfony: ^1.2
• phpunit/phpunit: ^9.5
• slam/phpstan-extensions: ^6.0

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 2.8.6 🚀
• 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.1
• Symfony 6.1

Installation 🌱

$ composer req fresh/centrifugo-bundle

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

ℹ️ Customize bundle configuration

Using 🧑‍🎓

Centrifugo service

<?php
declare(strict_types=1);

namespace App\Service;

use Fresh\CentrifugoBundle\Service\CentrifugoInterface;

class YourService
{
    private CentrifugoInterface $centrifugo;    

    public function __construct(CentrifugoInterface $centrifugo)
    {
        $this->centrifugo = $centrifugo;
    }

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

ℹ️ 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:unsubscribe
• centrifugo:disconnect
• 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 🎛️

Contributing 🤝

Read the CONTRIBUTING file.