mirror of
https://github.com/WordPress/WordPress.git
synced 2024-08-31 10:09:46 +02:00
This is a major release and contains breaking changes. Most important changes to be aware of for this release: * All code is now namespaced. Though there is a full backward compatibility layer available and the old class names are still supported, using them will generate a deprecation notice (which can be silenced by plugins if they'd need to support multiple WP versions). See the [https://requests.ryanmccue.info/docs/upgrading.html upgrade guide] for more details. * A lot of classes have been marked `final`. This should generally not affect userland code as care has been taken to not apply the `final` keyword to classes which are known to be extended in userland code. * Extensive input validation has been added to Requests. When Requests is used as documented though, this will be unnoticable. * A new `WpOrg\Requests\Requests::has_capabilities()` method has been introduced which can be used to address #37708. * A new `WpOrg\Requests\Response::decode_body()` method has been introduced which may be usable to simplify some of the WP native wrapper code. * Remaining PHP 8.0 compatibility fixed (support for named parameters). * PHP 8.1 compatibility. Release notes: https://github.com/WordPress/Requests/releases/tag/v2.0.0 For a full list of changes in this update, see the Requests GitHub: https://github.com/WordPress/Requests/compare/v1.8.1...v2.0.0 This commit also resolves 2 blocking issues which previously caused the revert of [52244]: * New Requests files are loaded into `wp-includes/Requests/src/`, matching the location of the library. In doing so, filesystems that are case-insensitive are not impacted (see #54582). * Preload: During a Core update, the old Requests files are preloaded into memory before the update deletes the files. Preloading avoids fatal errors noted in #54562. Follow-up to [50842], [51078], [52244], [52315], [52327], [52328]. Props jrf, schlessera, datagutten, wojsmol, dustinrue, soulseekah, szepeviktor. costdev, sergeybiryukov, peterwilsoncc, ironprogrammer, antonvlasenko, hellofromTonya, swissspidy, dd32, azaozz, TobiasBg, audrasjb. Fixes #54504. See #54582, #54562. Built from https://develop.svn.wordpress.org/trunk@54997 git-svn-id: http://core.svn.wordpress.org/trunk@54530 1a063a9b-81f0-0310-95a4-ce76da25c4cd
198 lines
4.3 KiB
PHP
198 lines
4.3 KiB
PHP
<?php
|
|
/**
|
|
* HTTP API: WP_HTTP_Requests_Response class
|
|
*
|
|
* @package WordPress
|
|
* @subpackage HTTP
|
|
* @since 4.6.0
|
|
*/
|
|
|
|
/**
|
|
* Core wrapper object for a WpOrg\Requests\Response for standardisation.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @see WP_HTTP_Response
|
|
*/
|
|
class WP_HTTP_Requests_Response extends WP_HTTP_Response {
|
|
/**
|
|
* Requests Response object.
|
|
*
|
|
* @since 4.6.0
|
|
* @var \WpOrg\Requests\Response
|
|
*/
|
|
protected $response;
|
|
|
|
/**
|
|
* Filename the response was saved to.
|
|
*
|
|
* @since 4.6.0
|
|
* @var string|null
|
|
*/
|
|
protected $filename;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @param \WpOrg\Requests\Response $response HTTP response.
|
|
* @param string $filename Optional. File name. Default empty.
|
|
*/
|
|
public function __construct( WpOrg\Requests\Response $response, $filename = '' ) {
|
|
$this->response = $response;
|
|
$this->filename = $filename;
|
|
}
|
|
|
|
/**
|
|
* Retrieves the response object for the request.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return WpOrg\Requests\Response HTTP response.
|
|
*/
|
|
public function get_response_object() {
|
|
return $this->response;
|
|
}
|
|
|
|
/**
|
|
* Retrieves headers associated with the response.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return \WpOrg\Requests\Utility\CaseInsensitiveDictionary Map of header name to header value.
|
|
*/
|
|
public function get_headers() {
|
|
// Ensure headers remain case-insensitive.
|
|
$converted = new WpOrg\Requests\Utility\CaseInsensitiveDictionary();
|
|
|
|
foreach ( $this->response->headers->getAll() as $key => $value ) {
|
|
if ( count( $value ) === 1 ) {
|
|
$converted[ $key ] = $value[0];
|
|
} else {
|
|
$converted[ $key ] = $value;
|
|
}
|
|
}
|
|
|
|
return $converted;
|
|
}
|
|
|
|
/**
|
|
* Sets all header values.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @param array $headers Map of header name to header value.
|
|
*/
|
|
public function set_headers( $headers ) {
|
|
$this->response->headers = new WpOrg\Requests\Response\Headers( $headers );
|
|
}
|
|
|
|
/**
|
|
* Sets a single HTTP header.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @param string $key Header name.
|
|
* @param string $value Header value.
|
|
* @param bool $replace Optional. Whether to replace an existing header of the same name.
|
|
* Default true.
|
|
*/
|
|
public function header( $key, $value, $replace = true ) {
|
|
if ( $replace ) {
|
|
unset( $this->response->headers[ $key ] );
|
|
}
|
|
|
|
$this->response->headers[ $key ] = $value;
|
|
}
|
|
|
|
/**
|
|
* Retrieves the HTTP return code for the response.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return int The 3-digit HTTP status code.
|
|
*/
|
|
public function get_status() {
|
|
return $this->response->status_code;
|
|
}
|
|
|
|
/**
|
|
* Sets the 3-digit HTTP status code.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @param int $code HTTP status.
|
|
*/
|
|
public function set_status( $code ) {
|
|
$this->response->status_code = absint( $code );
|
|
}
|
|
|
|
/**
|
|
* Retrieves the response data.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return string Response data.
|
|
*/
|
|
public function get_data() {
|
|
return $this->response->body;
|
|
}
|
|
|
|
/**
|
|
* Sets the response data.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @param string $data Response data.
|
|
*/
|
|
public function set_data( $data ) {
|
|
$this->response->body = $data;
|
|
}
|
|
|
|
/**
|
|
* Retrieves cookies from the response.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return WP_HTTP_Cookie[] List of cookie objects.
|
|
*/
|
|
public function get_cookies() {
|
|
$cookies = array();
|
|
foreach ( $this->response->cookies as $cookie ) {
|
|
$cookies[] = new WP_Http_Cookie(
|
|
array(
|
|
'name' => $cookie->name,
|
|
'value' => urldecode( $cookie->value ),
|
|
'expires' => isset( $cookie->attributes['expires'] ) ? $cookie->attributes['expires'] : null,
|
|
'path' => isset( $cookie->attributes['path'] ) ? $cookie->attributes['path'] : null,
|
|
'domain' => isset( $cookie->attributes['domain'] ) ? $cookie->attributes['domain'] : null,
|
|
'host_only' => isset( $cookie->flags['host-only'] ) ? $cookie->flags['host-only'] : null,
|
|
)
|
|
);
|
|
}
|
|
|
|
return $cookies;
|
|
}
|
|
|
|
/**
|
|
* Converts the object to a WP_Http response array.
|
|
*
|
|
* @since 4.6.0
|
|
*
|
|
* @return array WP_Http response array, per WP_Http::request().
|
|
*/
|
|
public function to_array() {
|
|
return array(
|
|
'headers' => $this->get_headers(),
|
|
'body' => $this->get_data(),
|
|
'response' => array(
|
|
'code' => $this->get_status(),
|
|
'message' => get_status_header_desc( $this->get_status() ),
|
|
),
|
|
'cookies' => $this->get_cookies(),
|
|
'filename' => $this->filename,
|
|
);
|
|
}
|
|
}
|