京东云
This commit is contained in:
“wanyongkang”
68
vendor/guzzlehttp/guzzle/UPGRADING.md
vendored
68
vendor/guzzlehttp/guzzle/UPGRADING.md
vendored
@@ -1,60 +1,10 @@
|
||||
Guzzle Upgrade Guide
|
||||
====================
|
||||
|
||||
6.0 to 7.0
|
||||
----------
|
||||
|
||||
In order to take advantage of the new features of PHP, Guzzle dropped the support
|
||||
of PHP 5. The minimum supported PHP version is now PHP 7.2. Type hints and return
|
||||
types for functions and methods have been added wherever possible.
|
||||
|
||||
Please make sure:
|
||||
- You are calling a function or a method with the correct type.
|
||||
- If you extend a class of Guzzle; update all signatures on methods you override.
|
||||
|
||||
#### Other backwards compatibility breaking changes
|
||||
|
||||
- Class `GuzzleHttp\UriTemplate` is removed.
|
||||
- Class `GuzzleHttp\Exception\SeekException` is removed.
|
||||
- Classes `GuzzleHttp\Exception\BadResponseException`, `GuzzleHttp\Exception\ClientException`,
|
||||
`GuzzleHttp\Exception\ServerException` can no longer be initialized with an empty
|
||||
Response as argument.
|
||||
- Class `GuzzleHttp\Exception\ConnectException` now extends `GuzzleHttp\Exception\TransferException`
|
||||
instead of `GuzzleHttp\Exception\RequestException`.
|
||||
- Function `GuzzleHttp\Exception\ConnectException::getResponse()` is removed.
|
||||
- Function `GuzzleHttp\Exception\ConnectException::hasResponse()` is removed.
|
||||
- Constant `GuzzleHttp\ClientInterface::VERSION` is removed. Added `GuzzleHttp\ClientInterface::MAJOR_VERSION` instead.
|
||||
- Function `GuzzleHttp\Exception\RequestException::getResponseBodySummary` is removed.
|
||||
Use `\GuzzleHttp\Psr7\get_message_body_summary` as an alternative.
|
||||
- Function `GuzzleHttp\Cookie\CookieJar::getCookieValue` is removed.
|
||||
- Request option `exceptions` is removed. Please use `http_errors`.
|
||||
- Request option `save_to` is removed. Please use `sink`.
|
||||
- Pool option `pool_size` is removed. Please use `concurrency`.
|
||||
- We now look for environment variables in the `$_SERVER` super global, due to thread safety issues with `getenv`. We continue to fallback to `getenv` in CLI environments, for maximum compatibility.
|
||||
- The `get`, `head`, `put`, `post`, `patch`, `delete`, `getAsync`, `headAsync`, `putAsync`, `postAsync`, `patchAsync`, and `deleteAsync` methods are now implemented as genuine methods on `GuzzleHttp\Client`, with strong typing. The original `__call` implementation remains unchanged for now, for maximum backwards compatibility, but won't be invoked under normal operation.
|
||||
- The `log` middleware will log the errors with level `error` instead of `notice`
|
||||
- Support for international domain names (IDN) is now disabled by default, and enabling it requires installing ext-intl, linked against a modern version of the C library (ICU 4.6 or higher).
|
||||
|
||||
#### Native functions calls
|
||||
|
||||
All internal native functions calls of Guzzle are now prefixed with a slash. This
|
||||
change makes it impossible for method overloading by other libraries or applications.
|
||||
Example:
|
||||
|
||||
```php
|
||||
// Before:
|
||||
curl_version();
|
||||
|
||||
// After:
|
||||
\curl_version();
|
||||
```
|
||||
|
||||
For the full diff you can check [here](https://github.com/guzzle/guzzle/compare/6.5.4..master).
|
||||
|
||||
5.0 to 6.0
|
||||
----------
|
||||
|
||||
Guzzle now uses [PSR-7](https://www.php-fig.org/psr/psr-7/) for HTTP messages.
|
||||
Guzzle now uses [PSR-7](http://www.php-fig.org/psr/psr-7/) for HTTP messages.
|
||||
Due to the fact that these messages are immutable, this prompted a refactoring
|
||||
of Guzzle to use a middleware based system rather than an event system. Any
|
||||
HTTP message interaction (e.g., `GuzzleHttp\Message\Request`) need to be
|
||||
@@ -189,11 +139,11 @@ $client = new GuzzleHttp\Client(['handler' => $handler]);
|
||||
|
||||
## POST Requests
|
||||
|
||||
This version added the [`form_params`](https://docs.guzzlephp.org/en/latest/request-options.html#form_params)
|
||||
This version added the [`form_params`](http://guzzle.readthedocs.org/en/latest/request-options.html#form_params)
|
||||
and `multipart` request options. `form_params` is an associative array of
|
||||
strings or array of strings and is used to serialize an
|
||||
`application/x-www-form-urlencoded` POST request. The
|
||||
[`multipart`](https://docs.guzzlephp.org/en/latest/request-options.html#multipart)
|
||||
[`multipart`](http://guzzle.readthedocs.org/en/latest/request-options.html#multipart)
|
||||
option is now used to send a multipart/form-data POST request.
|
||||
|
||||
`GuzzleHttp\Post\PostFile` has been removed. Use the `multipart` option to add
|
||||
@@ -209,7 +159,7 @@ The `base_url` option has been renamed to `base_uri`.
|
||||
|
||||
## Rewritten Adapter Layer
|
||||
|
||||
Guzzle now uses [RingPHP](https://ringphp.readthedocs.org/en/latest) to send
|
||||
Guzzle now uses [RingPHP](http://ringphp.readthedocs.org/en/latest) to send
|
||||
HTTP requests. The `adapter` option in a `GuzzleHttp\Client` constructor
|
||||
is still supported, but it has now been renamed to `handler`. Instead of
|
||||
passing a `GuzzleHttp\Adapter\AdapterInterface`, you must now pass a PHP
|
||||
@@ -217,7 +167,7 @@ passing a `GuzzleHttp\Adapter\AdapterInterface`, you must now pass a PHP
|
||||
|
||||
## Removed Fluent Interfaces
|
||||
|
||||
[Fluent interfaces were removed](https://ocramius.github.io/blog/fluent-interfaces-are-evil/)
|
||||
[Fluent interfaces were removed](http://ocramius.github.io/blog/fluent-interfaces-are-evil)
|
||||
from the following classes:
|
||||
|
||||
- `GuzzleHttp\Collection`
|
||||
@@ -575,7 +525,7 @@ You can intercept a request and inject a response using the `intercept()` event
|
||||
of a `GuzzleHttp\Event\BeforeEvent`, `GuzzleHttp\Event\CompleteEvent`, and
|
||||
`GuzzleHttp\Event\ErrorEvent` event.
|
||||
|
||||
See: https://docs.guzzlephp.org/en/latest/events.html
|
||||
See: http://docs.guzzlephp.org/en/latest/events.html
|
||||
|
||||
## Inflection
|
||||
|
||||
@@ -668,9 +618,9 @@ in separate repositories:
|
||||
|
||||
The service description layer of Guzzle has moved into two separate packages:
|
||||
|
||||
- https://github.com/guzzle/command Provides a high level abstraction over web
|
||||
- http://github.com/guzzle/command Provides a high level abstraction over web
|
||||
services by representing web service operations using commands.
|
||||
- https://github.com/guzzle/guzzle-services Provides an implementation of
|
||||
- http://github.com/guzzle/guzzle-services Provides an implementation of
|
||||
guzzle/command that provides request serialization and response parsing using
|
||||
Guzzle service descriptions.
|
||||
|
||||
@@ -870,7 +820,7 @@ HeaderInterface (e.g. toArray(), getAll(), etc.).
|
||||
3.3 to 3.4
|
||||
----------
|
||||
|
||||
Base URLs of a client now follow the rules of https://datatracker.ietf.org/doc/html/rfc3986#section-5.2.2 when merging URLs.
|
||||
Base URLs of a client now follow the rules of http://tools.ietf.org/html/rfc3986#section-5.2.2 when merging URLs.
|
||||
|
||||
3.2 to 3.3
|
||||
----------
|
||||
|
||||
Reference in New Issue
Block a user