27 KiB
Changelog
1.8.1
Overview of changes
- The
Requests::VERSION
constant has been updated to reflect the actual version for the release. @jrfnl, #485 - Update the
.gitattributes
file to include fewer files in the distribution. @mbabker, #484 - Added a release checklist. @jrfnl, #483
- Various minor updates to the documentation and the website. @jrfnl, @schlessera, #477, #478, #479, #481, #482
1.8.0
IMPORTANT NOTES
Last release supporting PHP 5.2 - 5.5
Release 1.8.0 will be the last release with compatibility for PHP 5.2 - 5.5. With the next release (v2.0.0), the minimum PHP version will be bumped to 5.6.
Last release supporting PEAR distribution
Release 1.8.0 will be the last release to be distributed via PEAR. From release 2.0.0 onwards, consumers of this library will have to switch to Composer to receive updates.
Overview of changes
-
[SECURITY FIX] Disable deserialization in
FilteredIterator
A
Deserialization of Untrusted Data
weakness was found in theFilteredIterator
class.This security vulnerability was first reported to the WordPress project. The security fix applied to WordPress has been ported back into the library.
GitHub security advisory: Insecure Deserialization of untrusted data
CVE: CVE-2021-29476 - Deserialization of Untrusted Data
Related WordPress CVE: https://cve.mitre.org/cgi-bin/cvename.cgi?name=2020-28032
(props @dd32, @desrosj, @jrfnl, @peterwilsoncc, @SergeyBiryukov, @whyisjake, @xknown, #421, #422)
-
Repository moved to
WordPress\Requests
The
Requests
library has been moved to the WordPress GitHub organization and can now be found underhttps://github.com/WordPress/Requests
.All links in code and documentation were updated accordingly.
Note: the Composer package name remains unchanged (
rmccue/requests
), as well as the documentation site (requests.ryanmccue.info).(props @dd32, @JustinyAhin, @jrfnl, @rmccue, #440, #441, #448)
-
Manage
"Expect"
header withcURL
transportBy default,
cURL
adds aExpect: 100-Continue
header to certain requests. This can add as much as a second delay to requests done usingcURL
. This is discussed on the cURL mailing list.To prevent this,
Requests
now adds an empty"Expect"
header to requests that are smaller than 1 MB and use HTTP/1.1.(props @carlalexander, @schlessera, @TimothyBJacobs, #453, #454, #469)
-
Update bundled certificates as of 2021-02-12
The bundled certificates were updated. A small subset of expired certificates are still included for legacy reasons (and support).
(props @ozh, @patmead, @schlessera, @todeveni, #385, #398, #451)
-
Add required
Content-*
headers for emptyPOST
requestsSends the
Content-Length
andContent-Type
headers even for emptyPOST
requests, as the length is expected as per RFC2616 Section 14.13:Content-Length header "SHOULD" be included. In practice, it is not used for GET nor HEAD requests, but is expected for POST requests.
(props @dd32, @gstrauss, @jrfnl, @soulseekah, #248, #249, #318, #368)
-
Ignore locale when creating the HTTP version string from a float
The previous behavior allowed for the locale to mess up the float to string conversion resulting in a
GET / HTTP/1,1
instead ofGET / HTTP/1.1
request.(props @tonebender, @Zegnat, #335, #339)
-
Make
verify => false
work withfsockopen
This allows the
fsockopen
transport now to ignore SSL failures when requested.(props @soulseekah, #310, #311)
-
Only include port number in the
Host
header if it differs from the defaultThe code was not violating the RFC per se, but also not following standard practice of leaving the port off when it is the default port for the scheme, which could lead to connectivity issues.
-
Fix PHP cross-version compatibility
Important fixes have been made to improve cross-version compatibility of the code across all supported PHP versions.
- Use documented order for
implode()
arguments. - Harden type handling when no domain was passed.
- Explicitly cast
$url
property tostring
inRequests::parse_response()
. - Initialize
$body
property to an empty string inRequests::parse_response()
. - Ensure the stream handle is valid before trying to close it.
- Ensure the
$callback
in theFilteredIterator
is callable before calling it.
(props @aaronjorbin, @jrfnl, #346, #370, #425, #426, #456, #457)
- Use documented order for
-
Improve testing
Lots of improvements were made to render the tests more reliable and increase the coverage.
And to top it all off, all tests are now run against all supported PHP versions, including PHP 8.0.
(props @datagutten, @jrfnl, @schlessera, #345, #351, #355, #366, #412, #414, #445, #458, #464)
-
Improve code quality and style
A whole swoop of changes has been made to harden the code and make it more consistent.
The code style has been made consistent across both code and tests and is now enforced via a custom PHPCS rule set.
The WordPress Coding Standards were chosen as the basis for the code style checks as most contributors to this library originate from the WordPress community and will be familiar with this code style.
Main differences from the WordPress Coding Standards based on discussions and an analysis of the code styles already in use:
- No whitespace on the inside of parentheses.
- No Yoda conditions.
A more detailed overview of the decisions that went into the final code style rules can be found at #434.
(props @jrfnl, @KasperFranz, @ozh, @schlessera, @TysonAndre, #263, #296, #328, #358, #359, #360, #361, #362, #363, #364, #386, #396, #399, #400, #401, #402, #403, #404, #405, #406, #408, #409, #410, #411, #413, #415, #416, #417, #423, #424, #434)
-
Replace Travis CI with GitHub Actions (partial)
The entire CI setup is gradually being moved from Travis CI to GitHub Actions.
At this point, GitHub Actions takes over the CI from PHP 5.5 onwards, leaving Travis CI as a fallback for lower PHP versions.
This move will be completed after the planned minimum version bump to PHP 5.6+ with the next release, at which point we will get rid of all the remaining Travis CI integrations.
(props @dd32, @desrosj, @jrfnl, @ntwb, @ozh, @schlessera, @TimothyBJacobs, @TysonAndre, #280, #298, #302, #303, #352, #353, #354, #356, #388, #397, #428, #436, #439, #461, #467)
-
Update and improve documentation
- Use clearer and more inclusive language.
- Update the GitHub Pages site.
- Update content and various tweaks to the markdown.
- Fix code blocks in
README.md
file. - Add pagination to documentation pages.
(props @desrosj, @jrfnl, @JustinyAhin, @tnorthcutt, #334, #367, #387, #443, #462, #465, #468, #471 )
1.7.0
-
Add support for HHVM and PHP 7
Requests is now tested against both HHVM and PHP 7, and they are supported as first-party platforms.
-
Transfer & connect timeouts, in seconds & milliseconds
cURL is unable to handle timeouts under a second in DNS lookups, so we round those up to ensure 1-999ms isn't counted as an instant failure.
-
Rework cookie handling to be more thorough.
Cookies are now restricted to the same-origin by default, expiration is checked.
(props @catharsisjelly, @rmccue, #120, #124, #130, #132, #156)
-
Improve testing
Tests are now run locally to speed them up, as well as further general improvements to the quality of the testing suite. There are now also comprehensive proxy tests to ensure coverage there.
(props @rmccue, #75, #107, #170, #177, #181, #183, #185, #196, #202, #203)
-
Support custom HTTP methods
Previously, custom HTTP methods were only supported on sockets; they are now supported across all transports.
-
Add byte limit option
-
Support a Requests_Proxy_HTTP() instance for the proxy setting.
-
Add progress hook
-
Add a before_redirect hook to alter redirects
-
Pass cURL info to after_request
-
Remove explicit autoload in Composer installation instructions
-
Restrict CURLOPT_PROTOCOLS on
defined()
instead ofversion_compare()
-
Fix doc - typo in "Authentication"
-
Contextually check for a valid transport
-
Follow relative redirects correctly
-
Use cURL's version_number
-
Removed duplicated option docs
-
code styling fixed
-
Fix IRI "normalization"
-
Mention two PHP extension dependencies in the README.
-
Ignore coverage report files
-
drop obsolete "return" after throw
-
Updated exception message to specify both http + https
(props @beutnagel, #162)
-
Sets
stream_headers
method to public to allow calling it from other places. -
Remove duplicated stream_get_meta_data call
-
Transmits $errno from stream_socket_client in exception
(props @laurentmartelli, #174)
-
Correct methods to use snake_case
-
Improve code quality
-
Update Build Status image
-
Fix/Rationalize transports (v2)
-
Surface cURL errors
-
Fix for memleak and curl_close() never being called
-
addex how to install with composer
-
Uppercase the method to ensure compatibility
-
Store default certificate path
-
Force closing keep-alive connections on old cURL
-
Docs: Updated HTTP links with HTTPS links where applicable
-
Remove the executable bit
-
Change more links to HTTPS
-
Bail from cURL when either
curl_init()
ORcurl_exec()
are unavailable -
Disable OpenSSL's internal peer_name checking when
verifyname
is disabled. -
Only include the port number in the
Host
header when it differs from default -
Respect port if specified for HTTPS connections
-
Allow paths starting with a double-slash
-
Fixes bug in rfc2616 #3.6.1 implementation.
(props @stephenharris, #236, #3)
-
CURLOPT_HTTPHEADER在php7接受空数组导致php-fpm奔溃
(props @qibinghua, #219)
1.6.0
-
Add multiple request support - Send multiple HTTP requests with both fsockopen and cURL, transparently falling back to synchronous when not supported.
-
Add proxy support - HTTP proxies are now natively supported via a high-level API. Major props to Ozh for his fantastic work on this.
-
Verify host name for SSL requests - Requests is now the first and only standalone HTTP library to fully verify SSL hostnames even with socket connections. Thanks to Michael Adams, Dion Hulse, Jon Cave, and Pádraic Brady for reviewing the crucial code behind this.
-
Add cookie support - Adds built-in support for cookies (built entirely as a high-level API)
-
Add sessions - To compliment cookies, sessions can be created with a base URL and default options, plus a shared cookie jar.
-
Add Composer support - You can now install Requests via the
rmccue/requests
package on Composer
[View all changes][https://github.com/WordPress/Requests/compare/v1.5.0...v1.6.0]
1.5.0
Initial release!