1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
|
<?php
/**
* List of HTTP status codes.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
/**
* @todo document
*/
class HttpStatus {
/**
* @var null|callable
*/
private static $headersSentCallback = null;
public static function registerHeadersSentCallback( callable $callback ): ?callable {
$old = self::$headersSentCallback;
self::$headersSentCallback = $callback;
return $old;
}
/**
* Get the message associated with an HTTP response status code
*
* @param int $code Status code
* @return string|null Message, or null if $code is not known
*/
public static function getMessage( $code ) {
static $statusMessage = [
100 => 'Continue',
101 => 'Switching Protocols',
102 => 'Processing',
200 => 'OK',
201 => 'Created',
202 => 'Accepted',
203 => 'Non-Authoritative Information',
204 => 'No Content',
205 => 'Reset Content',
206 => 'Partial Content',
207 => 'Multi-Status',
300 => 'Multiple Choices',
301 => 'Moved Permanently',
302 => 'Found',
303 => 'See Other',
304 => 'Not Modified',
305 => 'Use Proxy',
307 => 'Temporary Redirect',
400 => 'Bad Request',
401 => 'Unauthorized',
402 => 'Payment Required',
403 => 'Forbidden',
404 => 'Not Found',
405 => 'Method Not Allowed',
406 => 'Not Acceptable',
407 => 'Proxy Authentication Required',
408 => 'Request Timeout',
409 => 'Conflict',
410 => 'Gone',
411 => 'Length Required',
412 => 'Precondition Failed',
413 => 'Request Entity Too Large',
414 => 'Request-URI Too Large',
415 => 'Unsupported Media Type',
416 => 'Request Range Not Satisfiable',
417 => 'Expectation Failed',
422 => 'Unprocessable Entity',
423 => 'Locked',
424 => 'Failed Dependency',
428 => 'Precondition Required',
429 => 'Too Many Requests',
431 => 'Request Header Fields Too Large',
500 => 'Internal Server Error',
501 => 'Not Implemented',
502 => 'Bad Gateway',
503 => 'Service Unavailable',
504 => 'Gateway Timeout',
505 => 'HTTP Version Not Supported',
507 => 'Insufficient Storage',
511 => 'Network Authentication Required',
];
return $statusMessage[$code] ?? null;
}
/**
* Construct an HTTP status code header
*
* @since 1.42
* @param int $code Status code
* @return string
*/
public static function getHeader( $code ): string {
static $version = null;
$message = self::getMessage( $code );
if ( $message === null ) {
throw new InvalidArgumentException( "Unknown HTTP status code $code" );
}
if ( $version === null ) {
$version = isset( $_SERVER['SERVER_PROTOCOL'] ) &&
$_SERVER['SERVER_PROTOCOL'] === 'HTTP/1.0' ?
'1.0' :
'1.1';
}
return "HTTP/$version $code $message";
}
/**
* Output an HTTP status code header
*
* @since 1.26
* @param int $code Status code
*/
public static function header( $code ) {
if ( headers_sent() ) {
if ( self::$headersSentCallback ) {
( self::$headersSentCallback )();
return;
}
// NOTE: If there is no custom callback, we continue normally and
// rely on the implementation of header() to emit a warning.
}
try {
header( self::getHeader( $code ) );
} catch ( InvalidArgumentException $ex ) {
trigger_error( "Unknown HTTP status code $code", E_USER_WARNING );
}
}
}
|
