feat(IClient): Add `request` function to do arbitrary HTTP requests

Signed-off-by: Ferdinand Thiessen <opensource@fthiessen.de>

1 files changed, 31 insertions, 0 deletions

diff --git a/lib/public/Http/Client/IClient.php b/lib/public/Http/Client/IClient.php
index 9268eb62920..7bb3c032ea0 100644
--- a/lib/public/Http/Client/IClient.php
+++ b/lib/public/Http/Client/IClient.php
@@ -218,6 +218,37 @@ interface IClient {
 	public function getResponseFromThrowable(\Throwable $e): IResponse;
 
 	/**
+	 * Sends a HTTP request
+	 * @param string $uri
+	 * @param string $method The HTTP method to use
+	 * @param array $options Array such as
+	 *              'query' => [
+	 *                  'field' => 'abc',
+	 *                  'other_field' => '123',
+	 *                  'file_name' => fopen('/path/to/file', 'r'),
+	 *              ],
+	 *              'headers' => [
+	 *                  'foo' => 'bar',
+	 *              ],
+	 *              'cookies' => [
+	 *                  'foo' => 'bar',
+	 *              ],
+	 *              'allow_redirects' => [
+	 *                   'max'       => 10,  // allow at most 10 redirects.
+	 *                   'strict'    => true,     // use "strict" RFC compliant redirects.
+	 *                   'referer'   => true,     // add a Referer header
+	 *                   'protocols' => ['https'] // only allow https URLs
+	 *              ],
+	 *              'sink' => '/path/to/file', // save to a file or a stream
+	 *              'verify' => true, // bool or string to CA file
+	 *              'debug' => true,
+	 * @return IResponse
+	 * @throws \Exception If the request could not get completed
+	 * @since 29.0.0
+	 */
+	public function request(string $uri, string $method, array $options = []): IResponse;
+
+	/**
 	 * Sends an asynchronous GET request
 	 * @param string $uri
 	 * @param array $options Array such as