mkiselev/yii2-broadcasting

Websocket broadcasting module

Yii2-broadcasting

Websocket broadcasting module, _(*1)

, _(*2)

This module is made under inspiration of laravel echo and compatible with libraries., _(*3)

There are several broadcast tools available for your choice:, _(*4)

1) NullBroadcaster Doing nothing, just a stub 2) LogBroadcaster Broadcast events to application log 3) RedisBroadcaster Broadcast by Redis using Pub/Sub feature (required yii2-redis) 4) RatchetBroadcaster (coming soon...) 5) PusherBroadcaster Broadcast by using pusher.com (coming soon...), _(*5)

Installation

The preferred way to install this extension is through composer., _(*6)

Either run, _(*7)

composer require --prefer-dist mkiselev/yii2-broadcasting "*"

or add, _(*8)

"mkiselev/yii2-broadcasting": "*"

to the require section of your composer.json file., _(*9)

Application configuration

Configure module for use some broadcaster and configure channels auth callbacks:, _(*10)

'bootstrap' => ['broadcasting'],
'modules' => [
    'broadcasting' => [
        'class' => \mkiselev\broadcasting\Module::class,
        'broadcaster' => [
            'class' => \mkiselev\broadcasting\broadcasters\RedisBroadcaster::class,
            // By default will be used redis application component, but you can configure as you want
            'redis' => [
                'class' => \yii\redis\Connection::class,
            ],
            // Configure auth callback for private and presitance chanells
            'channels' => [
                'signal' => function (\yii\web\User $user) {
                    return $user->can('something');
                },
            ],
        ],
    ],
],

Socket.io server configuration

This module is compilable with laravel-echo-server, _(*11)

Please follow to laravel-echo-server instructions to install and run them., _(*12)

Usage

Server side

Write your event extended by \mkiselev\broadcasting\events\BroadcastEvent like this:, _(*13)

<?php

namespace common\models;

use mkiselev\broadcasting\channels\PrivateChannel;
use mkiselev\broadcasting\events\BroadcastEvent;

class SignalEvent extends BroadcastEvent
{
    public $someParam = 42;

    public function broadcastOn()
    {
        return new PrivateChannel('signal');
    }

    public function broadcastAs()
    {
        return 'new';
    }
}

And broadcast it somewhere:, _(*14)

(new common\models\SignalEvent(['someParam' => 146]))->toOthers()->broadcast();

Client side

Register mkiselev\broadcasting\assets\EchoAsset import socket.io library https://github.com/tlaverdure/laravel-echo-server#socketio-client-library, _(*15)

window.io = io;
window.Echo = new Echo({
    broadcaster: 'socket.io',
    host: window.location.hostname + ':6001'
});

Echo.channel('signal')
    .listen('.new', function(e) {
        console.log(e.someParam);
    });

CHANGELOG