Php/docs/function.filter-var-array
filter_var_array
(PHP 5 >= 5.2.0, PHP 7)
filter_var_array — 获取多个变量并且过滤它们
参数
data
数组,键为字符串,值为待过滤的数据。
definition
一个定义参数的数组。一个有效的键必须是一个包含变量名的string,一个有效的值要么是一个filter type,或者是一个array 指明了过滤器、标示和选项。如果值是一个数组,那么它的有效的键可以是
filter
, 用于指明 filter type,flags
用于指明任何想要用于过滤器的标示,或者options
用于指明任何想要用于过滤器的选项。 参考下面的例子来更好的理解这段说明。这个参数也可以是一个filter constant的整数。那么数组中的所有值都会被这个过滤器所过滤。
add_empty
在返回值中添加
null
作为不存在的键。
返回值
如果成功则返回一个包含所请求变量的数组,或者当失败时返回 false
。
一个数组的值如果过滤失败则为 false
,或者为 null
如果变量不存在的话。
范例
Example #1 一个 filter_var_array() 的例子
<?phperror_reporting(E_ALL | E_STRICT);$data = 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_FORCE_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_FORCE_ARRAY, ));$myinputs = filter_var_array($data, $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 参数。
|
参见
- filter_input_array() - 获取一系列外部变量,并且可以通过过滤器处理它们
- filter_var() - 使用特定的过滤器过滤一个变量
- filter_input() - 通过名称获取特定的外部变量,并且可以通过过滤器处理它
- Types of filters