Download the PHP package cydrickn/socketio without Composer

PHP SocketIO Server

PHP Websocket Server that is compatible with socket.io

So far the function use in this package is almost same with the naming in socket.io

Installation

Then in your main php code add

Usage

Initializing your server

To initialize

Server Options

Server Instance

This is the server \Cydrickn\SocketIO\Socket

Events

Basic Emit

To emit, just need to call the \Cydrickn\SocketIO\Socket::emit

You can also pass as many as you want for the parameters

There is no need to run json_encode on objects/arrays as it will be done for you.

Broadcasting

Broadcast is like just the simple emit, but it will send to all connected client except the current client

Sending to all clients

The toAll will emit a message to all connected clients including the current client

Acknowledgements

Same with the socket io for nodejs, you just need to add a callable as the last argument in the emit

Server

Client

With Timeout

Assign a timeout to each emit:

Add callback default arguments value for timeout

Listening

To listen to any event

Server Event

This event can't be use for the route Since this event are Swoole Websocket Event All Event with * should not be used

• Request - When you use it for http
• *WorkerStart - You must not replace this event since this is the worker start logic for this package
• *Start - You must not replace this event since this is the start logic for this package
• *Open - You must not replace this event since this is the connection logic for this package
• *Message - You must not replace this event since this is the message logic for this package
• *Close - You must not replace this event since this is the message logic for this package

Rooms

In this package it was already included the rooms

To join to group just call the function join

To emit a message

Emit to multiple room

Leaving the room

Sending to specific user

In socket.io javascript, the user was automatically created a new room for each client sid.

But currently in this package it will not create a new room for each client.

In this package you just need to specify if its a room or a sid

Middleware

You can add an middleware for the server

To not continue the connection you just pass \Error in the $next

You can also add middleware for handshake event of Swoole Server. Just passed true to the second argument.

Also in callback it will pass the response for you to modify if you need it

If you want to create a middleware as a class we recommend to implement the Cydrickn\SocketIO\Middleware\MiddlewareInterface and if for handshake use Cydrickn\SocketIO\Middleware\HandshakeMiddlewareInterface

Example of middleware that use in handshake is the Cydrickn\SocketIO\Middleware\CookieSessionMiddleware. This middleware will create a session that uses the cookie and if the client did not send the session cookie then it will create a cookie and response it from the handshake.

Session

In this package the there is already session storage that you can use,

• SessionsTable - Uses the Swoole\Table as the storage
• SessionsNative - Uses the file storage

Using Swoole, session_start, $_SESSION should not be use since this function are global it stores the data in the process itself.

The session that provided here does not use this predefined session extensions. Currently, the session is define per connection so you can take the session via.

This getSession can return null if you don't have any middleware that creating the session.

To set a session

You can also customize your session storage, just implement the Cydrickn\SocketIO\Session\SessionStorageInterface

After creating your storage

You need to pass this in your server constructor

Example

• Chat Example

TODO

• [X] Leaving room
• [X] Fix disconnection event
• [X] Emit Acknowledgement
• [ ] Implement with timeout emit
• [ ] Implement Catch all listeners
• [ ] Implement once, off, removeAllListeners

This package was used in

• Swoole Websocket Bundle - Symfony