Merge branch 'development' into stable

Author: mepihindeveloper

.gitignore

@@ -0,0 +1 @@
+/vendor/

README.md

@@ -1,2 +1,38 @@
 # php-headers
-Компонент для работы с заголовками в PHP
+
+Компонент для раб оты с заголовками в PHP
+
+# Структура
+
+```
+src/
+--- interfaces/
+--- Headers.php
+```
+
+В директории `interfaces` хранятся необходимые интерфейсы, которые необходимо имплементировать в при реализации
+собственного класса `Headers`.
+
+Класс `Headers` реализует интерфейс `HeadersInterface` для управления заголовками.
+
+# Доступные методы
+
+| Метод               | Аргументы                   | Возвращаемые данные | Исключения               | Описание                                                                    |
+|---------------------|-----------------------------|---------------------|--------------------------|-----------------------------------------------------------------------------|
+| set(array $params)  | Заголовок(и) [key => value] | void                |                          | Устанавливает заголовок(и)                                                  |
+| add(array $params)  | Заголовок(и) [key => value] | void                |                          | Добавляет заголовок. Если заголовок уже существует, то он будет перезаписан |
+| remove(string $key) | Заголовок                   | void                |                          | Удаляет заголовок                                                           |
+| removeAll           |                             | void                |                          | Удаляет все заголовки                                                       |
+| has(string $key)    | Заголовок                   | bool                |                          | Проверяет наличие заголовка. Проверка идет на наличие ключа и значения      |
+| get(string $key)    | Заголовок                   | string              | InvalidArgumentException | Получает значение заголовка                                                 |
+| getAll              |                             |                     |                          | Получает все заголовки                                                      |
+
+# Конакты
+
+Вы можете связаться со мной в социальной сети ВКонтакте: [ВКонтакте: Максим Епихин](https://vk.com/maximepihin)
+
+Если удобно писать на почту, то можете воспользоваться этим адресом: mepihindeveloper@gmail.com
+
+Мой канал на YouTube, который посвящен разработке веб и игровых проектов: [YouTube: Максим Епихин](https://www.youtube.com/channel/UCKusRcoHUy6T4sei-rVzCqQ)
+
+Поддержать меня можно переводом на Яндекс.Деньги: [Денежный перевод](https://yoomoney.ru/to/410012382226565)

composer.json

@@ -0,0 +1,28 @@
+{
+    "name": "mepihindeveloper/php-headers",
+    "description": "Component for working with headers",
+    "type": "library",
+    "license": "MIT",
+    "keywords": [
+        "component",
+        "class",
+        "php",
+        "headers"
+    ],
+    "authors": [
+        {
+            "name": "mepihindeveloper",
+            "email": "mepihindeveloper@gmail.com"
+        }
+    ],
+    "require": {
+        "php": "^7.4|^8.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "mepihindeveloper\\components\\": "src/"
+        }
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}

src/Headers.php

@@ -0,0 +1,131 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace mepihindeveloper\components;
+
+use InvalidArgumentException;
+use mepihindeveloper\components\interfaces\HeadersInterface;
+
+/**
+ * Класс Headers
+ *
+ * Реализует управление заголовками запроса
+ */
+class Headers implements HeadersInterface {
+	
+	/**
+	 * @var array Заголовки
+	 */
+	private array $headers;
+	
+	public function __construct()
+	{
+		$this->headers = $this->getAllHeaders();
+	}
+	
+	/**
+	 * Получает все заголовки методами apache и nginx
+	 *
+	 * @return array
+	 */
+	private function getAllHeaders(): array
+	{
+		if (function_exists('getallheaders')) {
+			return getallheaders() !== false ? getallheaders() : [];
+		}
+
+		if (!is_array($_SERVER))
+		{
+			return [];
+		}
+		
+		$headers = [];
+		
+		foreach ($_SERVER as $name => $value)
+		{
+			if (strpos($name, 'HTTP_') === 0)
+			{
+				$headers[str_replace(' ', '-', ucwords(strtolower(str_replace('_', ' ', substr($name, 5)))))] = $value;
+			}
+		}
+		
+		return $headers;
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function set(array $params): void {
+		$this->getAll();
+		
+		foreach ($params as $header => $value)
+		{
+			$this->headers[$header] = $value;
+		}
+		
+		$this->add($params);
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function add(array $params): void {
+		foreach ($params as $header => $value)
+		{
+			$headerExists = array_key_exists($header, $this->headers);
+			$this->headers[$header] = $value;
+			
+			header("{$header}: {$value}", $headerExists);
+		}
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function remove(string $key): void {
+		$this->getAll();
+		
+		unset($this->headers[$key]);
+		header_remove($key);
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function removeAll(): void {
+		$this->headers = [];
+		
+		header_remove();
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function has(string $key): bool {
+		$this->getAll();
+		
+		return array_key_exists($key, $this->headers);
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function get(string $key): string {
+		if (!$this->has($key))
+		{
+			throw new InvalidArgumentException("Заголоков {$key} отсутсвует.");
+		}
+		
+		return $this->headers[$key];
+	}
+	
+	/**
+	 * @inheritDoc
+	 */
+	public function getAll(): array {
+		$this->headers = !empty($this->headers) ? $this->headers : $this->getAllHeaders();
+		
+		return $this->headers;
+	}
+}

src/interfaces/HeadersInterface.php

@@ -0,0 +1,76 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace mepihindeveloper\components\interfaces;
+
+use InvalidArgumentException;
+
+/**
+ * Интерфейс HeadersInterface
+ *
+ * Декларирует методы обязательные для реализации компонента Headers
+ */
+interface HeadersInterface {
+	
+	/**
+	 * Устанавливает заголовок(и)
+	 *
+	 * @param array $params Заголовок(и) [key => value]
+	 *
+	 * @return void
+	 */
+	public function set(array $params): void;
+	
+	/**
+	 * Добавляет заголовок. Если заголовок уже существует, то он будет перезаписан.
+	 *
+	 * @param array $params Заголовки [key => value]
+	 *
+	 * @return void
+	 */
+	public function add(array $params): void;
+	
+	/**
+	 * Удаляет заголовок
+	 *
+	 * @param string $key Заголовок
+	 *
+	 * @return void
+	 */
+	public function remove(string $key): void;
+	
+	/**
+	 * Удаляет все заголовки
+	 *
+	 * @return void
+	 */
+	public function removeAll(): void;
+	
+	/**
+	 * Проверяет наличие заголовка. Проверка идет на наличие ключа и значения
+	 *
+	 * @param string $key Заголовок
+	 *
+	 * @return bool
+	 */
+	public function has(string $key): bool;
+	
+	/**
+	 * Получает значение заголовка
+	 *
+	 * @param string $key Заголовок
+	 *
+	 * @return string
+	 *
+	 * @throws InvalidArgumentException
+	 */
+	public function get(string $key): string;
+	
+	/**
+	 * Получает все заголовки
+	 *
+	 * @return array
+	 */
+	public function getAll(): array;
+}