Php/docs/function.filter-input-array
filter_input_array
(PHP 5 >= 5.2.0, PHP 7)
filter_input_array — 获取一系列外部变量,并且可以通过过滤器处理它们
参数
type
INPUT_GET
,INPUT_POST
,INPUT_COOKIE
,INPUT_SERVER
, orINPUT_ENV
之一。definition
一个定义参数的数组。一个有效的键必须是一个包含变量名的string,一个有效的值要么是一个filter type,或者是一个array 指明了过滤器、标示和选项。如果值是一个数组,那么它的有效的键可以是
filter
, 用于指明 filter type,flags
用于指明任何想要用于过滤器的标示,或者options
用于指明任何想要用于过滤器的选项。 参考下面的例子来更好的理解这段说明。这个参数也可以是一个filter constant的整数。那么数组中的所有变量都会被这个过滤器所过滤。
add_empty
在返回值中添加
null
作为不存在的键。
返回值
如果成功的话返回一个所请求的变量的数组,如果失败的话返回 false
。对于数组的值,如果过滤失败则返回 false
,如果variable_name
不存在的话则返回 null
。
如果标示 FILTER_NULL_ON_FAILURE
被使用了,那么当变量不存在时返回 false
,当过滤失败时返回 null
。
范例
Example #1 一个 filter_input_array() 的例子
<?phperror_reporting(E_ALL | E_STRICT);/* data actually came from POST$_POST = array( 'product_id' => 'libgd<script>', 'component' => '10', 'versions' => '2.0.33', 'testscalar' => array('2', '23', '10', '12'), 'testarray' => '2',);*/$args = array( 'product_id' => FILTER_SANITIZE_ENCODED, 'component' => array('filter' => FILTER_VALIDATE_INT, 'flags' => FILTER_REQUIRE_ARRAY, 'options' => array('min_range' => 1, 'max_range' => 10) ), 'versions' => FILTER_SANITIZE_ENCODED, 'doesnotexist' => FILTER_VALIDATE_INT, 'testscalar' => array( 'filter' => FILTER_VALIDATE_INT, 'flags' => FILTER_REQUIRE_SCALAR, ), 'testarray' => array( 'filter' => FILTER_VALIDATE_INT, 'flags' => FILTER_REQUIRE_ARRAY, ));$myinputs = filter_input_array(INPUT_POST, $args);var_dump($myinputs);echo "\n";?>
以上例程会输出:
array(6) { ["product_id"]=> string(17) "libgd%3Cscript%3E" ["component"]=> array(1) { [0]=> int(10) } ["versions"]=> string(6) "2.0.33" ["doesnotexist"]=> NULL ["testscalar"]=> bool(false) ["testarray"]=> array(1) { [0]=> int(2) } }
更新日志
版本 | 说明 |
---|---|
5.4.0 | 添加 add_empty 参数.
|
注释
Note:
在
INPUT_SERVER
数组中并没有REQUEST_TIME
,因为它是被稍后插入到$_SERVER
中的。