lowerpower/bolt

Asynchronous WebSocket client built on ReactPHP

bolt

Asynchronous WebSocket client client library for PHP. Supports HyBi, ~~as well as Hixie #76~~ (no point)., _(*1)

This was built purely to be a client, as the majority of the WS clients available also contain servers and are very bloated., _(*2)

This is not the original version, this has been updated to use latest reactphp and the API has been modified to be more consistant with modern reactphp., _(*3)

Installation

Using composer:, _(*4)

"require": {
    "lowerpower/bolt": "^0.2"
}    

Usage

Since this really lends itself to being an asynchronous app, it is built to use the React event loops and resolver since there's a good chance they'll be in your project already and this lets you attach to the same loop., _(*5)

$loop = \React\EventLoop\Factory::create();

// other options like tls, socket, etc are possible see "React\Socket\Connector"
$options=$options=array(
    'timeout'=>5.0                      /* 'timeout'=> false for disable */
);

// Now workes exaction like "React\Socket\Connector" 
$client = new \Calcinai\Bolt\Client($loop, $options);

//Most WS servers will complain/forbid if there is no origin header
$client->setOrigin('127.0.0.1');

// new, URL is here, ws:// and wss:// supported
$client->connect('ws://127.0.0.1:1337/chat');

$client->on('stateChange', function($newState){
    echo "State changed to: $newState\n";
});

$client->on('message', function($message) use ($client){
    echo "New message: \n";
    echo $message;

    $client->send('This is a response message');
});

$loop->run();

Other available events are connecting, connect, closing, close, _(*6)

HTTP basic auth is also supported via the URI inf the form user:pass@host, _(*7)

Any feedback is most welcome, _(*8)