filter_input_array()

❮ PHP Filter 参考手册

实例

使用 filter_input_array() 函数过滤三个 POST 变量。 接收到的 POST 变量是姓名、年龄和电子邮件:

<?php
$filters = array (
  "name" => array ("filter"=>FILTER_CALLBACK,
                             "flags"=>FILTER_FORCE_ARRAY,
                             "options"=>"ucwords"
                            ),
  "age"   => array ( "filter"=>FILTER_VALIDATE_INT,
                              "options"=>array("min_range"=>1,"max_range"=>120)
                            ),
  "email" => FILTER_VALIDATE_EMAIL
  );
print_r(filter_input_array(INPUT_POST, $filters));
?>

上述代码的输出为:

Array
  (
  [name] => Peter
  [age] => 41
  [email] => peter@example.com
  )

---

定义和用法

filter_input_array() 函数从脚本外部获取多项输入，并进行过滤。

本函数无需重复调用 filter_input()，对过滤多个输入变量很有用。

如果成功，则返回被过滤的数据，如果失败，则返回 false。

---

语法

filter_input_array(type, definition, add_empty)

参数值

参数	描述
type	必需。要检查的输入类型。 可以是以下之一: INPUT_GET INPUT_POST INPUT_COOKIE INPUT_SERVER INPUT_ENV
definition	可选。指定过滤器参数的数组。 有效的数组键是变量名，有效值是过滤器名称或 ID，或指定过滤器、标志和选项的数组。 该参数也可以是单个过滤器名称/ID； 然后输入数组中的所有值都被指定的过滤器过滤
add_empty	可选。一个布尔值。 TRUE 将缺少的键作为 NULL 添加到返回值。 默认值为 TRUE

---

提示和注释

提示:参见完整的 PHP Filter 参考手册，查看可与该函数一同使用的过滤器。

---

技术细节

返回值:	一个数组，其中变量的值表示成功，FALSE 表示失败
PHP 版本:	5.2+
PHP 更新日志:	PHP 5.4 - 添加了 add_empty 参数

---

❮ 完整的 PHP 过滤器参考