summaryrefslogtreecommitdiffstats
path: root/inc/request.inc.php
blob: cd782d99238482ee808ec362f35e817065441fce (plain) (blame)
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
<?php

declare(strict_types=1);

/**
 * Wrapper for getting fields from the request (GET, POST, ...)
 */
class Request
{

	/**
	 * Required and not empty
	 */
	const REQUIRED = "\0\1\2REQ\0\1\2";

	/**
	 * Required, but might be empty
	 */
	const REQUIRED_EMPTY = "\0\3\4REQ\0\3\4";

	/**
	 *
	 * @param string $key Key of field to get from $_GET
	 * @param string $default Value to return if $_GET does not contain $key
	 * @param string $type if the parameter exists, cast it to given type
	 * @return mixed Field from $_GET, or $default if not set
	 */
	public static function get(string $key, $default = false, $type = false)
	{
		return self::handle($_GET, $key, $default, $type);
	}
	
	/**
	 * 
	 * @param string $key Key of field to get from $_POST
	 * @param string $default Value to return if $_POST does not contain $key
	 * @return mixed Field from $_POST, or $default if not set
	 */
	public static function post(string $key, $default = false, $type = false)
	{
		return self::handle($_POST, $key, $default, $type);
	}
	
	/**
	 * 
	 * @param string $key Key of field to get from $_REQUEST
	 * @param string $default Value to return if $_REQUEST does not contain $key
	 * @return mixed Field from $_REQUEST, or $default if not set
	 */
	public static function any(string $key, $default = false, $type = false)
	{
		return self::handle($_REQUEST, $key, $default, $type);
	}

	/**
	 * @return true iff the request is a POST request
	 */
	public static function isPost(): bool
	{
		return $_SERVER['REQUEST_METHOD'] === 'POST';
	}

	/**
	 * @return true iff the request is a GET request
	 */
	public static function isGet(): bool
	{
		return $_SERVER['REQUEST_METHOD'] === 'GET';
	}

	private static function handle(&$array, $key, $default, $type)
	{
		if (!array_key_exists($key, $array)) {
			if ($default === self::REQUIRED || $default === self::REQUIRED_EMPTY) {
				Message::addError('main.parameter-missing', $key);
				Util::redirect('?do=' . $_REQUEST['do']);
			}
			return $default;
		}
		if ($default === self::REQUIRED && $array[$key] === '') {
			Message::addError('main.parameter-empty', $key);
			Util::redirect('?do=' . $_REQUEST['do']);
		}
		if ($type !== false) settype($array[$key], $type);
		return $array[$key];
	}

}