Wordpress 4.6

[autoinstalls/wordpress.git] / wp-includes / Requests / Response.php

diff --git a/wp-includes/Requests/Response.php b/wp-includes/Requests/Response.php
new file mode 100644 (file)
index 0000000..3152fb6
--- /dev/null
+++ b/wp-includes/Requests/Response.php
@@ -0,0 +1,121 @@
+<?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);
+               }
+       }
+}