M1I03: Socket wrapper

[s2x]

Summary

Action	File
Create	src/Server/Socket/Connection.php
Create	src/Server/Socket/Socket.php
Create	tests/Server/Socket/SocketTest.php

• Connection wraps a \Socket resource with read/write/close/peer name tracking
• Socket wraps a listen \Socket resource with bind/listen/accept/close/setOption
• Socket::accept() returns Connection, throws SocketAcceptException on failure
• Socket::close() is idempotent, sets resource to null after close
• Socket::setOption() uses 3 parameters matching PHP's socket_set_option
• Exceptions throw SocketCreationException/SocketAcceptException when operations fail

Acceptance criteria

• accept() returns Connection instance, throws on error
• close() is idempotent, resource set to null
• setOption() has 3 parameters: $level, $option, $value
• SocketTest passes (bind, listen, close, constructor)

Closes #5

[s2x]

Dzięki za dodanie wrappera socketów. Kilka uwag — szczególnie getPeerName() wymaga poprawki przed mergem.

Ogólne: niespójna obsługa błędów

Klasa Socket konsekwentnie rzuca wyjątki przy operacjach na zamkniętym sockecie. Connection jest niespójna: read()/write() zwracają false, setOption() i getPeerName() nie robią nic. Dobrze byłoby ujednolicić na rzucanie wyjątków — wtedy caller zawsze wie, czego się spodziewać.

Brak testów dla Connection

78 linii kodu w Connection.php nie ma żadnego dedykowanego testu poza assertInstanceOf() i close() użytych w testAcceptReturnsConnection. Brakuje pokrycia dla read(), write(), getPeerName(), setOption(), getLastActivity() i ścieżek "po zamknięciu".

[s2x]

Fixes applied in 71e8fa2

All review comments have been addressed:

#	Finding	Fix
1	getPeerName() missing $closed guard + ignored return value	Added both: throws RuntimeException on closed socket or failed lookup
2	lastActivity updated on failed read()/write()	Now only updates on success
3	Connection::setOption() ignores return value	Now checks === false and throws RuntimeException with error message
4	Socket::setOption() ignores return value	Now checks return value; kept SocketCreationException to match existing exception hierarchy
5	testCloseIsIdempotent has no assertion	Added reflection-based null assertion after second close
6	testAcceptReturnsConnection uses raw PHP functions	Changed to use $socket->setOption(), $socket->bind(), $socket->listen() API