GosWebSocketBundle is a Symfony bundle designed to bring together websocket functionality in a easy to use application architecture.

Much like Socket.IO, it provides both a server and client implementation ensuring you have to write as little as possible to get your application up and running.

Powered By Ratchet and Autobahn JS, with Symfony

Demo project

To view the documentation for the 1.x versions of this bundle, please view the 1.x branch of this repository. To view the documentation for the 2.x versions of this bundle, please view the master branch of this repository.

Websockets are very helpful for applications which require live activity and updates, including:

• Chat applications
• Real time notifications
• Browser games

• PHP Websocket server (IO / WAMP)
• PHP Websocket client (IO / WAMP)
• JavaScript Websocket client (IO / WAMP)
• PubSub Router
• Remote Procedure Calls
• User authentication
• Periodic calls
• Origin checker
• Push (amqp)

• Installation Instructions
• Client Setup
• RPC Handlers
• PubSub Topic Handlers
• Periodic Services
• Session Management & User authentication
• Server Events
• Configuration Reference
• Performance Bench
• Push integration
• SSL configuration

• Sharing Config between Server and Client

If your application requires support for Symfony versions before 3.4, use the 1.x releases of this bundle. For Symfony 3.4 or newer, use the 2.x releases.

composer require gos/web-socket-bundle

If your application is based on the Symfony Standard structure, you will need to add the bundle and its dependency, the GosPubSubRouterBundle, to your AppKernel class' registerBundles() method.

<?php
// app/AppKernel.php

// ...
class AppKernel extends Kernel
{
    public function registerBundles()
    {
        $bundles = [
            // ...

            new Gos\Bundle\PubSubRouterBundle\GosPubSubRouterBundle(),
            new Gos\Bundle\WebSocketBundle\GosWebSocketBundle(),
        ];

        // ...
    }

    // ...
}

If your application is based on the Symfony Flex structure, the bundle should be automatically registered, otherwise you will need to add it and its dependency, the GosPubSubRouterBundle, to your config/bundles.php file.

<?php

return [
    // ...

    Gos\Bundle\PubSubRouterBundle\GosPubSubRouterBundle::class => ['all' => true],
    Gos\Bundle\WebSocketBundle\GosWebSocketBundle::class => ['all' => true],
];

The following is the minimum configuration necessary to use the bundle. If you are using the Symfony Standard structure, this will be added to your app/config/config.yml file. If you are using the Symfony Flex structure, this will be added to your config/packages/gos_web_socket.yaml file.

gos_web_socket:
    server:
        port: 8080        # The port the socket server will listen on
        host: 127.0.0.1   # The host ip to bind to

With the bundle installed and configured, you can now launch the websocket server through your Symfony application's command-line console.

php bin/console gos:websocket:server

If everything is successful, you will see something similar to the following:

INFO      [websocket] Starting web socket
INFO      [websocket] Launching Ratchet on 127.0.0.1:8080 PID: 12345

Congratulations, your websocket server is now running. However, you will still need to add integrations to your application to fully use the bundle.

https://github.com/JDare/ClankBundle