Skip to content

Releases: clue/reactphp-socks

v1.4.0

31 Aug 14:43
Compare
Choose a tag to compare
  • Feature: Full support for PHP 8.1 and PHP 8.2.
    (#105 by @clue and #108 by @SimonFrings)

  • Feature: Mark passwords and URIs as #[\SensitiveParameter] (PHP 8.2+).
    (#109 by @SimonFrings)

  • Feature: Forward compatibility with upcoming Promise v3.
    (#106 by @clue)

  • Bug: Fix invalid references in exception stack trace.
    (#104 by @clue)

  • Improve test suite and fix legacy HHVM build.
    (#107 by @SimonFrings)

v1.3.0

06 Aug 13:07
Compare
Choose a tag to compare
  • Feature: Simplify usage by supporting new default loop and making Connector optional.
    (#100 and #101 by @clue)

    // old (still supported)
    $proxy = new Clue\React\Socks\Client(
        $url,
        new React\Socket\Connector($loop)
    );
    $server = new Clue\React\Socks\Server($loop);
    $server->listen(new React\Socket\Server('127.0.0.1:1080', $loop));
    
    // new (using default loop)
    $proxy = new Clue\React\Socks\Client('127.0.0.1:1080');
    $socks = new Clue\React\Socks\Server();
    $socks->listen(new React\Socket\SocketServer('127.0.0.1:1080'));
  • Documentation improvements and updated examples.
    (#98 and #102 by @clue and #99 by @PaulRotmann)

  • Improve test suite and use GitHub actions for continuous integration (CI).
    (#97 by @SimonFrings)

v1.2.0

23 Oct 12:35
Compare
Choose a tag to compare
  • Enhanced documentation for ReactPHP's new HTTP client.
    (#95 by @SimonFrings)

  • Improve test suite, prepare PHP 8 support and support PHPUnit 9.3.
    (#96 by @SimonFrings)

v1.1.0

19 Jun 08:58
Compare
Choose a tag to compare
  • Feature / Fix: Support PHP 7.4 by skipping unneeded cleanup of exception trace args.
    (#92 by @clue)

  • Clean up test suite and add .gitattributes to exclude dev files from exports.
    Run tests on PHP 7.4, PHPUnit 9 and simplify test matrix.
    Link to using SSH proxy (SSH tunnel) as an alternative.
    (#88 by @clue and #91 and #93 by @SimonFrings)

v1.0.0

20 Nov 11:41
Compare
Choose a tag to compare
  • First stable release, now following SemVer!

  • Feature / BC break: Unify SOCKS5 and SOCKS4(a) protocol version handling,
    the Client now defaults to SOCKS5 instead of SOCKS4a,
    remove explicit SOCKS4a handling and merge into SOCKS4 protocol handling and
    URI scheme socks5:// now only acts as an alias for default socks:// scheme.
    (#74, #81 and #87 by @clue)

    // old: defaults to SOCKS4a
    $client = new Client('127.0.0.1:1080', $connector);
    $client = new Client('socks://127.0.0.1:1080', $connector);
    
    // new: defaults to SOCKS5
    $client = new Client('127.0.0.1:1080', $connector);
    $client = new Client('socks://127.0.0.1:1080', $connector);
    
    // new: explicitly use legacy SOCKS4(a)
    $client = new Client('socks4://127.0.0.1:1080', $connector);
    
    // unchanged: explicitly use SOCKS5
    $client = new Client('socks5://127.0.0.1:1080', $connector);
  • Feature / BC break: Clean up Server interface,
    add Server::listen() method instead of accepting socket in constructor,
    replace Server::setAuth() with optional constructor parameter,
    remove undocumented "connection" event from Server and drop explicit Evenement dependency and
    mark all classes as final and all internal APIs as @internal
    (#78, #79, #80 and #84 by @clue)

    // old: socket passed to server constructor
    $socket = new React\Socket\Server(1080, $loop);
    $server = new Clue\React\Socks\Server($loop, $socket);
    
    // old: authentication via setAuthArray()/setAuth() methods
    $server = new Clue\React\Socks\Server($loop, $socket);
    $server->setAuthArray(array(
        'tom' => 'password',
        'admin' => 'root'
    ));
    
    // new: socket passed to listen() method
    $server = new Clue\React\Socks\Server($loop);
    $socket = new React\Socket\Server(1080, $loop);
    $server->listen($socket);
    
    // new: authentication passed to server constructor
    $server = new Clue\React\Socks\Server($loop, null, array(
        'tom' => 'password',
        'admin' => 'root'
    ));
    $server->listen($socket);
  • Feature: Improve error reporting for failed connections attempts by always including target URI in exceptions and
    improve promise cancellation and clean up any garbage references.
    (#82 and #83 by @clue)

    All error messages now always contain a reference to the remote URI to give
    more details which connection actually failed and the reason for this error.
    Similarly, any underlying connection issues to the proxy server will now be
    reported as part of the previous exception.

    For most common use cases this means that simply reporting the Exception
    message should give the most relevant details for any connection issues:

    $promise = $proxy->connect('tcp://example.com:80');
    $promise->then(function (ConnectionInterface $connection) {
        // …
    }, function (Exception $e) {
        echo $e->getMessage();
    });
  • Improve documentation and examples, link to other projects and update project homepage.
    (#73, #75 and #85 by @clue)

v0.8.7

17 Dec 14:50
Compare
Choose a tag to compare
  • Feature: Support SOCKS over TLS (sockss:// URI scheme)
    (#70 and #71 by @clue)

    // new: now supports SOCKS over TLS
    $client = new Client('socks5s://localhost', $connector);
  • Feature: Support communication over Unix domain sockets (UDS)
    (#69 by @clue)

    // new: now supports SOCKS over Unix domain sockets (UDS)
    $client = new Client('socks5+unix:///tmp/proxy.sock', $connector);
  • Improve test suite by adding forward compatibility with PHPUnit 6
    (#68 by @clue)

v0.8.6

17 Sep 15:11
Compare
Choose a tag to compare

v0.8.5

01 Sep 10:38
Compare
Choose a tag to compare
  • Feature: Use socket error codes for connection rejections
    (#63 by @clue)

    $promise = $proxy->connect('imap.example.com:143');
    $promise->then(null, function (Exeption $e) {
        if ($e->getCode() === SOCKET_EACCES) {
            echo 'Failed to authenticate with proxy!';
        }
        throw $e;
    });
  • Feature: Report matching SOCKS5 error codes for server side connection errors
    (#62 by @clue)

  • Fix: Fix SOCKS5 client receiving destination hostnames and
    fix IPv6 addresses as hostnames for TLS certificates
    (#64 and #65 by @clue)

  • Improve test suite by locking Travis distro so new defaults will not break the build and
    optionally exclude tests that rely on working internet connection
    (#61 and #66 by @clue)

v0.8.4

02 Aug 16:09
Compare
Choose a tag to compare
  • Feature: Server now passes client source address to Connector
    (#60 by @clue)

v0.8.3

18 Jul 10:44
Compare
Choose a tag to compare
  • Feature: Pass full remote URI as parameter to authentication callback
    (#58 by @clue)

    // new third parameter passed to authentication callback
    $server->setAuth(function ($user, $pass, $remote) {
        $ip = parse_url($remote, PHP_URL_HOST);
        
        return ($ip === '127.0.0.1');
    });
  • Fix: Fix connecting to IPv6 address via SOCKS5 server and validate target
    URI so hostname can not contain excessive URI components
    (#59 by @clue)

  • Improve test suite by fixing HHVM build for now again and ignore future HHVM build errors
    (#57 by @clue)