Formed in 2009, the Archive Team (not to be confused with the archive.org Archive-It Team) is a rogue archivist collective dedicated to saving copies of rapidly dying or deleted websites for the sake of history and digital heritage. The group is 100% composed of volunteers and interested parties, and has expanded into a large amount of related projects for saving online and digital history.
Changes since RC2
- Removed header methods from
Connection. Now theResponseobject is available withConnection::getResponse(), which provides access to the response headers and other response data. - Removed the
connector()function, so there is no longer a globalConnectorobject. - Fixed
Handshake::withHeaders()to remove all prior set headers as expected. - Added
ConnectContextparameter toconnect()function. ConnectionExceptionnow extendsHttpExceptionfromamphp/http-client.
Upgrading from v0.2.x to v1.0
This library has been refactored to use the new amphp/websocket library containing components that can be shared between server and clients.
The simplest way to use this library is with the connect() function to initiate a WebSocket connection.
$connection = yield Amp\Websocket\Client\connect('ws://localhost:1337/broadcast');
yield $connection->send('Hello!');
/** @var Amp\Websocket\Message $message */
while ($message = yield $connection->receive()) {
$payload = yield $message->buffer();
// $payload now contains the entire message content
yield $connection->send('Received message with length ' . strlen($payload));
}Custom request headers and connections options can be set using the Handshake class and passing this object to connect() instead of a string URI. Connection behavior can be further customized by using an instance of Connector to establish a connection instead of the connect() function.
WebSocket clients are now represented by Connection, which extends the Client object from amphp/websocket. This object contains several methods for getting information about the client, fetching the headers returned in the server response, and sending/receiving messages.
Assets
2
- v1.0.0-rc2
-
f42543a -
Verified
This commit was signed with a verified signature.trowski Aaron Piotrowski
- v1.0.0-rc2
-
f42543a -
Verified
This commit was signed with a verified signature.
- This library now uses
HttpClientfromamphp/http-clientto send connection requests. As such,Rfc6455Connectorrequires an instance ofHttpClientwhen constructed. The client may have various interceptors attached to modify behavior when connecting. - Updated to
league/uri@^6, subsequently PHP 7.2+ is now required.
Assets
2
- v1.0.0-rc1
-
63499f4 -
Verified
This commit was signed with a verified signature.
- v1.0.0-rc1
-
63499f4 -
Verified
This commit was signed with a verified signature.
This library has been refactored to use the new amphp/websocket library containing components that can be shared between server and clients.
Note: This is a pre-release, there might be breaking changes in the final stable version.
The simplest way to use this library is with the connect() function to initiate a WebSocket connection.
$connection = yield Amp\Websocket\Client\connect('ws://localhost:1337/broadcast');
yield $connection->send('Hello!');
/** @var Amp\Websocket\Message $message */
while ($message = yield $connection->receive()) {
$payload = yield $message->buffer();
// $payload now contains the entire message content
yield $connection->send('Received message with length ' . strlen($payload));
}Custom request headers and connections options can be set using the Handshake class and passing this object to connect() instead of a string URI. Connection behavior can be customized using the Connector interface or by extending the existing Rfc6455Connector class.
WebSocket clients are now represented by Connection, which extends the Client object from amphp/websocket. This object contains several methods for getting information about the client, fetching the headers returned in the server response, and sending/receiving messages.
Assets
2
- Fixed incorrect dependency that was only being loaded in dev mode.
- Fixed port being added to host header if the port is non-standard (e.g., not 80/443).
Assets
2
Assets
2
- Reject connections if RSV is not equals to
0. - Validate close reasons to be valid UTF-8 if UTF-8 validation has been requested.
- Accept zero-length frames starting a message.
- Deliver stored messages correctly if they're immediately followed by a close.
- Reject continuations if there's no started message.
- Disable streaming for frames. A single frame is now always buffered. A message can still be streamed via multiple frames.
Assets
2
- Fix handshake if no port is given in URL.
- Correctly validate handshake response headers.
Assets
2
- Major API rewrite based on Amp v2.
Assets
2
- Release for Amp v1.