Skip to content

πŸ“¦ Provides communication with web-socket server Centrifugo in Symfony applications.

License

Notifications You must be signed in to change notification settings

fre5h/CentrifugoBundle

Repository files navigation

CentrifugoBundle

πŸ“¦ Provides communication with web-socket server Centrifugo in Symfony applications.

Scrutinizer Quality Score Build Status CodeCov License Latest Stable Version Total Downloads StyleCI Gitter

Features 🎁

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.0.* >= 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 πŸ—οΈ

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.