navarr / sockets
Sockets in PHP
Fund package maintenance!
navarr
Installs: 410
Dependents: 1
Suggesters: 0
Security: 0
Stars: 50
Watchers: 12
Forks: 23
Open Issues: 1
Requires
- php: ^8
- ext-sockets: *
Requires (Dev)
- infection/infection: ^0.26
- jetbrains/phpstorm-attributes: ^1
- phpstan/phpstan: ^1
- phpunit/phpunit: ^9.5
- roave/security-advisories: dev-master
- squizlabs/php_codesniffer: ^3.6
This package is auto-updated.
Last update: 2024-10-17 01:48:32 UTC
README
Sockets is a PHP Library intent on making working with PHP Sockets easier, including the creation and management of a Socket Server.
Work in Progress
The code is currently still a work in progress, with the Socket class itself not yet fully complete. There is a lot I still need to understand about how sockets work both in PHP and probably in C in order to make everything work amazingly.
Not everything is tested yet, and not everything works properly yet.
It is advised not to seriously use this until I create git tag 1.0.0. There will be breaking changes before then.
Usage of SocketServer
Using SocketServer is supposed to be an easy and trivial task (and the class should be documented enough to understand what it's doing without me).
Example of an ECHO Server
<?php use Navarr\Socket\Socket; use Navarr\Socket\Server; class EchoServer extends Server { const DEFAULT_PORT = 7; public function __construct($ip = null, $port = self::DEFAULT_PORT) { parent::__construct($ip, $port); $this->addHook(Server::HOOK_CONNECT, array($this, 'onConnect')); $this->addHook(Server::HOOK_INPUT, array($this, 'onInput')); $this->addHook(Server::HOOK_DISCONNECT, array($this, 'onDisconnect')); $this->run(); } public function onConnect(Server $server, Socket $client, $message) { echo 'Connection Established',"\n"; } public function onInput(Server $server, Socket $client, $message) { echo 'Received "',$message,'"',"\n"; $client->write($message, strlen($message)); } public function onDisconnect(Server $server, Socket $client, $message) { echo 'Disconnection',"\n"; } } $server = new EchoServer('0.0.0.0');
Development
Documentation
This project uses phpdoc to generate documentation. To generate the documentation, you will need to satisfy some dependencies. First, you need to get graphviz. It is available through most Linux distros, but you can always download it and install it from the site if you aren't on Linux. If you install manually, make sure the binaries are on your PATH somewhere. Next, run the following commands within this directory (assumes you already have composer installed and available on your path as composer
).
composer install # this will install all of the development dependencies for this project vendor/bin/phpdoc -d ./src -t ./docs # this will generate the documentation into a docs directory