| 1 |
# Changelog |
| 2 |
|
| 3 |
## 1.10.0 (2026-06-29) |
| 4 |
|
| 5 |
* Feature: Remove abandoned `ringcentral/psr7` dependency to support PSR-7 v2 (`psr/http-message`). |
| 6 |
(#65 by @kwhat and @clue) |
| 7 |
|
| 8 |
* Feature: Improve PHP 8.5+ and PHP 8.4+ support and update test environment. |
| 9 |
(#59, #60 and #67 by @clue) |
| 10 |
|
| 11 |
* Improve test suite to ensure 100% code coverage and support legacy PHP 7.2 with PHPUnit 8.5. |
| 12 |
(#66 and #68 by @clue) |
| 13 |
|
| 14 |
## 1.9.0 (2024-04-10) |
| 15 |
|
| 16 |
* Feature / Fix: Forward compatibility with Promise v3. |
| 17 |
(#56 by @SimonFrings) |
| 18 |
|
| 19 |
* Feature: Full PHP 8.3 compatibility. |
| 20 |
(#54 by @yadaiio) |
| 21 |
|
| 22 |
* Minor documentation improvements. |
| 23 |
(#53 and #55 by @yadaiio) |
| 24 |
|
| 25 |
* Update test suite to use new reactphp/async package instead of clue/reactphp-block. |
| 26 |
(#50 and #57 by @dinooo13 and @SimonFrings) |
| 27 |
|
| 28 |
## 1.8.0 (2022-09-01) |
| 29 |
|
| 30 |
* Feature: Full support for PHP 8.1 and PHP 8.2. |
| 31 |
(#47 and #48 by @SimonFrings) |
| 32 |
|
| 33 |
* Feature: Mark passwords and URIs as `#[\SensitiveParameter]` (PHP 8.2+). |
| 34 |
(#49 by @SimonFrings) |
| 35 |
|
| 36 |
* Feature: Forward compatibility with upcoming Promise v3. |
| 37 |
(#44 by @clue) |
| 38 |
|
| 39 |
* Fix: Fix invalid references in exception stack trace. |
| 40 |
(#45 by @clue) |
| 41 |
|
| 42 |
* Improve test suite and fix legacy HHVM build. |
| 43 |
(#46 by @SimonFrings) |
| 44 |
|
| 45 |
## 1.7.0 (2021-08-06) |
| 46 |
|
| 47 |
* Feature: Simplify usage by supporting new default loop and making `Connector` optional. |
| 48 |
(#41 and #42 by @clue) |
| 49 |
|
| 50 |
```php |
| 51 |
// old (still supported) |
| 52 |
$proxy = new Clue\React\HttpProxy\ProxyConnector( |
| 53 |
'127.0.0.1:8080', |
| 54 |
new React\Socket\Connector($loop) |
| 55 |
); |
| 56 |
|
| 57 |
// new (using default loop) |
| 58 |
$proxy = new Clue\React\HttpProxy\ProxyConnector('127.0.0.1:8080'); |
| 59 |
``` |
| 60 |
|
| 61 |
* Documentation improvements and updated examples. |
| 62 |
(#39 and #43 by @clue and #40 by @PaulRotmann) |
| 63 |
|
| 64 |
* Improve test suite and use GitHub actions for continuous integration (CI). |
| 65 |
(#38 by @SimonFrings) |
| 66 |
|
| 67 |
## 1.6.0 (2020-10-23) |
| 68 |
|
| 69 |
* Enhanced documentation for ReactPHP's new HTTP client. |
| 70 |
(#35 and #37 by @SimonFrings) |
| 71 |
|
| 72 |
* Improve test suite, prepare PHP 8 support and support PHPUnit 9.3. |
| 73 |
(#36 by @SimonFrings) |
| 74 |
|
| 75 |
## 1.5.0 (2020-06-19) |
| 76 |
|
| 77 |
* Feature / Fix: Support PHP 7.4 by skipping unneeded cleanup of exception trace args. |
| 78 |
(#33 by @clue) |
| 79 |
|
| 80 |
* Clean up test suite and add `.gitattributes` to exclude dev files from exports. |
| 81 |
Run tests on PHP 7.4, PHPUnit 9 and simplify test matrix. |
| 82 |
Link to using SSH proxy (SSH tunnel) as an alternative. |
| 83 |
(#27 by @clue and #31, #32 and #34 by @SimonFrings) |
| 84 |
|
| 85 |
## 1.4.0 (2018-10-30) |
| 86 |
|
| 87 |
* Feature: Improve error reporting for failed connection attempts and improve |
| 88 |
cancellation forwarding during proxy connection setup. |
| 89 |
(#23 and #26 by @clue) |
| 90 |
|
| 91 |
All error messages now always contain a reference to the remote URI to give |
| 92 |
more details which connection actually failed and the reason for this error. |
| 93 |
Similarly, any underlying connection issues to the proxy server will now be |
| 94 |
reported as part of the previous exception. |
| 95 |
|
| 96 |
For most common use cases this means that simply reporting the `Exception` |
| 97 |
message should give the most relevant details for any connection issues: |
| 98 |
|
| 99 |
```php |
| 100 |
$promise = $proxy->connect('tcp://example.com:80'); |
| 101 |
$promise->then(function (ConnectionInterface $connection) { |
| 102 |
// … |
| 103 |
}, function (Exception $e) { |
| 104 |
echo $e->getMessage(); |
| 105 |
}); |
| 106 |
``` |
| 107 |
|
| 108 |
* Feature: Add support for custom HTTP request headers. |
| 109 |
(#25 by @valga and @clue) |
| 110 |
|
| 111 |
```php |
| 112 |
// new: now supports custom HTTP request headers |
| 113 |
$proxy = new ProxyConnector('127.0.0.1:8080', $connector, array( |
| 114 |
'Proxy-Authorization' => 'Bearer abc123', |
| 115 |
'User-Agent' => 'ReactPHP' |
| 116 |
)); |
| 117 |
``` |
| 118 |
|
| 119 |
* Fix: Fix connecting to IPv6 destination hosts. |
| 120 |
(#22 by @clue) |
| 121 |
|
| 122 |
* Link to clue/reactphp-buzz for HTTP requests and update project homepage. |
| 123 |
(#21 and #24 by @clue) |
| 124 |
|
| 125 |
## 1.3.0 (2018-02-13) |
| 126 |
|
| 127 |
* Feature: Support communication over Unix domain sockets (UDS) |
| 128 |
(#20 by @clue) |
| 129 |
|
| 130 |
```php |
| 131 |
// new: now supports communication over Unix domain sockets (UDS) |
| 132 |
$proxy = new ProxyConnector('http+unix:///tmp/proxy.sock', $connector); |
| 133 |
``` |
| 134 |
|
| 135 |
* Reduce memory consumption by avoiding circular reference from stream reader |
| 136 |
(#18 by @valga) |
| 137 |
|
| 138 |
* Improve documentation |
| 139 |
(#19 by @clue) |
| 140 |
|
| 141 |
## 1.2.0 (2017-08-30) |
| 142 |
|
| 143 |
* Feature: Use socket error codes for connection rejections |
| 144 |
(#17 by @clue) |
| 145 |
|
| 146 |
```php |
| 147 |
$promise = $proxy->connect('imap.example.com:143'); |
| 148 |
$promise->then(null, function (Exception $e) { |
| 149 |
if ($e->getCode() === SOCKET_EACCES) { |
| 150 |
echo 'Failed to authenticate with proxy!'; |
| 151 |
} |
| 152 |
throw $e; |
| 153 |
}); |
| 154 |
``` |
| 155 |
|
| 156 |
* Improve test suite by locking Travis distro so new defaults will not break the build and |
| 157 |
optionally exclude tests that rely on working internet connection |
| 158 |
(#15 and #16 by @clue) |
| 159 |
|
| 160 |
## 1.1.0 (2017-06-11) |
| 161 |
|
| 162 |
* Feature: Support proxy authentication if proxy URL contains username/password |
| 163 |
(#14 by @clue) |
| 164 |
|
| 165 |
```php |
| 166 |
// new: username/password will now be passed to HTTP proxy server |
| 167 |
$proxy = new ProxyConnector('user:[email protected]:8080', $connector); |
| 168 |
``` |
| 169 |
|
| 170 |
## 1.0.0 (2017-06-10) |
| 171 |
|
| 172 |
* First stable release, now following SemVer |
| 173 |
|
| 174 |
> Contains no other changes, so it's actually fully compatible with the v0.3.2 release. |
| 175 |
|
| 176 |
## 0.3.2 (2017-06-10) |
| 177 |
|
| 178 |
* Fix: Fix rejecting invalid URIs and unexpected URI schemes |
| 179 |
(#13 by @clue) |
| 180 |
|
| 181 |
* Fix HHVM build for now again and ignore future HHVM build errors |
| 182 |
(#12 by @clue) |
| 183 |
|
| 184 |
* Documentation for Connector concepts (TCP/TLS, timeouts, DNS resolution) |
| 185 |
(#11 by @clue) |
| 186 |
|
| 187 |
## 0.3.1 (2017-05-10) |
| 188 |
|
| 189 |
* Feature: Forward compatibility with upcoming Socket v1.0 and v0.8 |
| 190 |
(#10 by @clue) |
| 191 |
|
| 192 |
## 0.3.0 (2017-04-10) |
| 193 |
|
| 194 |
* Feature / BC break: Replace deprecated SocketClient with new Socket component |
| 195 |
(#9 by @clue) |
| 196 |
|
| 197 |
This implies that the `ProxyConnector` from this package now implements the |
| 198 |
`React\Socket\ConnectorInterface` instead of the legacy |
| 199 |
`React\SocketClient\ConnectorInterface`. |
| 200 |
|
| 201 |
## 0.2.0 (2017-04-10) |
| 202 |
|
| 203 |
* Feature / BC break: Update SocketClient to v0.7 or v0.6 and |
| 204 |
use `connect($uri)` instead of `create($host, $port)` |
| 205 |
(#8 by @clue) |
| 206 |
|
| 207 |
```php |
| 208 |
// old |
| 209 |
$connector->create($host, $port)->then(function (Stream $conn) { |
| 210 |
$conn->write("…"); |
| 211 |
}); |
| 212 |
|
| 213 |
// new |
| 214 |
$connector->connect($uri)->then(function (ConnectionInterface $conn) { |
| 215 |
$conn->write("…"); |
| 216 |
}); |
| 217 |
``` |
| 218 |
|
| 219 |
* Improve test suite by adding PHPUnit to require-dev |
| 220 |
(#7 by @clue) |
| 221 |
|
| 222 |
|
| 223 |
## 0.1.0 (2016-11-01) |
| 224 |
|
| 225 |
* First tagged release |