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
|
<?php
/**
* Static class providing functions used by both the CORE of Piwik and the
* visitor logging engine.
* This is the only external class loaded by the Piwik.php file.
*/
class Piwik_Common
{
/**
* Returns the variable after cleaning operations.
* If an array is passed the cleaning is done recursively on all the sub-arrays.
*
* How this method works:
* - The variable returned has been htmlspecialchars to avoid the XSS security problem.
* - The single quotes are not protected so "Piwik's amazing" will still be "Piwik's amazing".
* - Transformations are:
* - '&' (ampersand) becomes '&'
* - '"'(double quote) becomes '"'
* - '<' (less than) becomes '<'
* - '>' (greater than) becomes '>'
* - It handles the magic_quotes setting.
*
* @param mixed The variable to be cleaned
* @return mixed The variable after cleaning
*/
static public function sanitizeInputValues($value)
{
if (is_array($value))
{
foreach ($value as &$currentValue)
{
$currentValue = Piwik_Common::sanitizeInputValues($currentValue);
}
}
else
{
$value = htmlspecialchars($value, ENT_COMPAT, 'UTF-8');
/* Undo the damage caused by magic_quotes */
if (get_magic_quotes_gpc())
{
$value = stripslashes($value);
}
}
return $value;
}
/**
* Returns a variable from the $_REQUEST superglobal.
* If the variable doesn't have a value, returns the defaultValue if specified.
* If the variable doesn't have neither a value nor a default value provided, then we trigger \
* an error.
*
* @param string $varName name of the variable
* @param string $varDefault default value. If '', and if the type doesn't match, exit() !
* @param string $varType Expected type, the value must be one of the following: array, numeric, int, integer, float, string
*
* @exception if the variable type is not known
* @exception if the variable we want to read doesn't have neither a value nor a default value specified
*
* @return mixed The variable after cleaning
*/
static public function getRequestVar($varName, $varDefault = null, $varType = 'string')
{
$varDefault = self::sanitizeInputValue( $varDefault );
// there is no value $varName in the REQUEST so we try to use the default value
if(!isset($_REQUEST[$varName])
|| empty($_REQUEST[$varName]))
{
if($varDefault === null)
{
throw new Exception("\$varName '$varName' doesn't have value in \$_REQUEST and doesn't have a" .
" \$varDefault value");
}
else
{
settype($varDefault, $varType);
return $varDefault;
}
}
// Normal case, there is a value available in REQUEST for the requested varName
$value = self::sanitizeInputValues( $_REQUEST[$varName] );
$ok = false;
if($varType == 'string')
{
if(is_string($value)) $ok = true;
}
elseif($varType == 'numeric'
|| $varType == 'int'
|| $varType == 'integer'
|| $varType == 'float')
{
if(is_numeric($value)) $ok = true;
}
elseif($varType == 'array')
{
if(is_array($value)) $ok = true;
}
else
{
throw new Exception("\$varType specified is not known. It should be one of the following: array, numeric, int, integer, float, string");
}
// The type is not correct
if($ok === false)
{
if($varDefault === null)
{
throw new Exception("\$varName '$varName' doesn't have a correct type in \$_REQUEST and doesn't " .
"have a \$varDefault value");
}
// we return the default value with the good type set
else
{
settype($varDefault, $varType);
return $varDefault;
}
}
return $value;
}
}
?>
|