mirror of
https://github.com/WordPress/WordPress.git
synced 2024-11-02 16:59:35 +01:00
f221b3eb54
While some of the changes in the `1.8.0` release have already been copied to WordPress Core in earlier releases (see [38727], [46258], [47902] and [49382]), this release contains additional improvements, including: - A significant performance fix when using cURL. - Improved compliance with RFC2616. The library has also been moved under the WordPress project’s GitHub organization and can now be found at https://github.com/WordPress/Requests. Props jrf, dd32, rmccue, justinahinon, netweb, schlessera, TimothyBJacobs, soulseekah, ozh, skithund, carlalexander, travisnorthcutt, desrosj. Fixes #53101. Built from https://develop.svn.wordpress.org/trunk@50842 git-svn-id: http://core.svn.wordpress.org/trunk@50451 1a063a9b-81f0-0310-95a4-ce76da25c4cd
123 lines
2.5 KiB
PHP
123 lines
2.5 KiB
PHP
<?php
|
|
/**
|
|
* HTTP response class
|
|
*
|
|
* Contains a response from Requests::request()
|
|
* @package Requests
|
|
*/
|
|
|
|
/**
|
|
* HTTP response class
|
|
*
|
|
* Contains a response from Requests::request()
|
|
* @package Requests
|
|
*/
|
|
class Requests_Response {
|
|
/**
|
|
* Constructor
|
|
*/
|
|
public function __construct() {
|
|
$this->headers = new Requests_Response_Headers();
|
|
$this->cookies = new Requests_Cookie_Jar();
|
|
}
|
|
|
|
/**
|
|
* Response body
|
|
*
|
|
* @var string
|
|
*/
|
|
public $body = '';
|
|
|
|
/**
|
|
* Raw HTTP data from the transport
|
|
*
|
|
* @var string
|
|
*/
|
|
public $raw = '';
|
|
|
|
/**
|
|
* Headers, as an associative array
|
|
*
|
|
* @var Requests_Response_Headers Array-like object representing headers
|
|
*/
|
|
public $headers = array();
|
|
|
|
/**
|
|
* Status code, false if non-blocking
|
|
*
|
|
* @var integer|boolean
|
|
*/
|
|
public $status_code = false;
|
|
|
|
/**
|
|
* Protocol version, false if non-blocking
|
|
*
|
|
* @var float|boolean
|
|
*/
|
|
public $protocol_version = false;
|
|
|
|
/**
|
|
* Whether the request succeeded or not
|
|
*
|
|
* @var boolean
|
|
*/
|
|
public $success = false;
|
|
|
|
/**
|
|
* Number of redirects the request used
|
|
*
|
|
* @var integer
|
|
*/
|
|
public $redirects = 0;
|
|
|
|
/**
|
|
* URL requested
|
|
*
|
|
* @var string
|
|
*/
|
|
public $url = '';
|
|
|
|
/**
|
|
* Previous requests (from redirects)
|
|
*
|
|
* @var array Array of Requests_Response objects
|
|
*/
|
|
public $history = array();
|
|
|
|
/**
|
|
* Cookies from the request
|
|
*
|
|
* @var Requests_Cookie_Jar Array-like object representing a cookie jar
|
|
*/
|
|
public $cookies = array();
|
|
|
|
/**
|
|
* Is the response a redirect?
|
|
*
|
|
* @return boolean True if redirect (3xx status), false if not.
|
|
*/
|
|
public function is_redirect() {
|
|
$code = $this->status_code;
|
|
return in_array($code, array(300, 301, 302, 303, 307), true) || $code > 307 && $code < 400;
|
|
}
|
|
|
|
/**
|
|
* Throws an exception if the request was not successful
|
|
*
|
|
* @throws Requests_Exception If `$allow_redirects` is false, and code is 3xx (`response.no_redirects`)
|
|
* @throws Requests_Exception_HTTP On non-successful status code. Exception class corresponds to code (e.g. {@see Requests_Exception_HTTP_404})
|
|
* @param boolean $allow_redirects Set to false to throw on a 3xx as well
|
|
*/
|
|
public function throw_for_status($allow_redirects = true) {
|
|
if ($this->is_redirect()) {
|
|
if (!$allow_redirects) {
|
|
throw new Requests_Exception('Redirection not allowed', 'response.no_redirects', $this);
|
|
}
|
|
}
|
|
elseif (!$this->success) {
|
|
$exception = Requests_Exception_HTTP::get_class($this->status_code);
|
|
throw new $exception(null, $this);
|
|
}
|
|
}
|
|
}
|