filter_var_array()
(PHP 5 >= 5.2.0, PHP 7)
获取多个变量并且过滤它们
说明
filter_var_array(array $data[,mixed $definition[,bool $add_empty= true]]): mixed
不需要重复调用filter_var()就能获取多个变量。
参数
- $data
数组,键为字符串,值为待过滤的数据。
- $definition
一个定义参数的数组。一个有效的键必须是一个包含变量名的string,一个有效的值要么是一个filter type,或者是一个array指明了过滤器、标示和选项。如果值是一个数组,那么它的有效的键可以是filter,用于指明filter type,flags用于指明任何想要用于过滤器的标示,或者options用于指明任何想要用于过滤器的选项。参考下面的例子来更好的理解这段说明。
这个参数也可以是一个filter constant的整数。那么数组中的所有值都会被这个过滤器所过滤。
- $add_empty
在返回值中添加
NULL
作为不存在的键。
返回值
如果成功则返回一个包含所请求变量的数组,或者当失败时返回FALSE
。一个数组的值如果过滤失败则为FALSE
,或者为NULL
如果变量不存在的话。
范例
一个filter_var_array()的例子
<?php error_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
<?php //an example of simply sanitize an array.. $data = array( '<b>bold</b>', '<script>javascript</script>', 'P*}i@893746%%%p*.i.*}}|.dw<?php echo "echo works!!";?>'); $myinputs = filter_var_array($data,FILTER_SANITIZE_STRING); var_dump($myinputs); //OUTPUT: //formarray(3) { [0]=> string(4) "bold" [1]=> string(10) "javascript" [2]=> string(26) "P*}i@893746%%%p*.i.*}}|.dw" } ?>
$emails = [ 'a' => 'email1@domain.com', 'b' => '<email2>@domain.com', ]; $result = filter_var_array($emails, FILTER_SANITIZE_EMAIL); print_r($result); // the result will be... // array('a' => 'email1@domain.com', 'b' => 'email2@domain.com')
for those who would like to know how to use regular expressions with filter var array. taken from w3 schools. $data = array( 'regxp' => 'michael' ); $args = array( 'regxp' => array( 'filter'=>FILTER_VALIDATE_REGEXP | FILTER_SANITIZE_STRING, 'options'=>array('regexp'=>"/^michael$/"), )); $output=filter_var_array($data,$args); var_dump($output); // array(1) { ["regxp"]=> string(7) "michael" } - bruce tong
an update to previous post. using regular expressions along with another filter in filter var array $data = array( 'regxp' => "`\tcafé\n`" ); $args = array( 'regxp' => array( 'filter'=>FILTER_VALIDATE_REGEXP | FILTER_SANITIZE_STRING, 'flags'=>FILTER_FLAG_STRIP_HIGH | FILTER_FLAG_STRIP_LOW | FILTER_FLAG_STRIP_BACKTICK, 'options'=>array('regexp'=>"/t(.*)/"), )); $output=filter_var_array($data,$args); var_dump($output); // array(1) { ["regxp"]=> string(3) "caf" } -bruce tong