Stream & Composite handlers

[xepozz]

Q	A
Is bugfix?	❌
New feature?	✔️
Breaks BC?	❌

Simple listen udp server

<?php
$socket = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
socket_bind($socket, "0.0.0.0", 8890);
$clients = [];
while (true){
    socket_recvfrom($socket, $buffer, 32768, 0, $ip, $port);
    var_dump('Received:', $buffer);
}

Simple udp write client

<?php
$socket = socket_create(AF_INET, SOCK_DGRAM, SOL_UDP);
$data = 'test';
socket_sendto($socket, $data, strlen($data), 0, '127.0.0.1', 8890);

[what-the-diff]

PR Summary

• Introduction of new 'Output Destination' in README
  A new section has been added to the README explaining various classes to handle where the data "dumps" are sent. New classes including EchoHandler, UdpHandler, and CompositeHandler have been added to make this process more efficient.

• Suggestion for use of 'ext-sockets' in composer.json
  An addition has been made in the 'suggest' area of our project's composer.json which recommends using the 'ext-sockets' extension. This can facilitate sending dumps to a server via the UDP protocol which can increase speed and performance.

• New Feature: CompositeHandler
  A new feature, located in the src/Handler directory, called CompositeHandler has been introduced. This gives us the ability to send the dump data to multiple handlers simultaneously, increasing redundancy and reliability.

• New Feature: UdpHandler
  Another new feature, titled UdpHandler, has also been created in the src/Handler directory. This class is equipped to send the dumps to a UDP socket, offering an additional method of data transmission.

[codecov]

Codecov Report

Attention: 2 lines in your changes are missing coverage. Please review.

Comparison is base (f4f8b37) 91.82% compared to head (9fd803d) 92.39%.

Additional details and impacted files

@@             Coverage Diff              @@
##             master      #95      +/-   ##
============================================
+ Coverage     91.82%   92.39%   +0.57%     
- Complexity      162      189      +27     
============================================
  Files             5        7       +2     
  Lines           379      434      +55     
============================================
+ Hits            348      401      +53     
- Misses           31       33       +2     

Files	Coverage Δ
src/Handler/CompositeHandler.php	100.00% <100.00%> (ø)
src/Handler/StreamHandler.php	96.00% <96.00%> (ø)

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

[arogachev]

A test is needed.

[xepozz]

It's hard to reproduce async behaviour in tests

[xepozz]

#98

[arogachev]

Please check #96.

[vjik]

Need fix static analysis