Final Class Yiisoft\NetworkUtilities\IpHelper

                public static function expandIPv6(string $ip): string
{
    $ipRaw = @inet_pton($ip);
    if ($ipRaw === false) {
        if (@inet_pton('::1') === false) {
            throw new RuntimeException('IPv6 is not supported by inet_pton()!');
        }
        throw new InvalidArgumentException("Unrecognized address $ip.");
    }
    /** @psalm-var array{hex:string} $hex */
    $hex = unpack('H*hex', $ipRaw);
    /**
     * @psalm-suppress PossiblyNullArgument We use correct regular expression, so `preg_replace()` will always
     * return a string.
     */
    return substr(preg_replace('/([a-f0-9]{4})/i', '$1:', $hex['hex']), 0, -1);
}

            

                public static function getCidrBits(string $ip): int
{
    if (preg_match('/^(?<ip>.{2,}?)(?:\/(?<bits>-?\d+))?$/', $ip, $matches) === 0) {
        throw new InvalidArgumentException("Unrecognized address $ip.", 1);
    }
    $ipVersion = self::getIpVersion($matches['ip']);
    $maxBits = $ipVersion === self::IPV6 ? self::IPV6_ADDRESS_LENGTH : self::IPV4_ADDRESS_LENGTH;
    $bits = $matches['bits'] ?? null;
    if ($bits === null) {
        return $maxBits;
    }
    $bits = (int) $bits;
    if ($bits < 0) {
        throw new InvalidArgumentException('The number of CIDR bits cannot be negative.', 2);
    }
    if ($bits > $maxBits) {
        throw new InvalidArgumentException("CIDR bits is greater than $bits.", 3);
    }
    return $bits;
}

            

                public static function getIpVersion(string $ip, bool $validate = true): int
{
    $ipStringLength = strlen($ip);
    if ($ipStringLength < 2) {
        throw new InvalidArgumentException("Unrecognized address $ip", 10);
    }
    $preIpVersion = strpos($ip, ':') === false ? self::IPV4 : self::IPV6;
    if ($preIpVersion === self::IPV4 && $ipStringLength < 7) {
        throw new InvalidArgumentException("Unrecognized address $ip", 11);
    }
    if (!$validate) {
        return $preIpVersion;
    }
    $rawIp = @inet_pton($ip);
    if ($rawIp !== false) {
        return strlen($rawIp) === self::IPV4_ADDRESS_LENGTH >> 3 ? self::IPV4 : self::IPV6;
    }
    if ($preIpVersion === self::IPV6 && preg_match(self::IPV6_REGEXP, $ip) === 1) {
        return self::IPV6;
    }
    throw new InvalidArgumentException("Unrecognized address $ip.", 12);
}

            

                public static function inRange(string $subnet, string $range): bool
{
    [$ip, $mask] = array_pad(explode('/', $subnet), 2, null);
    [$net, $netMask] = array_pad(explode('/', $range), 2, null);
    assert(is_string($ip));
    assert(is_string($net));
    $ipVersion = self::getIpVersion($ip);
    $netVersion = self::getIpVersion($net);
    if ($ipVersion !== $netVersion) {
        return false;
    }
    $maxMask = $ipVersion === self::IPV4 ? self::IPV4_ADDRESS_LENGTH : self::IPV6_ADDRESS_LENGTH;
    $mask ??= $maxMask;
    $netMask ??= $maxMask;
    $binIp = self::ip2bin($ip);
    $binNet = self::ip2bin($net);
    $masked = substr($binNet, 0, (int) $netMask);
    return ($masked === '' || strpos($binIp, $masked) === 0) && $mask >= $netMask;
}

            

                public static function ip2bin(string $ip): string
{
    if (self::getIpVersion($ip) === self::IPV4) {
        $ipBinary = pack('N', ip2long($ip));
    } elseif (@inet_pton('::1') === false) {
        throw new RuntimeException('IPv6 is not supported by inet_pton()!');
    } else {
        $ipBinary = inet_pton($ip);
    }
    assert(is_string($ipBinary));
    $result = '';
    for ($i = 0, $iMax = strlen($ipBinary); $i < $iMax; $i += 4) {
        $data = substr($ipBinary, $i, 4);
        /**
         * @psalm-suppress RiskyTruthyFalsyComparison This is required for PHP 7.4 only.
         */
        if (empty($data)) {
            throw new RuntimeException('An error occurred while converting IP address to bits representation.');
        }
        /**
         * @psalm-suppress MixedArgument, PossiblyInvalidArrayAccess
         */
        $result .= str_pad(decbin(unpack('N', $data)[1]), 32, '0', STR_PAD_LEFT);
    }
    return $result;
}

            

                public static function isIp(string $value): bool
{
    return preg_match(self::IP_REGEXP, $value) === 1;
}

            

                public static function isIpv4(string $value): bool
{
    return preg_match(self::IPV4_REGEXP, $value) === 1;
}

            

                public static function isIpv6(string $value): bool
{
    return preg_match(self::IPV6_REGEXP, $value) === 1;
}