94 lines
3.6 KiB
PHP
94 lines
3.6 KiB
PHP
<?php
|
|
|
|
namespace Safe;
|
|
|
|
use Safe\Exceptions\FilterException;
|
|
|
|
/**
|
|
* This function is useful for retrieving many values without
|
|
* repetitively calling filter_input.
|
|
*
|
|
* @param int $type One of INPUT_GET, INPUT_POST,
|
|
* INPUT_COOKIE, INPUT_SERVER, or
|
|
* INPUT_ENV.
|
|
* @param int|array $definition An array defining the arguments. A valid key is a string
|
|
* containing a variable name and a valid value is either a filter type, or an array
|
|
* optionally specifying the filter, flags and options. If the value is an
|
|
* array, valid keys are filter which specifies the
|
|
* filter type,
|
|
* flags which specifies any flags that apply to the
|
|
* filter, and options which specifies any options that
|
|
* apply to the filter. See the example below for a better understanding.
|
|
*
|
|
* This parameter can be also an integer holding a filter constant. Then all values in the
|
|
* input array are filtered by this filter.
|
|
* @param bool $add_empty Add missing keys as NULL to the return value.
|
|
* @return mixed An array containing the values of the requested variables on success.
|
|
* If the input array designated by type is not populated,
|
|
* the function returns NULL if the FILTER_NULL_ON_FAILURE
|
|
* flag is not given, or FALSE otherwise. For other failures, FALSE is returned.
|
|
*
|
|
* An array value will be FALSE if the filter fails, or NULL if
|
|
* the variable is not set. Or if the flag FILTER_NULL_ON_FAILURE
|
|
* is used, it returns FALSE if the variable is not set and NULL if the filter
|
|
* fails. If the add_empty parameter is FALSE, no array
|
|
* element will be added for unset variables.
|
|
* @throws FilterException
|
|
*
|
|
*/
|
|
function filter_input_array(int $type, $definition = null, bool $add_empty = true)
|
|
{
|
|
error_clear_last();
|
|
if ($add_empty !== true) {
|
|
$result = \filter_input_array($type, $definition, $add_empty);
|
|
} elseif ($definition !== null) {
|
|
$result = \filter_input_array($type, $definition);
|
|
} else {
|
|
$result = \filter_input_array($type);
|
|
}
|
|
if ($result === false) {
|
|
throw FilterException::createFromPhpError();
|
|
}
|
|
return $result;
|
|
}
|
|
|
|
|
|
/**
|
|
* This function is useful for retrieving many values without
|
|
* repetitively calling filter_var.
|
|
*
|
|
* @param array $data An array with string keys containing the data to filter.
|
|
* @param mixed $definition An array defining the arguments. A valid key is a string
|
|
* containing a variable name and a valid value is either a
|
|
* filter type, or an
|
|
* array optionally specifying the filter, flags and options.
|
|
* If the value is an array, valid keys are filter
|
|
* which specifies the filter type,
|
|
* flags which specifies any flags that apply to the
|
|
* filter, and options which specifies any options that
|
|
* apply to the filter. See the example below for a better understanding.
|
|
*
|
|
* This parameter can be also an integer holding a filter constant. Then all values in the
|
|
* input array are filtered by this filter.
|
|
* @param bool $add_empty Add missing keys as NULL to the return value.
|
|
* @return mixed An array containing the values of the requested variables on success. An array value will be FALSE if the filter fails, or NULL if
|
|
* the variable is not set.
|
|
* @throws FilterException
|
|
*
|
|
*/
|
|
function filter_var_array(array $data, $definition = null, bool $add_empty = true)
|
|
{
|
|
error_clear_last();
|
|
if ($add_empty !== true) {
|
|
$result = \filter_var_array($data, $definition, $add_empty);
|
|
} elseif ($definition !== null) {
|
|
$result = \filter_var_array($data, $definition);
|
|
} else {
|
|
$result = \filter_var_array($data);
|
|
}
|
|
if ($result === false) {
|
|
throw FilterException::createFromPhpError();
|
|
}
|
|
return $result;
|
|
}
|