Как в PHP получить IP адрес пользователя: от простого к сложному

Расширенные примеры работы с IP в PHP

Ниже приведены более сложные и специализированные примеры, демонстрирующие различные подходы к получению и валидации IP адресов.

Пример 1: Функция с приоритетным выбором заголовков и фильтрацией приватных адресов

<?php
function getPublicIP() {
    $headers = [
        'HTTP_CF_CONNECTING_IP',
        'HTTP_X_FORWARDED_FOR',
        'HTTP_X_REAL_IP',
        'REMOTE_ADDR'
    ];
    $privateRanges = [
        '10.0.0.0/8',
        '172.16.0.0/12',
        '192.168.0.0/16',
        '127.0.0.0/8'
    ];
    foreach ($headers as $h) {
        if (!empty($_SERVER[$h])) {
            $ipList = explode(',', $_SERVER[$h]);
            foreach ($ipList as $ip) {
                $ip = trim($ip);
                if (filter_var($ip, FILTER_VALIDATE_IP)) {
                    // Проверка, что IP не приватный
                    $isPrivate = false;
                    foreach ($privateRanges as $range) {
                        if (ip_in_range($ip, $range)) {
                            $isPrivate = true;
                            break;
                        }
                    }
                    if (!$isPrivate) {
                        return $ip;
                    }
                }
            }
        }
    }
    return '0.0.0.0';
}

function ip_in_range($ip, $range) {
    list($subnet, $bits) = explode('/', $range);
    if ($bits === null) $bits = 32;
    $ipLong = ip2long($ip);
    $subnetLong = ip2long($subnet);
    $mask = -1 << (32 - $bits);
    $subnetLong &= $mask;
    return ($ipLong & $mask) === $subnetLong;
}

echo getPublicIP();
?>

Результат выполнения на сервере с реальным внешним IP:

93.180.12.34

Пояснение: функция проходит по заголовкам, извлекает все IP из цепочек и возвращает первый не приватный адрес. Это особенно полезно, когда за прокси могут скрываться внутренние IP.

Пример 2: Проверка валидности IPv4 и IPv6 с помощью filter_var

<?php
$testIPs = ['192.168.1.1', '::1', '256.0.0.1', '2001:db8::1'];
foreach ($testIPs as $ip) {
    $isValid = filter_var($ip, FILTER_VALIDATE_IP);
    echo "{$ip} - " . ($isValid ? 'валидный' : 'невалидный') . "\n";
}
?>

192.168.1.1 - валидный
::1 - валидный
256.0.0.1 - невалидный
2001:db8::1 - валидный

Пояснение: filter_var с флагом FILTER_VALIDATE_IP корректно распознаёт оба формата и отбрасывает заведомо некорректные адреса.

Пример 3: Извлечение первого IP из строки X-Forwarded-For с регулярным выражением

<?php
$headerValue = '203.0.113.42, 10.0.0.5, 172.16.0.1';
preg_match('/\b(\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3})\b/', $headerValue, $matches);
$firstIP = $matches[1] ?? 'Не удалось извлечь';
echo $firstIP;
?>

203.0.113.42

Пояснение: регулярное выражение ищет первое вхождение IPv4 адреса. Альтернатива - explode и trim, но regex быстрее, если нужен только первый адрес.

Пример 4: Получение IP из окружения при использовании Docker или Kubernetes

<?php
// В некоторых контейнерных средах IP клиента может быть в переменной окружения
$ipFromEnv = getenv('CLIENT_IP') ?: '';
if (filter_var($ipFromEnv, FILTER_VALIDATE_IP)) {
    echo 'IP из окружения: ' . $ipFromEnv;
} else {
    $ip = $_SERVER['REMOTE_ADDR'] ?? '0.0.0.0';
    echo 'IP из REMOTE_ADDR: ' . $ip;
}
?>

Пояснение: некоторые оркестраторы (например, Traefik) передают реальный IP через переменные окружения или дополнительные заголовки. Пример показывает резервный вариант.

Пример 5: Логирование всех заголовков, связанных с IP, для отладки

<?php
$headers = [
    'REMOTE_ADDR',
    'HTTP_X_FORWARDED_FOR',
    'HTTP_X_REAL_IP',
    'HTTP_CF_CONNECTING_IP',
    'HTTP_CLIENT_IP'
];
$logData = [];
foreach ($headers as $h) {
    $logData[$h] = $_SERVER[$h] ?? 'не определён';
}
error_log(json_encode($logData, JSON_UNESCAPED_UNICODE));
echo 'Данные записаны в лог';
?>

Результат (в логе):

{"REMOTE_ADDR":"192.168.1.100","HTTP_X_FORWARDED_FOR":"93.180.12.34","HTTP_X_REAL_IP":"93.180.12.34","HTTP_CF_CONNECTING_IP":"не определён","HTTP_CLIENT_IP":"не определён"}

Пояснение: такой подход помогает диагностировать, какие заголовки доступны в конкретной инфраструктуре, и выбрать правильную стратегию.