sperrichon/real-time-bundle

Real-time events from server to browsers and mobile devices

p-sam/real-time-bundle

![license-badge] ![release-version-badge] !php-version-badge, _(*1)

Real-time events from server to browsers and mobile devices via "channels", _(*2)

Please note that this bundle makes uses of ably.io and Redis via Predis., _(*3)

Installation

Install with composer:, _(*4)

$ composer require p-sam/real-time-bundle

Then register the bundle in the AppKernel.php file:, _(*5)

public function registerBundles()
{
    $bundles = array(
        // ...
        new SP\RealTimeBundle\SPRealTimeBundle(),
        // ...
    );

    return $bundles;
}

Then add the following to your routing.yml:, _(*6)

sp_realtime:
    resource: "@SPRealTimeBundle/Controller/"
    type: annotation

Note: Registering the bundle and the routes are done automatically if you're using Symfony Flex, _(*7)

Configuration

Configure the predis client and ably key in your config.yml:, _(*8)

sp_realtime:
    ably:
        api_key: '- ably key here -'
        ttl: 3600 # in seconds
    redis:
        key_prefix: 'app:'
    presence_check: true

Usage

From PHP

Services are provided from the bundle:, _(*9)

• sp_real_time.sender: Allows sending of messages to channels
• sp_real_time.presence: Allow subscribing by providing tokens, and checking for presence in channels

The following events are dispatched: * sp_real_time.event.subscribe: A SubscribeEvent is emitted when a token is generated for a channel * sp_real_time.event.message: A MessageEvent is emitted when a message is sent upstream to ably.io, _(*10)