Работа с IP адресами в PHP: функции, фильтрация и практические примеры

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

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

// Пример 1: Универсальная функция проверки CIDR (IPv4 и IPv6)
function ipInCidrV6(string $ip, string $cidr): bool
{
    if (strpos($cidr, '/') === false) {
        return $ip === $cidr;
    }
    list($subnet, $mask) = explode('/', $cidr);
    $ipBin = inet_pton($ip);
    $subnetBin = inet_pton($subnet);
    if ($ipBin === false || $subnetBin === false) {
        return false;
    }
    $mask = (int)$mask;
    // Для IPv4 маска от 0 до 32, для IPv6 от 0 до 128
    $fullBytes = intdiv($mask, 8);
    $partialBits = $mask % 8;
    $compareBytes = $fullBytes + ($partialBits > 0 ? 1 : 0);
    
    for ($i = 0; $i < $compareBytes && $i < strlen($ipBin); $i++) {
        $ipByte = ord($ipBin[$i]);
        $subnetByte = ord($subnetBin[$i]);
        if ($i < $fullBytes) {
            if ($ipByte !== $subnetByte) {
                return false;
            }
        } else {
            // последний неполный байт, маскируем старшие биты
            $maskByte = 0xFF << (8 - $partialBits) & 0xFF;
            if (($ipByte & $maskByte) !== ($subnetByte & $maskByte)) {
                return false;
            }
        }
    }
    return true;
}

// Тест IPv6
echo ipInCidrV6('2a02:aa0:1::1', '2a02:aa0::/32') ? 'да' : 'нет'; // да

да

// Пример 2: Получение всех IP адресов из диапазона (только IPv4)
function rangeToIps(string $start, string $end): array
{
    $startLong = ip2long($start);
    $endLong = ip2long($end);
    $ips = [];
    for ($long = $startLong; $long <= $endLong; $long++) {
        $ips[] = long2ip($long);
    }
    return $ips;
}

print_r(rangeToIps('192.168.1.1', '192.168.1.3'));

Array
(
    [0] => 192.168.1.1
    [1] => 192.168.1.2
    [2] => 192.168.1.3
)

// Пример 3: Распознавание прокси-цепочки с доверенными серверами
$proxyChain = '203.0.113.5, 198.51.100.7, 192.168.1.1';
$trusted = ['192.168.0.0/16', '10.0.0.0/8'];

function extractClientIp(string $chain, string $remoteAddr, array $trusted): string
{
    $ips = array_map('trim', explode(',', $chain));
    $ips[] = $remoteAddr; // последний прокси - сам сервер
    $clientIp = null;
    foreach ($ips as $ip) {
        if (!filter_var($ip, FILTER_VALIDATE_IP)) {
            break;
        }
        if ($clientIp === null) {
            $clientIp = $ip;
        }
        // Если IP не доверенный, значит это клиент?
        // На самом деле: все IP до первого недоверенного - клиент
        // Здесь упрощение: ищем первый недоверенный
        if (!isTrusted($ip, $trusted)) {
            $clientIp = $ip;
            break;
        }
    }
    return $clientIp ?? $remoteAddr;
}

function isTrusted(string $ip, array $trusted): bool
{
    foreach ($trusted as $cidr) {
        if (ipInCidrV6($ip, $cidr)) { // предполагаем, что ipInCidrV6 работает для обоих версий
            return true;
        }
    }
    return false;
}

echo extractClientIp($proxyChain, '10.0.0.99', $trusted); // 198.51.100.7 (первый внешний)

198.51.100.7

// Пример 4: Преобразование IPv6 в десятичное число (используя GMP)
function ipv6ToDecimal(string $ip): string
{
    $bin = inet_pton($ip);
    if ($bin === false) return '';
    $hex = bin2hex($bin);
    return gmp_strval(gmp_init($hex, 16), 10);
}

echo ipv6ToDecimal('::1'); // 1
echo ipv6ToDecimal('2a02:aa0:1::1'); 

1
34642286731310395309171746644232101889

// Пример 5: Проверка, является ли IP частным (RFC 1918 + уникальные локальные IPv6)
function isPrivateIp(string $ip): bool
{
    $privateRanges = [
        '10.0.0.0/8',
        '172.16.0.0/12',
        '192.168.0.0/16',
        '127.0.0.0/8',
        '169.254.0.0/16',
        'fc00::/7',   // unique local
        'fe80::/10',  // link-local
        '::1/128'     // loopback
    ];
    foreach ($privateRanges as $cidr) {
        if (ipInCidrV6($ip, $cidr)) { // опять используем универсальную функцию
            return true;
        }
    }
    return false;
}

var_dump(isPrivateIp('192.168.1.1')); // true
var_dump(isPrivateIp('8.8.8.8'));    // false

bool(true)
bool(false)

При работе с большими объёмами данных (логи, геолокация) рекомендуется использовать расширения maxmind/geoip2 или встроенные функции для работы с бинарными форматами.