Initial Commit

This commit is contained in:
David Stone
2024-11-30 18:24:12 -07:00
commit e8f7955c1c
5432 changed files with 1397750 additions and 0 deletions

View File

@ -0,0 +1,147 @@
<?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 WP_Ultimo\Dependencies\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;
}
}
}