Add more specific return types for the HTTP API functions.

Author: johnbillion

additionalParams.php

@@ -0,0 +1,10 @@
+<?php
+
+$httpReturnType = 'array{headers:array,body:string,response:array{code:int,message:string},cookies:WP_HTTP_Cookie[],filename:string|null}|WP_Error';
+
+return [
+    'wp_remote_get' => [$httpReturnType, 'url'=>'string', 'args'=>'array'],
+    'wp_remote_head' => [$httpReturnType, 'url'=>'string', 'args'=>'array'],
+    'wp_remote_post' => [$httpReturnType, 'url'=>'string', 'args'=>'array'],
+    'wp_remote_request' => [$httpReturnType, 'url'=>'string', 'args'=>'array'],
+];

wordpress-stubs.php

@@ -104097,6 +104097,9 @@ function wp_safe_remote_head($url, $args = array())
      *   cookies: WP_HTTP_Cookie[],
      *   http_response: WP_HTTP_Requests_Response|null,
      * }
+     * @phpstan-param string $url
+     * @phpstan-param array $args
+     * @phpstan-return array{headers:array,body:string,response:array{code:int,message:string},cookies:WP_HTTP_Cookie[],filename:string|null}|WP_Error
      */
     function wp_remote_request($url, $args = array())
     {
@@ -104112,6 +104115,9 @@ function wp_remote_request($url, $args = array())
      * @param string $url  URL to retrieve.
      * @param array  $args Optional. Request arguments. Default empty array.
      * @return array|WP_Error The response or WP_Error on failure.
+     * @phpstan-param string $url
+     * @phpstan-param array $args
+     * @phpstan-return array{headers:array,body:string,response:array{code:int,message:string},cookies:WP_HTTP_Cookie[],filename:string|null}|WP_Error
      */
     function wp_remote_get($url, $args = array())
     {
@@ -104127,6 +104133,9 @@ function wp_remote_get($url, $args = array())
      * @param string $url  URL to retrieve.
      * @param array  $args Optional. Request arguments. Default empty array.
      * @return array|WP_Error The response or WP_Error on failure.
+     * @phpstan-param string $url
+     * @phpstan-param array $args
+     * @phpstan-return array{headers:array,body:string,response:array{code:int,message:string},cookies:WP_HTTP_Cookie[],filename:string|null}|WP_Error
      */
     function wp_remote_post($url, $args = array())
     {
@@ -104142,6 +104151,9 @@ function wp_remote_post($url, $args = array())
      * @param string $url  URL to retrieve.
      * @param array  $args Optional. Request arguments. Default empty array.
      * @return array|WP_Error The response or WP_Error on failure.
+     * @phpstan-param string $url
+     * @phpstan-param array $args
+     * @phpstan-return array{headers:array,body:string,response:array{code:int,message:string},cookies:WP_HTTP_Cookie[],filename:string|null}|WP_Error
      */
     function wp_remote_head($url, $args = array())
     {