Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ratchetphp/Pawl
Asynchronous WebSocket client
https://github.com/ratchetphp/Pawl
async websocket-client websockets
Last synced: about 1 month ago
JSON representation
Asynchronous WebSocket client
- Host: GitHub
- URL: https://github.com/ratchetphp/Pawl
- Owner: ratchetphp
- License: mit
- Created: 2014-06-15T15:03:38.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-04-23T12:33:43.000Z (8 months ago)
- Last Synced: 2024-05-17T00:45:43.012Z (7 months ago)
- Topics: async, websocket-client, websockets
- Language: PHP
- Homepage:
- Size: 89.8 KB
- Stars: 575
- Watchers: 38
- Forks: 86
- Open Issues: 22
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- favorite-link - 异步 WebSocket 客户端。
- awesome-php - Pawl - An asynchronous web socket client. (Table of Contents / Event)
- awesome-php-cn - Pawl - 异步web socket客户机. (目录 / 事件 Event)
- awesome-projects - Pawl - An asynchronous web socket client. (PHP / Event)
- awesome-php - Pawl - An asynchronous web socket client. (Table of Contents / Event)
README
# Pawl
[](http://socketo.me/reports/pawl/index.html)
[](https://github.com/ratchetphp/Pawl/actions)
An asynchronous WebSocket client in PHP
#### Install via composer:
composer require ratchet/pawl
#### Usage
Pawl as a standalone app: Connect to an echo server, send a message, display output, close connection:
```php
then(function($conn) {
$conn->on('message', function($msg) use ($conn) {
echo "Received: {$msg}\n";
$conn->close();
});
$conn->send('Hello World!');
}, function ($e) {
echo "Could not connect: {$e->getMessage()}\n";
});
```
#### Classes
There are 3 primary classes to be aware of and use in Pawl:
##### Connector:
Makes HTTP requests to servers returning a promise that, if successful, will resolve to a WebSocket object.
A connector is configured via its constructor and a request is made by invoking the class. Multiple connections can be established through a single connector. The invoke mehtod has 3 parameters:
* **$url**: String; A valid uri string (starting with ws:// or wss://) to connect to (also accepts PSR-7 Uri object)
* **$subProtocols**: Array; An optional indexed array of WebSocket sub-protocols to negotiate to the server with. The connection will fail if the client and server can not agree on one if any are provided
* **$headers**: Array; An optional associative array of additional headers requests to use when initiating the handshake. A common header to set is `Origin`
##### WebSocket:
This is the object used to interact with a WebSocket server. It has two methods: `send` and `close`.
It has two public properties: `request` and `response` which are PSR-7 objects representing the client and server side HTTP handshake headers used to establish the WebSocket connection.
##### Message:
This is the object received from a WebSocket server. It has a `__toString` method which is how most times you will want to access the data received.
If you need to do binary messaging you will most likely need to use methods on the object.
#### Example
A more in-depth example using explicit interfaces: Requesting sub-protocols, and sending custom headers while using a specific React Event Loop:
```php
'8.8.8.8',
'timeout' => 10
]);
$loop = \React\EventLoop\Loop::get();
$connector = new \Ratchet\Client\Connector($loop, $reactConnector);
$connector('ws://127.0.0.1:9000', ['protocol1', 'subprotocol2'], ['Origin' => 'http://localhost'])
->then(function(\Ratchet\Client\WebSocket $conn) {
$conn->on('message', function(\Ratchet\RFC6455\Messaging\MessageInterface $msg) use ($conn) {
echo "Received: {$msg}\n";
$conn->close();
});
$conn->on('close', function($code = null, $reason = null) {
echo "Connection closed ({$code} - {$reason})\n";
});
$conn->send('Hello World!');
}, function(\Exception $e) use ($loop) {
echo "Could not connect: {$e->getMessage()}\n";
$loop->stop();
});
```