Фильтрация переменных в PHP с помощью filter_var: полное руководство

Расширенные примеры использования filter_var

1. Проверка доменного имени (FILTER_VALIDATE_DOMAIN)

Фильтр появился в PHP 7.0. Проверяет, является ли строка валидным доменом.

<?php
$domains = ['example.com', 'sub.domain.org', 'not_a_domain', '127.0.0.1'];
foreach ($domains as $d) {
    if (filter_var($d, FILTER_VALIDATE_DOMAIN)) {
        echo "$d - валидный домен\n";
    } else {
        echo "$d - не валидный домен\n";
    }
}
?>

example.com - валидный домен
sub.domain.org - валидный домен
not_a_domain - не валидный домен
127.0.0.1 - не валидный домен

Фильтр не проверяет существование домена в DNS, только синтаксис.

2. Фильтрация IP-адреса с проверкой диапазона (FILTER_VALIDATE_IP + флаги)

<?php
$ip = '192.168.1.1';
$flags = FILTER_FLAG_IPV4 | FILTER_FLAG_NO_PRIV_RANGE; // исключает частные диапазоны
if (filter_var($ip, FILTER_VALIDATE_IP, $flags)) {
    echo 'IP корректен и не является частным';
} else {
    echo 'IP некорректен или является частным';
}
?>

IP некорректен или является частным

Флаг FILTER_FLAG_NO_PRIV_RANGE отбрасывает адреса из диапазонов 10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16.

3. Санитизация чисел с плавающей точкой (FILTER_SANITIZE_NUMBER_FLOAT)

<?php
$price = '$ 1,234.56';
$clean = filter_var($price, FILTER_SANITIZE_NUMBER_FLOAT, ['flags' => FILTER_FLAG_ALLOW_FRACTION | FILTER_FLAG_ALLOW_THOUSAND]);
echo $clean;
?>

1234.56

Фильтр удаляет всё, кроме цифр, точки (флаг FRACTION) и запятой (флаг THOUSAND). Результат – строка, которую можно преобразовать в float.

4. Использование FILTER_CALLBACK для сложной логики проверки

<?php
function valid_username($value) {
    // Пользовательская проверка: только буквы, цифры и подчеркивания, длина 3-20
    return preg_match('/^[a-zA-Z0-9_]{3,20}$/', $value) ? $value : false;
}

$username = 'test_user123';
$result = filter_var($username, FILTER_CALLBACK, ['options' => 'valid_username']);
var_dump($result);
?>

string(14) "test_user123"

Если бы имя содержало пробел или было слишком коротким, вернулся бы false.

5. Пакетная фильтрация входных данных из $_POST с filter_input_array

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

<?php
// Предположим, $_POST = ['email' => 'test@test', 'age' => 'abc']
$filters = [
    'email' => FILTER_VALIDATE_EMAIL,
    'age' => ['filter' => FILTER_VALIDATE_INT, 'options' => ['min_range' => 1]]
];
$result = filter_input_array(INPUT_POST, $filters);
print_r($result);
?>

Array
(
    [email] => false
    [age] => false
)

email не прошел валидацию, т.к. не содержит точки после @. age false, т.к. 'abc' не число.

6. Комбинированная санитизация и валидация для одного поля

Иногда нужно сначала очистить, потом проверить. Делается последовательно.

<?php
$input = ' user@example.com  ';
$sanitized = filter_var($input, FILTER_SANITIZE_EMAIL); // удаляет пробелы и недопустимые символы
echo "После санитизации: '$sanitized'\n";
if (filter_var($sanitized, FILTER_VALIDATE_EMAIL)) {
    echo 'Валидация пройдена';
} else {
    echo 'Валидация не пройдена';
}
?>

После санитизации: 'user@example.com'
Валидация пройдена

FILTER_SANITIZE_EMAIL удаляет все символы, недопустимые в email-адресе (пробелы, управляющие символы, некоторые спецсимволы).

7. Работа с кодировкой и фильтр FILTER_FLAG_STRIP_HIGH

Для удаления многобайтовых символов (не ASCII) из строки.

<?php
$text = "Привет, мир! Hello, world!";
$ascii = filter_var($text, FILTER_SANITIZE_STRING, FILTER_FLAG_STRIP_HIGH); // устарел, но для примера
echo $ascii;
?>

, ! Hello, world!

Все кириллические символы удалены. В современных версиях PHP лучше использовать iconv или mb_convert_encoding.

8. Использование filter_var с некорректными данными и обработка ошибок

<?php
$email = 'not.an.email';
$result = filter_var($email, FILTER_VALIDATE_EMAIL);
if ($result === false) {
    // Дополнительно можно получить предупреждение через error_get_last
    $error = error_get_last();
    echo "Ошибка валидации: " . ($error['message'] ?? 'unknown');
} else {
    echo "Email корректен: $result";
}
?>

Ошибка валидации: filter_var(): Email validation failed

Предупреждение генерируется только при включенном выводе ошибок. В production лучше подавлять и проверять возвращаемое значение.

9. Фильтр FILTER_VALIDATE_BOOLEAN для проверки логических значений

<?php
$vals = ['true', 'false', '1', '0', 'yes', 'on', 'off', 'maybe'];
foreach ($vals as $v) {
    $res = filter_var($v, FILTER_VALIDATE_BOOLEAN, ['flags' => FILTER_NULL_ON_FAILURE]);
    echo "$v => ";
    var_dump($res);
}
?>

true => bool(true)
false => bool(false)
1 => bool(true)
0 => bool(false)
yes => bool(true)
on => bool(true)
off => bool(false)
maybe => NULL

Флаг FILTER_NULL_ON_FAILURE заставляет возвращать null вместо false, если значение не может быть интерпретировано как булево.

10. Фильтрация макроса URL с проверкой наличия query-параметров

Комбинируем filter_var с разбором URL.

<?php
$url = 'https://example.com/page?name=John&age=30';
$valid = filter_var($url, FILTER_VALIDATE_URL);
if ($valid) {
    $parts = parse_url($valid);
    if (isset($parts['query'])) {
        parse_str($parts['query'], $params);
        echo 'Параметры: ' . implode(', ', array_keys($params));
    } else {
        echo 'Нет параметров';
    }
}
?>

Параметры: name, age