filter_input_array

(PHP 5 >= 5.2.0, PHP 7)

filter_input_array - 获取外部变量并可选择对其进行过滤

描述

mixed filter_input_array ( int $type [, mixed $definition [, bool $add_empty = true ]] )

这个函数在不重复调用filter_input（）的情况下检索多个值很有用。

参数

type

One of INPUT_GET, INPUT_POST, INPUT_COOKIE, INPUT_SERVER, or INPUT_ENV.

definition

一个定义参数的数组。有效的键是一个包含变量名的字符串，而有效值可以是过滤器类型，也可以是可选择指定过滤器，标志和选项的数组。如果该值是数组，有效密钥是过滤器用于指定过滤器类型，标记它指定了适用于过滤器的任何标志，和选择其指定了适用于过滤器的任何选项。请参阅下面的示例以获得更好的理解。

该参数也可以是一个保存过滤器常量的整数。然后输入数组中的所有值都由此过滤器过滤。

add_empty

NULL针对返回值添加缺少的键。

返回值

一个数组，包含成功或FALSE失败时请求的变量的值。FALSE如果过滤器失败，或者NULL未设置变量，那么数组值将会是。或者如果使用该标志FILTER_NULL_ON_FAILURE，FALSE如果该变量未被设置并且NULL该过滤器失败，则返回该标志。

例子

Example #1 A filter_input_array() example

<?php
error_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参数。

注释

注意：数组中没有REQUEST_TIME键，INPUT_SERVER因为它稍后会插入到$ _SERVER中。

← filter_id

filter_input →

本文档系腾讯云开发者社区成员共同维护，如有问题请联系 cloudcommunity@tencent.com

最后更新于：2017-12-18