Stars: 590
Forks: 236
Pull Requests: 64
Issues: 77
Watchers: 37
Last Updated: 2022-03-26 15:13:34
A simple PHP WebSocket implementation for PHP 7.1
License: Do What The F*ck You Want To Public License
Languages: PHP
A simple websocket server and client package for PHP 7.1.
The library is PSR-4 compatible, with a vendor name of Wrench. It's available on Composer as wrench/wrench
, so you
can:
composer require wrench/wrench ~3.0
This creates a server on 127.0.0.1:8000 with one Application that listens for
WebSocket requests to ws://localhost:8000/echo
and ws://localhost:8000/chat
:
/**
* An example application, that just echoes the received data back to the connection that sent it
*/
$app = new class implements \Wrench\Application\DataHandlerInterface
{
public function onData(string $data, \Wrench\Connection $connection): void
{
$connection->send($data);
}
};
// A websocket server, listening on port 8000
$server = new \Wrench\BasicServer('ws://localhost:8000', array(
'allowed_origins' => array(
'mysite.com',
'mysite.dev.localdomain'
)
));
$server->registerApplication('echo', $app);
$server->registerApplication('chat', new \My\ChatApplication());
$server->setLogger($monolog); // PSR3
$server->run();
/**
* A client side example, that sends a string and will receive the data back to the connection that sent it
*/
$client = new Client('ws://localhost:8000, http://localhost:8000);
$client->connect();
$client->sendData('hello');
$response = $client->receive()[0]->getPayload();
$client->disconnect();
See the CHANGELOG for detailed information about changes between releases.
The latest major release dropped support for PHP versions prior to 7.1. If you need support for older versions of PHP, see the 2.0 branch. The latest 2.0 branch release is 2.0.8. You can install it with:
composer require wrench/wrench ~2.0
./vendor/bin/phpcs
and fix any errors that you come across./vendor/bin/phpunit --exclude-group large,medium
for a fast test between changes