consik/yii2-websocket

Yii2 websocket server component

Yii2 WebSocketServer

, _(*1)

Used Ratchet, _(*2)

Installation

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

Either run, _(*4)

composer require consik/yii2-websocket

or add, _(*5)

"consik/yii2-websocket": "^1.0"

WebSocketServer class description

Properties

1. int $port = 8080 - Port number for websocket server
2. bool $closeConnectionOnError = true - Close connection or not when error occurs with it
3. bool $runClientCommands = true - Check client's messages for commands or not
4. null|IoServer $server = null - IOServer object
5. null|\SplObjectStorage $clients = null - Storage of connected clients

Methods

Events

• EVENT_WEBSOCKET_OPEN

Class yii\base\Event - Triggered when binding is successfully completed, _(*6)

• EVENT_WEBSOCKET_CLOSE

Class yii\base\Event - Triggered when socket listening is closed, _(*7)

• EVENT_WEBSOCKET_OPEN_ERROR

Class events\ExceptionEvent - Triggered when throwed Exception on binding socket, _(*8)

• EVENT_CLIENT_CONNECTED

Class events\WSClientEvent - Triggered when client connected to the server, _(*9)

• EVENT_CLIENT_DISCONNECTED

Class events\WSClientEvent - Triggered when client close connection with server, _(*10)

• EVENT_CLIENT_ERROR

Class events\WSClientErrorEvent - Triggered when an error occurs on a Connection, _(*11)

• EVENT_CLIENT_MESSAGE

Class events\WSClientMessageEvent - Triggered when message recieved from client, _(*12)

• EVENT_CLIENT_RUN_COMMAND

Class events\WSClientCommandEvent - Triggered when controller starts user's command, _(*13)

• EVENT_CLIENT_END_COMMAND

Class events\WSClientCommandEvent - Triggered when controller finished user's command, _(*14)

Examples

Simple echo server

Create your server class based on WebSocketServer. For example daemons\EchoServer.php:, _(*15)

<?php
namespace app\daemons;

use consik\yii2websocket\events\WSClientMessageEvent;
use consik\yii2websocket\WebSocketServer;

class EchoServer extends WebSocketServer
{

    public function init()
    {
        parent::init();

        $this->on(self::EVENT_CLIENT_MESSAGE, function (WSClientMessageEvent $e) {
            $e->client->send( $e->message );
        });
    }

}

Create yii2 console controller for starting server:, _(*16)

<?php
namespace app\commands;

use app\daemons\EchoServer;
use yii\console\Controller;

class ServerController extends Controller
{
    public function actionStart($port = null)
    {
        $server = new EchoServer();
        if ($port) {
            $server->port = $port;
        }
        $server->start();
    }
}

Start your server using console:, _(*17)

php yii server/start, _(*18)

Now let's check our server via js connection:, _(*19)

var conn = new WebSocket('ws://localhost:8080');
    conn.onmessage = function(e) {
        console.log('Response:' + e.data);
    };
    conn.onopen = function(e) {
        console.log("Connection established!");
        console.log('Hey!');
        conn.send('Hey!');
    };

Console result must be:, _(*20)

Connection established!, _(*21)

Hey!, _(*22)

Response:Hey!, _(*23)

Handle server starting success and error events

Now we try handle socket binding error and open it on other port, when error occurs;, _(*24)

Create yii2 console controller for starting server:, _(*25)

<?php
namespace app\commands;

use consik\yii2websocket\WebSocketServer;
use yii\console\Controller;

class ServerController extends Controller
{
    public function actionStart()
    {
        $server = new WebSocketServer();
        $server->port = 80; //This port must be busy by WebServer and we handle an error

        $server->on(WebSocketServer::EVENT_WEBSOCKET_OPEN_ERROR, function($e) use($server) {
            echo "Error opening port " . $server->port . "\n";
            $server->port += 1; //Try next port to open
            $server->start();
        });

        $server->on(WebSocketServer::EVENT_WEBSOCKET_OPEN, function($e) use($server) {
            echo "Server started at port " . $server->port;
        });

        $server->start();
    }
}

Start your server using console command:, _(*26)

php yii server/start, _(*27)

Server console result must be:, _(*28)

Error opening port 80, _(*29)

Server started at port 81, _(*30)

Recieving client commands

You can implement methods that will be runned after some of user messages automatically;, _(*31)

Server class daemons\CommandsServer.php:, _(*32)

<?php
namespace app\daemons;

use consik\yii2websocket\WebSocketServer;
use Ratchet\ConnectionInterface;

class CommandsServer extends WebSocketServer
{

    /**
     * override method getCommand( ... )
     *
     * For example, we think that all user's message is a command
     */
    protected function getCommand(ConnectionInterface $from, $msg)
    {
        return $msg;
    }

    /**
     * Implement command's method using "command" as prefix for method name
     *
     * method for user's command "ping"
     */
    function commandPing(ConnectionInterface $client, $msg)
    {
        $client->send('Pong');
    }

}

Run the server like in examples above, _(*33)

Check connection and command working by js script:, _(*34)

    var conn = new WebSocket('ws://localhost:8080');
    conn.onmessage = function(e) {
        console.log('Response:' + e.data);
    };
    conn.onopen = function(e) {
        console.log('ping');
        conn.send('ping');
    };

Console result must be:, _(*35)

ping, _(*36)

Response:Pong, _(*37)

Chat example

In the end let's make simple chat with sending messages and function to change username;, _(*38)

Code without comments, try to understand it by youself ;), _(*39)

• Server class daemons\ChatServer.php:

<?php
namespace app\daemons;

use consik\yii2websocket\events\WSClientEvent;
use consik\yii2websocket\WebSocketServer;
use Ratchet\ConnectionInterface;

class ChatServer extends WebSocketServer
{

    public function init()
    {
        parent::init();

        $this->on(self::EVENT_CLIENT_CONNECTED, function(WSClientEvent $e) {
            $e->client->name = null;
        });
    }


    protected function getCommand(ConnectionInterface $from, $msg)
    {
        $request = json_decode($msg, true);
        return !empty($request['action']) ? $request['action'] : parent::getCommand($from, $msg);
    }

    public function commandChat(ConnectionInterface $client, $msg)
    {
        $request = json_decode($msg, true);
        $result = ['message' => ''];

        if (!$client->name) {
            $result['message'] = 'Set your name';
        } elseif (!empty($request['message']) && $message = trim($request['message']) ) {
            foreach ($this->clients as $chatClient) {
                $chatClient->send( json_encode([
                    'type' => 'chat',
                    'from' => $client->name,
                    'message' => $message
                ]) );
            }
        } else {
            $result['message'] = 'Enter message';
        }

        $client->send( json_encode($result) );
    }

    public function commandSetName(ConnectionInterface $client, $msg)
    {
        $request = json_decode($msg, true);
        $result = ['message' => 'Username updated'];

        if (!empty($request['name']) && $name = trim($request['name'])) {
            $usernameFree = true;
            foreach ($this->clients as $chatClient) {
                if ($chatClient != $client && $chatClient->name == $name) {
                    $result['message'] = 'This name is used by other user';
                    $usernameFree = false;
                    break;
                }
            }

            if ($usernameFree) {
                $client->name = $name;
            }
        } else {
            $result['message'] = 'Invalid username';
        }

        $client->send( json_encode($result) );
    }

}

• Simple html form chat.html:

Username:<br />
<input id="username" type="text"><button id="btnSetUsername">Set username</button>







Message:<br />
<input id="message" type="text"><button id="btnSend">Send</button>

• JS code for chat with jQuery:

Enjoy ;), _(*40)

Other

Starting yii2 console application as daemon using nohup

nohup php yii _ControllerName_/_ActionName_ &, _(*41)