solid-performance / src / Performance / Http / Header.php

Header.php in Solid Performance – Your No-Code Caching, Performance, & Page Speed Solution 1.1.0, at src/Performance/Http/Header.php

180 lines 4.0 KB

Raw Download Zip

1	<?php
2	/**
3	* Holds HTTP headers.
4	*
5	* @see Header_Factory
6	*
7	* @since 1.0.0
8	*
9	* @package SolidWP\Performance
10	*/
11
12	declare( strict_types=1 );
13
14	namespace SolidWP\Performance\Http;
15
16	/**
17	* Holds HTTP headers.
18	*
19	* @see Header_Factory
20	*
21	* @since 1.0.0
22	*
23	* @package SolidWP\Performance
24	*/
25	class Header {
26
27	protected const UPPER = '_ABCDEFGHIJKLMNOPQRSTUVWXYZ';
28	protected const LOWER = '-abcdefghijklmnopqrstuvwxyz';
29
30	/**
31	* A list of response headers indexed by their header name.
32	*
33	* @var array<string, string[]>
34	*/
35	private array $headers;
36
37	/**
38	* @param string[] $headers The list of raw HTTP headers.
39	*/
40	public function __construct( array $headers ) {
41	$this->normalize_headers( $headers );
42	}
43
44	/**
45	* Returns headers.
46	*
47	* @param string\|null $name The name of the header, or if null, all headers.
48	*
49	* @return array<string, string[]>
50	*/
51	public function all( ?string $name = null ): array {
52	if ( null !== $name ) {
53	return $this->headers[ strtr( $name, self::UPPER, self::LOWER ) ] ?? [];
54	}
55
56	return $this->headers;
57	}
58
59	/**
60	* Returns true if the HTTP header is defined.
61	*
62	* @param string $name The header name.
63	*
64	* @return bool
65	*/
66	public function has( string $name ): bool {
67	return array_key_exists( strtr( $name, self::UPPER, self::LOWER ), $this->all() );
68	}
69
70	/**
71	* Returns the first header by name.
72	*
73	* @param string $name The header name.
74	*
75	* @return string\|null
76	*/
77	public function get( string $name ): ?string {
78	$headers = $this->all( $name );
79
80	if ( ! $headers ) {
81	return null;
82	}
83
84	if ( null === $headers[0] ) {
85	return null;
86	}
87
88	return implode( ', ', $headers );
89	}
90
91	/**
92	* Returns true if the given HTTP header contains the given value.
93	*
94	* @param string $name The header name.
95	* @param string $value The header value to look for.
96	*/
97	public function contains( string $name, string $value ): bool {
98	return in_array( $value, $this->all( $name ), true );
99	}
100
101	/**
102	* Returns true if the given HTTP header starts with the given value.
103	*
104	* @param string $name The header name.
105	* @param string $value The header value to look for.
106	*
107	* @return bool
108	*/
109	public function starts_with( string $name, string $value ): bool {
110	$headers = $this->all( $name );
111
112	if ( ! $headers ) {
113	return false;
114	}
115
116	foreach ( $headers as $header_value ) {
117	if ( str_starts_with( strtolower( $header_value ), strtolower( $value ) ) ) {
118	return true;
119	}
120	}
121
122	return false;
123	}
124
125	/**
126	* Sets a header by name.
127	*
128	* @param string $name The header name.
129	* @param string\|string[]\|null $values The value or an array of values.
130	* @param bool $replace Whether to replace the actual value or not (true by default).
131	*/
132	public function set( string $name, $values, bool $replace = true ): void {
133	$name = strtr( $name, self::UPPER, self::LOWER );
134
135	if ( is_array( $values ) ) {
136	$values = array_values( $values );
137
138	if ( true === $replace \|\| ! isset( $this->headers[ $name ] ) ) {
139	$this->headers[ $name ] = $values;
140	} else {
141	$this->headers[ $name ] = array_merge( $this->headers[ $name ], $values );
142	}
143	} elseif ( true === $replace \|\| ! isset( $this->headers[ $name ] ) ) {
144	$this->headers[ $name ] = [ $values ];
145	} else {
146	$this->headers[ $name ][] = $values;
147	}
148	}
149
150	/**
151	* Removes a header.
152	*
153	* @param string $name The header name.
154	*
155	* @return void
156	*/
157	public function remove( string $name ): void {
158	unset( $this->headers[ strtr( $name, self::UPPER, self::LOWER ) ] );
159	}
160
161	/**
162	* Normalize and format the HTTP headers.
163	*
164	* @param string[] $headers The raw HTTP headers.
165	*/
166	private function normalize_headers( array $headers ): void {
167	foreach ( $headers as $header ) {
168	// Split the header into name and value parts.
169	[ $name, $value ] = explode( ':', $header, 2 ) + [ null, null ];
170
171	$name = trim( $name );
172	$value = trim( $value );
173
174	$name = strtr( $name, self::UPPER, self::LOWER );
175
176	$this->set( $name, $value, false );
177	}
178	}
179	}
180