From 7009d90addaa72028a3664625a33c6f786232068 Mon Sep 17 00:00:00 2001
From: Philipp <admin@philipp.info>
Date: Fri, 20 Aug 2021 19:48:13 +0200
Subject: [PATCH] Introduce IHTTPResult Interface as abstraction for CurlResult

---
 src/Network/CurlResult.php  | 72 ++++++----------------------
 src/Network/IHTTPResult.php | 93 +++++++++++++++++++++++++++++++++++++
 2 files changed, 108 insertions(+), 57 deletions(-)
 create mode 100644 src/Network/IHTTPResult.php

diff --git a/src/Network/CurlResult.php b/src/Network/CurlResult.php
index 017f2c559..547bb4d28 100644
--- a/src/Network/CurlResult.php
+++ b/src/Network/CurlResult.php
@@ -29,7 +29,7 @@ use Friendica\Util\Network;
 /**
  * A content class for Curl call results
  */
-class CurlResult
+class CurlResult implements IHTTPResult
 {
 	/**
 	 * @var int HTTP return code or 0 if timeout or failure
@@ -229,33 +229,19 @@ class CurlResult
 		}
 	}
 
-	/**
-	 * Gets the Curl Code
-	 *
-	 * @return string The Curl Code
-	 */
+	/** {@inheritDoc} */
 	public function getReturnCode()
 	{
 		return $this->returnCode;
 	}
 
-	/**
-	 * Returns the Curl Content Type
-	 *
-	 * @return string the Curl Content Type
-	 */
+	/** {@inheritDoc} */
 	public function getContentType()
 	{
 		return $this->contentType;
 	}
 
-	/**
-	 * Returns the Curl headers
-	 *
-	 * @param string $field optional header field. Return all fields if empty
-	 *
-	 * @return string the Curl headers or the specified content of the header variable
-	 */
+	/** {@inheritDoc} */
 	public function getHeader(string $field = '')
 	{
 		if (empty($field)) {
@@ -273,13 +259,7 @@ class CurlResult
 		return '';
 	}
 
-	/**
-	 * Check if a specified header exists
-	 *
-	 * @param string $field header field
-	 *
-	 * @return boolean "true" if header exists
-	 */
+	/** {@inheritDoc} */
 	public function inHeader(string $field)
 	{
 		$field = strtolower(trim($field));
@@ -289,11 +269,7 @@ class CurlResult
 		return array_key_exists($field, $headers);
 	}
 
-	/**
-	 * Returns the Curl headers as an associated array
-	 *
-	 * @return array associated header array
-	 */
+	/** {@inheritDoc} */
 	public function getHeaderArray()
 	{
 		if (!empty($this->header_fields)) {
@@ -313,73 +289,55 @@ class CurlResult
 		return $this->header_fields;
 	}
 
-	/**
-	 * @return bool
-	 */
+	/** {@inheritDoc} */
 	public function isSuccess()
 	{
 		return $this->isSuccess;
 	}
 
-	/**
-	 * @return string
-	 */
+	/** {@inheritDoc} */
 	public function getUrl()
 	{
 		return $this->url;
 	}
 
-	/**
-	 * @return string
-	 */
+	/** {@inheritDoc} */
 	public function getRedirectUrl()
 	{
 		return $this->redirectUrl;
 	}
 
-	/**
-	 * @return string
-	 */
+	/** {@inheritDoc} */
 	public function getBody()
 	{
 		return $this->body;
 	}
 
-	/**
-	 * @return array
-	 */
+	/** {@inheritDoc} */
 	public function getInfo()
 	{
 		return $this->info;
 	}
 
-	/**
-	 * @return bool
-	 */
+	/** {@inheritDoc} */
 	public function isRedirectUrl()
 	{
 		return $this->isRedirectUrl;
 	}
 
-	/**
-	 * @return int
-	 */
+	/** {@inheritDoc} */
 	public function getErrorNumber()
 	{
 		return $this->errorNumber;
 	}
 
-	/**
-	 * @return string
-	 */
+	/** {@inheritDoc} */
 	public function getError()
 	{
 		return $this->error;
 	}
 
-	/**
-	 * @return bool
-	 */
+	/** {@inheritDoc} */
 	public function isTimeout()
 	{
 		return $this->isTimeout;
diff --git a/src/Network/IHTTPResult.php b/src/Network/IHTTPResult.php
new file mode 100644
index 000000000..be190c80c
--- /dev/null
+++ b/src/Network/IHTTPResult.php
@@ -0,0 +1,93 @@
+<?php
+
+namespace Friendica\Network;
+
+/**
+ * Temporary class to map Friendica used variables based on PSR-7 HTTPResponse
+ */
+interface IHTTPResult
+{
+	/**
+	 * Gets the Return Code
+	 *
+	 * @return string The Return Code
+	 */
+	public function getReturnCode();
+
+	/**
+	 * Returns the Content Type
+	 *
+	 * @return string the Content Type
+	 */
+	public function getContentType();
+
+	/**
+	 * Returns the headers
+	 *
+	 * @param string $field optional header field. Return all fields if empty
+	 *
+	 * @return string the headers or the specified content of the header variable
+	 */
+	public function getHeader(string $field = '');
+
+	/**
+	 * Check if a specified header exists
+	 *
+	 * @param string $field header field
+	 *
+	 * @return boolean "true" if header exists
+	 */
+	public function inHeader(string $field);
+
+	/**
+	 * Returns the headers as an associated array
+	 *
+	 * @return array associated header array
+	 */
+	public function getHeaderArray();
+
+	/**
+	 * @return bool
+	 */
+	public function isSuccess();
+
+	/**
+	 * @return string
+	 */
+	public function getUrl();
+
+	/**
+	 * @return string
+	 */
+	public function getRedirectUrl();
+
+	/**
+	 * @return string
+	 */
+	public function getBody();
+
+	/**
+	 * @return array
+	 */
+	public function getInfo();
+
+	/**
+	 * @return boolean
+	 */
+	public function isRedirectUrl();
+
+	/**
+	 * @return integer
+	 */
+	public function getErrorNumber();
+
+	/**
+	 * @return string
+	 */
+	public function getError();
+
+	/**
+	 * @return boolean
+	 */
+	public function isTimeout();
+}