filter_input
(PHP 5 >= 5.2.0, PHP 7, PHP 8)
filter_input - Приймає змінну ззовні PHP і, при необхідності, фільтрує її
Опис
filter_input( int $type, string $var_name, int $filter = FILTER_DEFAULT, array|int $options = 0): mixed
Список параметрів
type
Одна из констант**INPUT_GET** INPUT_POST INPUT_COOKIE INPUT_SERVER або INPUT_ENV
var_name
Ім'я змінної, що отримується.
filter
Ідентифікатор (ID) фільтра. На сторінці Типи фільтрів наведено список доступних фільтрів.
Если не указан, то принимает значение по умолчанию —**FILTER_DEFAULT**, який рівнозначний значенню константи FILTER_UNSAFE_RAWТо есть по умолчанию значение не фильтруется.
options
Асоціативний масив параметрів чи логічне АБО прапорів. Якщо фільтр приймає настройки, прапори можуть бути вказані в елементі масиву "flags".
Значення, що повертаються
Значення запитуваної змінної у разі успішного виконання, false, якщо фільтрація завершилася невдачею, або null, если переменнаяvar_nameне определена. Если установлен флаг**FILTER_NULL_ON_FAILURE**, функція повертає false, якщо змінна не визначена та **null**якщо фільтрація завершилася невдачею.
Приклади
Приклад #1 Приклад використання filter_input()****
Висновок наведеного прикладу буде схожим на:
Вы искали Me & son.
<a href='?search=Me%20%26%20son'>Искать снова.</a>
Дивіться також
- filter_var() - Фільтрує змінну за допомогою певного фільтра
- filter_input_array() - Отримує кілька змінних ззовні PHP і, при необхідності, фільтрує їх
- filter_var_array() - приймає кілька змінних і, при необхідності, фільтрує їх
- Типи фільтрів