Ticket #39043: 30943.patch

src/wp-includes/class-http.php

@@ -135 +135 @@
          *     @type string       sslcertificates      Absolute path to an SSL certificate .crt file.
          *                                             Default ABSPATH . WPINC . '/certificates/ca-bundle.crt'.
          *     @type bool         $stream              Whether to stream to a file. If set to true and no filename was
-         *                                             given, it will be droped it in the WP temp dir and its name will
-         *                                             be set using the basename of the URL. Default false.
+         *                                             given, the stream will be output to a new file in the WP temp dir
+         *                                             using a name generated from the basename of the URL. Default false.
          *     @type string       $filename            Filename of the file to write to when streaming. $stream must be
          *                                             set to true. Default null.
          *     @type int          $limit_response_size Size in bytes to limit the response to. Default null.
+         *     @type bool|null    $data_format         How the `$data` should be sent ('query' or 'body'). Default null.
+         *                                             If null, data will be sent as 'query' for HEAD/GET and as
+         *                                             'body' for POST/PUT/OPTIONS/PATCH/DELETE.
          *
          * }
          * @return array|WP_Error Array containing 'headers', 'body', 'response', 'cookies', 'filename'.
@@ -202 +205 @@
                         'stream' => false,
                         'filename' => null,
                         'limit_response_size' => null,
+                        'data_format' => null,
                 );
 
                 // Pre-parse for the HEAD checks.
@@ -333 +337 @@
                         $options['verify'] = $r['sslcertificates'];
                 }
 
-                // All non-GET/HEAD requests should put the arguments in the form body.
-                if ( 'HEAD' !== $type && 'GET' !== $type ) {
+                if ( null !== $r['data_format'] ) {
+                        $options['data_format'] = $r['data_format'];
+
+                } elseif ( 'HEAD' !== $type && 'GET' !== $type ) {
+                        // All non-GET/HEAD requests should put the arguments in the form body.
                         $options['data_format'] = 'body';
                 }