filter_input_array
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input_array - Отримує кілька змінних ззовні PHP і, при необхідності, фільтрує їх
Опис
filter_input_array(int $type, array|int $options = FILTER_DEFAULT, bool $add_empty = true): array|false|null
Ця функція корисна для отримання множини змінних без багаторазового виклику функції filter_input()
Список параметрів
type
Одна из констант**INPUT_GET
** INPUT_POST
INPUT_COOKIE
INPUT_SERVER
або INPUT_ENV
options
Масив, визначальний аргументи. Допустимий ключ - рядок (string), що містить ім'я змінної, а допустиме значення - або тип фільтра, або масив (array), при необхідності визначальний фільтр, прапори та параметри. Якщо значення є масивом, допустимими ключами є filter
, Який визначає (тип фільтра flags
, який визначає будь-які прапори, що застосовуються до фільтра та options
який визначає будь-які параметри, що застосовуються до фільтра. Дивіться нижче приклад для кращого розуміння.
Цей параметр також може бути цілим числом, що містить зумовлену фільтрову константу. Потім усі значення у вхідному масиві фільтруються цим фільтром.
add_empty
Добавляет в результат отсутствующие ключи со значением**null
**
Значення, що повертаються
Масив, що містить значення змінених у разі успішного виконання. Якщо вхідний масив визначається параметром type
, не заповнений, то функція поверне null
, якщо прапор FILTER_NULL_ON_FAILURE
не задан,false
в іншому випадку. Для інших невдалих виконань повертається false
Значення масиву буде false
, якщо фільтрація завершилася невдачею, або null
, если переменная не определена. Либо, если установлен флаг**FILTER_NULL_ON_FAILURE
**, повертається false
, якщо змінна не визначена та null
якщо фільтрація завершилася невдачею. Якщо параметр add_empty
равенfalse
, елемент масиву не буде додано для віддалених змінних.
Приклади
Приклад #1 Приклад використання filter_input_array()****
Loading...
Результат виконання наведеного прикладу:
array(6) {
["product_id"]=>
string(17) "libgd%3Cscript%3E"
["component"]=>
array(1) {
[0]=>
int(10)
}
["version"]=>
string(6) "2.0.33"
["doesnotexist"]=>
NULL
["testscalar"]=>
int(2)
["testarray"]=>
array(4) {
[0]=>
int(2)
[1]=>
int(23)
[2]=>
int(10)
[3]=>
int(12)
}
}
Примітки
Зауваження :
У масиві
INPUT_SERVER
немає ключаREQUEST_TIME
, тому що він буде пізніше в $_SERVER
Дивіться також
- filter_input() - приймає змінну ззовні PHP і, при необхідності, фільтрує її
- filter_var_array() - приймає кілька змінних і, при необхідності, фільтрує їх
- Типи фільтрів