zanderwar / php-websocket
A simple WebSocket Server and Client implementation in PHP.
Requires
- php: ^7.2
This package is auto-updated.
Last update: 2024-10-20 17:02:38 UTC
README
Bloatless PHP WebSockets
Simple WebSocket server and client implemented in PHP.
About
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.
Installation
Clone or download the repository to your server. The package is also installable via composer running the following command:
composer require bloatless/php-websocket
Requirements
- PHP >= 7.2
Hint: You can use version 1.0 if you're still on PHP5.
Usage
- Adjust
cli/server.php
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 ws://localhost:8000/demo
and the status application will be available at ws://localhost:8000/status
.
// Require neccessary files here... $server = new \Bloatless\WebSocket\Server('127.0.0.1', 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()); $server->run();
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('127.0.0.1', 8000, '/demo', 'foo.lh'); $client->sendData([ 'action' => 'echo', 'data' => 'Hello Wolrd!' ]);
Browser example
The repository contains two demo-pages to call in your browser. You can find them in the public
folder.
The index.html
is a simple application which you can use to send messages to the server.
The status.html
will display various server information.