PHP filter_input_array()Функция


PHP Filter 参考手册Полное справочное руководство по фильтрам PHP

Определение и использование

Функция filter_input_array() получает несколько входных данных извне скрипта (например, ввод формы) и фильтрует их.

Эта функция полезна для фильтрации нескольких входных переменных без многократного вызова filter_input().

Эта функция может получать входные данные из различных источников:

  • INPUT_GET
  • INPUT_POST
  • INPUT_COOKIE
  • INPUT_ENV
  • INPUT_SERVER
  • INPUT_SESSION (еще не реализовано)
  • INPUT_REQUEST (ещё не реализовано)

При успешном выполнении возвращает отфильтрованные данные в виде массива. При неудаче возвращает FALSE.

Синтаксис

filter_input_array(input_type, filter_args)

Параметр Описание
input_type Обязательный. Указывает тип ввода. Возможные типы см. в списке выше.
filter_args Необязательный. Указывает массив параметров фильтра. Допустимые имена ключей массива — это имена переменных, допустимые значения — это ID фильтров или массив, задающий фильтры, флаги и параметры.

Этот параметр также может быть одним ID фильтра. В этом случае все значения во входном массиве фильтруются указанным фильтром.

ID фильтров могут быть именами ID (например, FILTER_VALIDATE_EMAIL) или номерами ID (например, 274).



Советы и примечания

Совет:См.Полное справочное руководство по фильтрам PHP, чтобы просмотреть фильтры, которые можно использовать с этой функцией.


Примеры

В этом примере мы используем функцию filter_input_array() для фильтрации трёх переменных POST. Полученные переменные POST — это name, age и адрес e-mail:

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

Вывод кода показан ниже:

Массив
(
[name] => Peter
[age] => 41
[email] => [email protected]
)


PHP Filter 参考手册Полное справочное руководство по фильтрам PHP Другие расширения