by bloatless

bloatless / php-websocket

A simple WebSocket Server and Client implementation in PHP.

443 Stars 170 Forks Last release: 7 months ago (v2.0.1) Do What The F*ck You Want To Public License 77 Commits 3 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

Bloatless PHP WebSockets

Simple WebSocket server and client implemented in PHP.


This application is an extremely simple implementation of the WebSocket Protocol in PHP. It includes a server as well as a client. This implementation is optimal to get started with WebSockets and learn something. As soon as you want to create a full featured websocket based application you might want to switch to more sophisticated solution.


Clone or download the repository to your server. The package is also installable via composer running the following command:

composer require bloatless/php-websocket


  • PHP >= 7.2

Hint: You can use version 1.0 if you're still on PHP5.


  • Adjust
    to your requirements.
  • Run:
    php cli/server.php

This will start a websocket server. (By default on localhost:8000)

Server example

This will create a websocket server listening on port 8000.

There a two applications registred to the server. The demo application will be available at

and the status application will be available at
// Require neccessary files here...

$server = new \Bloatless\WebSocket\Server('', 8000);

// Server settings: $server->setMaxClients(100); $server->setCheckOrigin(false); $server->setAllowedOrigin('foo.lh'); $server->setMaxConnectionsPerIp(100); $server->setMaxRequestsPerMinute(2000);

// Add your applications here: $server->registerApplication('status', \Bloatless\WebSocket\Application\StatusApplication::getInstance()); $server->registerApplication('demo', \Bloatless\WebSocket\Application\DemoApplication::getInstance());


Client example

This creates a WebSocket cliente, connects to a server and sends a message to the server:

$client = new \Bloatless\WebSocket\Client;
$client->connect('', 8000, '/demo', 'foo.lh');
    'action' => 'echo',
    'data' => 'Hello Wolrd!'

Browser example

The repository contains two demo-pages to call in your browser. You can find them in the

folder. The
is a simple application which you can use to send messages to the server.


will display various server information.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.