|
1 | 1 | # Changelog |
2 | 2 |
|
| 3 | +## 1.0.0 (2018-11-07) |
| 4 | + |
| 5 | +* First stable release, now following SemVer! |
| 6 | + |
| 7 | + I'd like to thank [Bergfreunde GmbH](https://www.bergfreunde.de/), a German-based |
| 8 | + online retailer for Outdoor Gear & Clothing, for sponsoring large parts of this development! 🎉 |
| 9 | + Thanks to sponsors like this, who understand the importance of open source |
| 10 | + development, I can justify spending time and focus on open source development |
| 11 | + instead of traditional paid work. |
| 12 | + |
| 13 | + > Did you know that I offer custom development services and issuing invoices for |
| 14 | + sponsorships of releases and for contributions? Contact me (@clue) for details. |
| 15 | + |
| 16 | +* BC break / Feature: Replace `Factory` with simplified `Client` constructor, |
| 17 | + add support for optional SOAP options and non-WSDL mode and |
| 18 | + respect WSDL type definitions when decoding and support classmap option. |
| 19 | + (#31, #32 and #33 by @clue) |
| 20 | + |
| 21 | + ```php |
| 22 | + // old |
| 23 | + $factory = new Factory($loop); |
| 24 | + $client = $factory->createClientFromWsdl($wsdl); |
| 25 | + |
| 26 | + // new |
| 27 | + $browser = new Browser($loop); |
| 28 | + $client = new Client($browser, $wsdl); |
| 29 | + ``` |
| 30 | + |
| 31 | + The `Client` constructor now accepts an array of options. All given options will |
| 32 | + be passed through to the underlying `SoapClient`. However, not all options |
| 33 | + make sense in this async implementation and as such may not have the desired |
| 34 | + effect. See also [`SoapClient`](http://php.net/manual/en/soapclient.soapclient.php) |
| 35 | + documentation for more details. |
| 36 | + |
| 37 | + If working in WSDL mode, the `$options` parameter is optional. If working in |
| 38 | + non-WSDL mode, the WSDL parameter must be set to `null` and the options |
| 39 | + parameter must contain the `location` and `uri` options, where `location` is |
| 40 | + the URL of the SOAP server to send the request to, and `uri` is the target |
| 41 | + namespace of the SOAP service: |
| 42 | + |
| 43 | + ```php |
| 44 | + $client = new Client($browser, null, array( |
| 45 | + 'location' => 'http://example.com', |
| 46 | + 'uri' => 'http://ping.example.com', |
| 47 | + )); |
| 48 | + ``` |
| 49 | + |
| 50 | +* BC break: Mark all classes as final and all internal APIs as `@internal`. |
| 51 | + (#26 and #37 by @clue) |
| 52 | + |
| 53 | +* Feature: Add new `Client::withLocation()` method. |
| 54 | + (#38 by @floriansimon1, @pascal-hofmann and @clue) |
| 55 | + |
| 56 | + The `withLocation(string $location): self` method can be used to |
| 57 | + return a new `Client` with the updated location (URI) for all functions. |
| 58 | + |
| 59 | + Note that this is not to be confused with the WSDL file location. |
| 60 | + A WSDL file can contain any number of function definitions. |
| 61 | + It's very common that all of these functions use the same location definition. |
| 62 | + However, technically each function can potentially use a different location. |
| 63 | + |
| 64 | + ```php |
| 65 | + $client = $client->withLocation('http://example.com/soap'); |
| 66 | + |
| 67 | + assert('http://example.com/soap' === $client->getLocation('echo')); |
| 68 | + ``` |
| 69 | + |
| 70 | + As an alternative to this method, you can also set the `location` option |
| 71 | + in the `Client` constructor (such as when in non-WSDL mode). |
| 72 | + |
| 73 | +* Feature: Properly handle SOAP error responses, accept HTTP error responses and do not follow any HTTP redirects. |
| 74 | + (#35 by @clue) |
| 75 | + |
| 76 | +* Improve documentation and update project homepage, |
| 77 | + documentation for HTTP proxy servers, |
| 78 | + support timeouts for SOAP requests (HTTP timeout option) and |
| 79 | + add cancellation support. |
| 80 | + (#25, #29, #30 #34 and #36 by @clue) |
| 81 | + |
| 82 | +* Improve test suite by supporting PHPUnit 6, |
| 83 | + optionally skip functional integration tests requiring internet and |
| 84 | + test against PHP 7.2 and PHP 7.1 and latest ReactPHP components. |
| 85 | + (#24 by @carusogabriel and #27 and #28 by @clue) |
| 86 | + |
3 | 87 | ## 0.2.0 (2017-10-02) |
4 | 88 |
|
5 | 89 | * Feature: Added the possibility to use local WSDL files |
|
15 | 99 | (#13 by @clue) |
16 | 100 |
|
17 | 101 | * Feature: Forward compatibility with clue/buzz-react v2.0 and upcoming EventLoop |
18 | | - (#9 by floriansimon1 and #19 and #21 by @clue) |
| 102 | + (#9 by @floriansimon1 and #19 and #21 by @clue) |
19 | 103 |
|
20 | 104 | * Improve test suite by adding PHPUnit to require-dev and |
21 | 105 | test PHP 5.3 through PHP 7.0 and HHVM and |
|
0 commit comments