filter_input

    (PHP 5 >= 5.2.0, PHP 7, PHP 8)

    filter_input — Получает конкретную внешнюю переменную по имени и, если нужно, фильтрует значение переменной

    Описание

    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()

    <?php

    $search_html     = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_SPECIAL_CHARS);
    $search_url = filter_input(INPUT_GET, 'search', FILTER_SANITIZE_ENCODED);
    echo     "Вы искали $search_html.\n";
    echo     "<a href='?search=$search_url'>Искать снова.</a>";

    ?>

    Вывод приведённого примера будет похож на: 

    Вы искали Me &#38; son. <a href='?search=Me%20%26%20son'>Искать снова.</a>

    Смотрите также

    • filter_var() - Фильтрует переменную
    • filter_input_array() - Получает несколько переменных извне PHP и, при необходимости, фильтрует их
    • filter_var_array() - Принимает несколько переменных и, при необходимости, фильтрует их
    • Типы фильтров
    To Top