freenetis-github/application/vendors/phpax-rs/common/HttpUtil.php @ 410613f3
| 74a7dbca | Michal Kliment | <?php
|
|
/*
|
|||
* This file is a part of PHPAX-RS framework, released under terms of GPL-3.0
|
|||
* licence. Copyright (c) 2014, UnArt Slavičín, o.s. All rights reserved.
|
|||
*/
|
|||
namespace phpaxrs\common;
|
|||
/**
|
|||
* The "HttpUtil" class that cotain utility methods related to HTTP.
|
|||
*
|
|||
* @author Ondřej Fibich <ondrej.fibich@gmail.com>
|
|||
*/
|
|||
class HttpUtil {
|
|||
/**
|
|||
* List of all HTTP status messages.
|
|||
*
|
|||
* @var Array
|
|||
*/
|
|||
private static $messages = array(
|
|||
// Informational 1xx
|
|||
100 => 'Continue',
|
|||
101 => 'Switching Protocols',
|
|||
// Success 2xx
|
|||
200 => 'OK',
|
|||
201 => 'Created',
|
|||
202 => 'Accepted',
|
|||
203 => 'Non-Authoritative Information',
|
|||
204 => 'No Content',
|
|||
205 => 'Reset Content',
|
|||
206 => 'Partial Content',
|
|||
// Redirection 3xx
|
|||
300 => 'Multiple Choices',
|
|||
301 => 'Moved Permanently',
|
|||
302 => 'Found', // 1.1
|
|||
303 => 'See Other',
|
|||
304 => 'Not Modified',
|
|||
305 => 'Use Proxy',
|
|||
// 306 is deprecated but reserved
|
|||
307 => 'Temporary Redirect',
|
|||
// Client Error 4xx
|
|||
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 Long',
|
|||
415 => 'Unsupported Media Type',
|
|||
416 => 'Requested Range Not Satisfiable',
|
|||
417 => 'Expectation Failed',
|
|||
// Server Error 5xx
|
|||
500 => 'Internal Server Error',
|
|||
501 => 'Not Implemented',
|
|||
502 => 'Bad Gateway',
|
|||
503 => 'Service Unavailable',
|
|||
504 => 'Gateway Timeout',
|
|||
505 => 'HTTP Version Not Supported',
|
|||
509 => 'Bandwidth Limit Exceeded'
|
|||
);
|
|||
/**
|
|||
* Gets message for the given HTTP status code.
|
|||
*
|
|||
* @param int $status
|
|||
* @return null|string
|
|||
*/
|
|||
public function status_message($status) {
|
|||
if (array_key_exists($status, self::$messages)) {
|
|||
return self::$messages[$status];
|
|||
}
|
|||
return NULL;
|
|||
}
|
|||
/**
|
|||
* Parses HTTP accept header and returned ordered by height.
|
|||
*
|
|||
* @param string $accepts HTTP accept header string
|
|||
* @return array array of MIME types
|
|||
*/
|
|||
public static function parse_accept_header($accepts) {
|
|||
if (empty($accepts)) {
|
|||
return array();
|
|||
}
|
|||
// parse parts of accepts
|
|||
$accepts_parts = array_map('trim', explode(',', $accepts));
|
|||
$accepts_parsed = array();
|
|||
// parse
|
|||
foreach ($accepts_parts as $accepts_part) {
|
|||
$subparts = array_map('trim', explode(';', $accepts_part));
|
|||
$weight = 1.0;
|
|||
if (count($subparts) > 1 && strncmp($subparts[1], 'q=', 2) == 0) {
|
|||
$weight = floatval(substr($subparts[1], 2));
|
|||
}
|
|||
$accepts_parsed[$subparts[0]] = $weight;
|
|||
}
|
|||
// sort by weight (we need stable algorithm!)
|
|||
array_multisort($accepts_parsed, SORT_DESC, SORT_NUMERIC,
|
|||
range(1, count($accepts_parsed)), SORT_ASC, SORT_NUMERIC);
|
|||
// return sorted accepts MIMEs
|
|||
return array_keys($accepts_parsed);
|
|||
}
|
|||
/**
|
|||
* Checks whether given accept MIME that may contain * match given full
|
|||
* MIME.
|
|||
*
|
|||
* @param string $accept_mime MIME type that may contain * (e.g. text/*)
|
|||
* @param string $mime full MIME (e.g. application/json)
|
|||
* @return boolean match?
|
|||
*/
|
|||
public static function accept_match($accept_mime, $mime) {
|
|||
// invalid MIME
|
|||
if (!preg_match('/^([*]|[-\w]+)\/([*]|[-+\w]+)$/', $accept_mime) ||
|
|||
!preg_match('/^[-\w]+\/[-+\w]+$/', $mime)) {
|
|||
return FALSE;
|
|||
}
|
|||
// string match
|
|||
if (strpos($accept_mime, '*') === FALSE) {
|
|||
return (strcmp($accept_mime, $mime) == 0);
|
|||
}
|
|||
// build regex
|
|||
$am_regex = '|' . str_replace('*', '([-\w]+)', $accept_mime) . '|';
|
|||
// match?
|
|||
return !!preg_match($am_regex, $mime);
|
|||
}
|
|||
}
|