First Commit

2026-09-04 14:54:13 -03:00
commit 9c54bd3ac7
4914 changed files with 789004 additions and 0 deletions
@@ -0,0 +1,165 @@
+<?php
+
+/*
+ * PHP-HTTP (https://github.com/delight-im/PHP-HTTP)
+ * Copyright (c) delight.im (https://www.delight.im/)
+ * Licensed under the MIT License (https://opensource.org/licenses/MIT)
+ */
+
+namespace Delight\Http;
+
+/** HTTP response headers sent by the server */
+final class ResponseHeader {
+
+	private function __construct() { }
+
+	/**
+	 * Returns the header with the specified name (and optional value prefix)
+	 *
+	 * @param string $name the name of the header
+	 * @param string $valuePrefix the optional string to match at the beginning of the header's value
+	 * @return string|null the header (if found) or `null`
+	 */
+	public static function get($name, $valuePrefix = '') {
+		if (empty($name)) {
+			return null;
+		}
+
+		$nameLength = \strlen($name);
+		$headers = \headers_list();
+
+		foreach ($headers as $header) {
+			if (\strcasecmp(\substr($header, 0, $nameLength + 1), ($name . ':')) === 0) {
+				$headerValue = \trim(\substr($header, $nameLength + 1), "\t ");
+
+				if (empty($valuePrefix) || \substr($headerValue, 0, \strlen($valuePrefix)) === $valuePrefix) {
+					return $header;
+				}
+			}
+		}
+
+		return null;
+	}
+
+	/**
+	 * Returns the value of the header with the specified name (and optional value prefix)
+	 *
+	 * @param string $name the name of the header
+	 * @param string $valuePrefix the optional string to match at the beginning of the header's value
+	 * @return string|null the value of the header (if found) or `null`
+	 */
+	public static function getValue($name, $valuePrefix = '') {
+		$header = static::get($name, $valuePrefix);
+
+		if (!empty($header)) {
+			$nameLength = \strlen($name);
+			$headerValue = \substr($header, $nameLength + 1);
+			$headerValue = \trim($headerValue, "\t ");
+
+			return $headerValue;
+		}
+		else {
+			return null;
+		}
+	}
+
+	/**
+	 * Sets the header with the specified name and value
+	 *
+	 * If another header with the same name has already been set previously, that header will be overwritten
+	 *
+	 * @param string $name the name of the header
+	 * @param string $value the corresponding value for the header
+	 */
+	public static function set($name, $value) {
+		\header($name . ': ' . $value, true);
+	}
+
+	/**
+	 * Adds the header with the specified name and value
+	 *
+	 * If another header with the same name has already been set previously, both headers (or header values) will be sent
+	 *
+	 * @param string $name the name of the header
+	 * @param string $value the corresponding value for the header
+	 */
+	public static function add($name, $value) {
+		\header($name . ': ' . $value, false);
+	}
+
+	/**
+	 * Removes the header with the specified name (and optional value prefix)
+	 *
+	 * @param string $name the name of the header
+	 * @param string $valuePrefix the optional string to match at the beginning of the header's value
+	 * @return bool whether a header, as specified, has been found and removed
+	 */
+	public static function remove($name, $valuePrefix = '') {
+		return static::take($name, $valuePrefix) !== null;
+	}
+
+	/**
+	 * Returns and removes the header with the specified name (and optional value prefix)
+	 *
+	 * @param string $name the name of the header
+	 * @param string $valuePrefix the optional string to match at the beginning of the header's value
+	 * @return string|null the header (if found) or `null`
+	 */
+	public static function take($name, $valuePrefix = '') {
+		if (empty($name)) {
+			return null;
+		}
+
+		$nameLength = \strlen($name);
+		$headers = \headers_list();
+
+		$first = null;
+		$homonyms = [];
+
+		foreach ($headers as $header) {
+			if (\strcasecmp(\substr($header, 0, $nameLength + 1), ($name . ':')) === 0) {
+				$headerValue = \trim(\substr($header, $nameLength + 1), "\t ");
+
+				if ((empty($valuePrefix) || \substr($headerValue, 0, \strlen($valuePrefix)) === $valuePrefix) && $first === null) {
+					$first = $header;
+				}
+				else {
+					$homonyms[] = $header;
+				}
+			}
+		}
+
+		if ($first !== null) {
+			\header_remove($name);
+
+			foreach ($homonyms as $homonym) {
+				\header($homonym, false);
+			}
+		}
+
+		return $first;
+	}
+
+	/**
+	 * Returns the value of and removes the header with the specified name (and optional value prefix)
+	 *
+	 * @param string $name the name of the header
+	 * @param string $valuePrefix the optional string to match at the beginning of the header's value
+	 * @return string|null the value of the header (if found) or `null`
+	 */
+	public static function takeValue($name, $valuePrefix = '') {
+		$header = static::take($name, $valuePrefix);
+
+		if (!empty($header)) {
+			$nameLength = \strlen($name);
+			$headerValue = \substr($header, $nameLength + 1);
+			$headerValue = \trim($headerValue, "\t ");
+
+			return $headerValue;
+		}
+		else {
+			return null;
+		}
+	}
+
+}