HeadersCollection

14class HeadersCollection15{16    /**17     * @var array<string, list<string>> The headers with original casing.18     */19    private array $headers = [];20    /**21     * @var array<string, string> Map of lowercase header names to actual header names.22     */23    private array $headersMap = [];24    /**25     * Constructor.26     *27     * @since 0.1.028     *29     * @param array<string, string|list<string>> $headers Initial headers.30     */31    public function __construct(array $headers = [])32    {33        foreach ($headers as $name => $value) {34            $this->set($name, $value);35        }36    }37    /**38     * Gets a specific header value.39     *40     * @since 0.1.041     *42     * @param string $name The header name (case-insensitive).43     * @return list<string>|null The header value(s) or null if not found.44     */45    public function get(string $name): ?array46    {47        $lowerName = strtolower($name);48        if (!isset($this->headersMap[$lowerName])) {49            return null;50        }51        $actualName = $this->headersMap[$lowerName];52        return $this->headers[$actualName];53    }54    /**55     * Gets all headers.56     *57     * @since 0.1.058     *59     * @return array<string, list<string>> All headers with their original casing.60     */61    public function getAll(): array62    {63        return $this->headers;64    }65    /**66     * Gets header values as a comma-separated string.67     *68     * @since 0.1.069     *70     * @param string $name The header name (case-insensitive).71     * @return string|null The header values as a comma-separated string or null if not found.72     */73    public function getAsString(string $name): ?string74    {75        $values = $this->get($name);76        return $values !== null ? implode(', ', $values) : null;77    }78    /**79     * Checks if a header exists.80     *81     * @since 0.1.082     *83     * @param string $name The header name (case-insensitive).84     * @return bool True if the header exists, false otherwise.85     */86    public function has(string $name): bool87    {88        return isset($this->headersMap[strtolower($name)]);89    }90    /**91     * Sets a header value, replacing any existing value.92     *93     * @since 0.1.0