Viewing file: Response.php (2.45 KB) -rw-r--r-- Select action/file-type: (+) | (+) | (+) | Code (+) | Session (+) | (+) | SDB (+) | (+) | (+) | (+) | (+) | (+) |
<?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)) || $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); } } }
|