chillerlan\HTTP\HTTPClientAbstract

Complexity

Total Complexity

21

Size/Duplication

Total Lines	139
Duplicated Lines	0 %

Coupling/Cohesion

Components	0
Dependencies	0

Importance

Changes

0

5 Methods

Rating	Name	Duplication	Size	Complexity
A	__construct()	0	3	1
B	normalizeRequestHeaders()	0	23	4
A	rawurlencode()	0	11	3
B	buildQuery()	0	44	6
B	checkQueryParams()	0	17	7

<?php
/**
 * Class HTTPClientAbstract
 *
 * @filesource   HTTPClientAbstract.php
 * @created      09.07.2017
 * @package      chillerlan\HTTP
 * @author       Smiley <smiley@chillerlan.net>
 * @copyright    2017 Smiley
 * @license      MIT
 */

namespace chillerlan\HTTP;

use chillerlan\Traits\ContainerInterface;

abstract class HTTPClientAbstract implements HTTPClientInterface{

	/**
	 * @var mixed
	 */
	protected $http;

	/**
	 * @var \chillerlan\Traits\ContainerInterface|mixed
	 */
	protected $options;

	/** @inheritdoc */
	public function __construct(ContainerInterface $options){
		$this->options = $options;
	}

	/** @inheritdoc */
	public function normalizeRequestHeaders(array $headers):array {
		$normalized_headers = [];

		foreach($headers as $key => $val){

			if(is_numeric($key)){
				$header = explode(':', $val, 2);

				if(count($header) !== 2){
					continue;
				}

				$key = $header[0];
				$val = $header[1];
			}

			$key = ucfirst(strtolower($key));

			$normalized_headers[$key] = trim($key).': '.trim($val);
		}

		return $normalized_headers;
	}

	/**
	 * @param $data
	 *
	 * @return array|string
	 */
	protected function rawurlencode($data){

		if(is_array($data)){
			return array_map([$this, 'rawurlencode'], $data);
		}
		elseif(is_scalar($data)){
			return rawurlencode($data);
		}

		return $data;
	}

	/**
	 * from https://github.com/abraham/twitteroauth/blob/master/src/Util.php
	 *
	 * @param array  $params
	 * @param bool   $urlencode

Should the type for parameter $urlencode not be null|boolean?

	 * @param string $delimiter

Should the type for parameter $delimiter not be null|string?

	 * @param string $enclosure

Should the type for parameter $enclosure not be null|string?

	 *
	 * @return string
	 */
	public function buildQuery(array $params, bool $urlencode = null, string $delimiter = null, string $enclosure = null):string {

		if(empty($params)) {
			return '';
		}

		// urlencode both keys and values
		if($urlencode ?? true){
			$params = array_combine(
				$this->rawurlencode(array_keys($params)),
				$this->rawurlencode(array_values($params))
			);
		}

		// Parameters are sorted by name, using lexicographical byte value ordering.
		// Ref: Spec: 9.1.1 (1)

46% of this comment could be valid code. Did you maybe forget this after debugging?

		uksort($params, 'strcmp');

		$pairs     = [];
		$enclosure = $enclosure ?? '';

		foreach($params as $parameter => $value){

			if(is_array($value)) {
				// If two or more parameters share the same name, they are sorted by their value
				// Ref: Spec: 9.1.1 (1)

46% of this comment could be valid code. Did you maybe forget this after debugging?

				// June 12th, 2010 - changed to sort because of issue 164 by hidetaka
				sort($value, SORT_STRING);

				foreach ($value as $duplicateValue) {
					$pairs[] = $parameter.'='.$enclosure.$duplicateValue.$enclosure;
				}

			}
			else{
				$pairs[] = $parameter.'='.$enclosure.$value.$enclosure;
			}

		}

		// For each parameter, the name is separated from the corresponding value by an '=' character (ASCII code 61)
		// Each name-value pair is separated by an '&' character (ASCII code 38)
		return implode($delimiter ?? '&', $pairs);
	}

	/**
	 * @param array     $params
	 * @param bool|null $booleans_as_string - converts booleans to "true"/"false", otherwise "0"/"1"
	 *
	 * @return array
	 */
	public function checkQueryParams(array $params, bool $booleans_as_string = null){

		foreach($params as $key => $value){

			if(is_bool($value)){
				$params[$key] = $booleans_as_string === true
					? ($value ? 'true' : 'false')
					: (string)(int)$value;
			}
			elseif(is_null($value) || empty($value)){
				unset($params[$key]);
			}

		}

		return $params;
	}

}