Make PHPDoc comments adhere to standard and getHeader and clearHeader and getHttpResponseCode to interface

Author: Vinai

lib/internal/Magento/Framework/App/Response/HttpInterface.php

@@ -17,11 +17,17 @@ interface HttpInterface extends \Magento\Framework\App\ResponseInterface
      */
     public function setHttpResponseCode($code);
 
+    /**
+     * Get HTTP response code
+     *
+     * @return int
+     */
+    public function getHttpResponseCode();
+
     /**
      * Set a header
      *
-     * If $replace is true, replaces any headers already defined with that
-     * $name.
+     * If $replace is true, replaces any headers already defined with that $name.
      *
      * @param string $name
      * @param string $value
@@ -31,6 +37,34 @@ public function setHttpResponseCode($code);
     public function setHeader($name, $value, $replace = false);
 
     /**
+     * Get header value by name
+     * 
+     * Returns first found header by passed name.
+     * If header with specified name was not found returns false.
+     *
+     * @param string $name
+     * @return \Zend\Http\Header\HeaderInterface|bool
+     */
+    public function getHeader($name);
+
+    /**
+     * Remove header by name from header stack
+     *
+     * @param string $name
+     * @return self
+     */
+    public function clearHeader($name);
+
+    /**
+     * Allow granular setting of HTTP response status code, version and phrase
+     * 
+     * For example, a HTTP response as the following:
+     *     HTTP 200 1.1 Your response has been served
+     * Can be set with the arguments
+     *     $httpCode = 200
+     *     $version = 1.1
+     *     $phrase = 'Your response has been served'
+     * 
      * @param int|string $httpCode
      * @param null|int|string $version
      * @param null|string $phrase
@@ -39,12 +73,18 @@ public function setHeader($name, $value, $replace = false);
     public function setStatusHeader($httpCode, $version = null, $phrase = null);
 
     /**
+     * Append the given string to the response body
+     * 
      * @param string $value
      * @return self
      */
     public function appendBody($value);
 
     /**
+     * Set the response body to the given value
+     * 
+     * Any previously set contents will be replaced by the new content.
+     * 
      * @param string $value
      * @return self
      */
@@ -53,8 +93,7 @@ public function setBody($value);
     /**
      * Set redirect URL
      *
-     * Sets Location header and response code. Forces replacement of any prior
-     * redirects.
+     * Sets Location header and response code. Forces replacement of any prior redirects.
      *
      * @param string $url
      * @param int $code