thruster/socket

Thruster Socket Component

1.1.0 2016-01-14 16:10 UTC

This package is auto-updated.

Last update: 2024-11-14 03:24:26 UTC


README

[Latest Version] (https://github.com/ThrusterIO/socket/releases) [Software License] (LICENSE) [Build Status] (https://travis-ci.org/ThrusterIO/socket) [Code Coverage] (https://scrutinizer-ci.com/g/ThrusterIO/socket) [Quality Score] (https://scrutinizer-ci.com/g/ThrusterIO/socket) [Total Downloads] (https://packagist.org/packages/thruster/socket)

[Email] (mailto:team@thruster.io)

The Thruster Socket Component.

Library for building an evented socket server.

The socket component provides a more usable interface for a socket-layer server or client based on the EventLoop and Stream components.

Server

The server can listen on a port and will emit a connection event whenever a client connects.

Connection

The Connection is a readable and writable Stream. The incoming connection represents the server-side end of the connection.

It MUST NOT be used to represent an outgoing connection in a client-side context. If you want to establish an outgoing connection, use the SocketClient component instead.

Install

Via Composer

$ composer require thruster/socket

Usage

Here is a server that closes the connection if you send it anything.

$loop = new EventLoop();

$socket = new Server($loop);
$socket->on('connection', function ($conn) {
    $conn->write("Hello world!\n");

    $conn->on('data', function ($data) use ($conn) {
        $conn->close();
    });
});
$socket->listen(1337);

$loop->run();

You can change the host the socket is listening on through a second parameter provided to the listen method:

$socket->listen(1337, '192.168.0.1');

Testing

$ composer test

Contributing

Please see CONTRIBUTING and CONDUCT for details.

License

Please see License File for more information.