PHP Conference Japan 2024

filter_var_array

(PHP 5 >= 5.2.0, PHP 7, PHP 8)

filter_var_array获取多个变量并可选地对其进行过滤

描述

filter_var_array(数组 $array, 数组|整数 $options = FILTER_DEFAULT, 布尔值 $add_empty = true): 数组|false|null

使用FILTER_VALIDATE_*验证过滤器、FILTER_SANITIZE_* 过滤过滤器或自定义过滤器来过滤关联数组的值。

参数

array
包含要过滤数据的关联数组
options
要么是一个关联数组的选项,要么是应用于每个条目的过滤器,它可以使用FILTER_VALIDATE_*常量之一作为验证过滤器,或者使用FILTER_SANITIZE_*常量之一作为清理过滤器。 选项数组是一个关联数组,其中键对应于数据array中的键,关联值要么是应用于此条目的过滤器,要么是描述如何以及应该将哪个过滤器应用于此条目的关联数组。 描述如何应用过滤器的关联数组必须包含'filter'键,其关联值是要应用的过滤器,可以是FILTER_VALIDATE_*FILTER_SANITIZE_*FILTER_UNSAFE_RAWFILTER_CALLBACK常量之一。它可以可选地包含指定应用于过滤器的标志的'flags'键,以及指定应用于过滤器的任何选项的'options'键。
add_empty

将缺失的键作为null添加到返回值中。

返回值

成功时返回一个包含请求变量值的数组,失败时返回false。如果过滤器失败,数组值将为false;如果变量未设置,则为null

示例

示例 #1 一个filter_var_array()示例

<?php

$data
= [
'product_id' => 'libgd<script>',
'component' => '10',
'versions' => '2.0.33',
'testscalar' => ['2', '23', '10', '12'],
'testarray' => '2',
];

$filters = [
'product_id' => FILTER_SANITIZE_ENCODED,
'component' => [
'filter' => FILTER_VALIDATE_INT,
'flags' => FILTER_FORCE_ARRAY,
'options' => [
'min_range' => 1,
'max_range' => 10,
],
],
'versions' => [
'filter' => FILTER_SANITIZE_ENCODED
],
'testscalar' => [
'filter' => FILTER_VALIDATE_INT,
'flags' => FILTER_REQUIRE_SCALAR,
],
'testarray' => [
'filter' => FILTER_VALIDATE_INT,
'flags' => FILTER_FORCE_ARRAY,
],
'doesnotexist' => FILTER_VALIDATE_INT,
];

var_dump(filter_var_array($data, $filters));

?>

以上示例将输出

array(6) {
  ["product_id"]=>
  string(17) "libgd%3Cscript%3E"
  ["component"]=>
  array(1) {
    [0]=>
    int(10)
  }
  ["versions"]=>
  string(6) "2.0.33"
  ["testscalar"]=>
  bool(false)
  ["testarray"]=>
  array(1) {
    [0]=>
    int(2)
  }
  ["doesnotexist"]=>
  NULL
}

参见

添加注释

用户贡献的注释 3 条注释

4
匿名
1 年前
要将相同的过滤器应用于多个参数/键,请使用 array_fill_keys()。

<?php
$data
= array(
'product_id' => 'libgd<script>',
'component' => ' 10 ',
'versions' => '2.0.33',
'testscalar' => array('2', '23', '10', '12'),
'testarray' => '2',
);
$keys = array(
'product_id',
'component',
'versions',
'doesnotexist',
'testscalar',
'testarray'
);
$options = array(
'filter' => FILTER_CALLBACK,
'options' => function ($value) {
return
trim(strip_tags($value));
},
);
$args = array_fill_keys($keys, $options);
/* 结果
$args = array(
'product_id' => array(
'filter' => FILTER_CALLBACK,
'options' => function ($value) {
return trim(strip_tags($value));
},
),
'component' => array(
'filter' => FILTER_CALLBACK,
'options' => function ($value) {
return trim(strip_tags($value));
},
),
'versions' => array(
'filter' => FILTER_CALLBACK,
'options' => function ($value) {
return trim(strip_tags($value));
},
),
'doesnotexist' => array(
'filter' => FILTER_CALLBACK,
'options' => function ($value) {
return trim(strip_tags($value));
},
),
'testscalar' => array(
'filter' => FILTER_CALLBACK,
'options' => function ($value) {
return trim(strip_tags($value));
},
),
'testarray' => array(
'filter' => FILTER_CALLBACK,
'options' => function ($value) {
return trim(strip_tags($value));
},
),
);
*/

$myinputs = filter_var_array($data, $args);
var_dump($myinputs);

输出:

array(
6) {
'product_id' =>
string(5) "libgd"
'component'
=>
string(2) "10"
'versions'
=>
string(6) "2.0.33"
'doesnotexist'
=>
NULL
'testscalar' =>
array(
4) {
[
0] =>
string(1) "2"
[1] =>
string(2) "23"
[2] =>
string(2) "10"
[3] =>
string(2) "12"
}
'testarray' =>
string(1) "2"
}
8
eguvenc at gmail dot com
15年前
<?php
//一个简单的数组清理示例

$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);

//输出:
//array(3) { [0]=> string(4) "bold" [1]=> string(10) "javascript" [2]=> string(26) "P*}i@893746%%%p*.i.*}}|.dw" }
?>
-1
Vee W.
5年前
$emails = [
'a' => '[email protected]',
'b' => '<email2>@domain.com',
];

$result = filter_var_array($emails, FILTER_SANITIZE_EMAIL);
print_r($result);

// 结果将是…
// array('a' => '[email protected]', 'b' => '[email protected]')
To Top