ipaddress.php

См. документацию.

<?php

 
namespace Bitrix\Main\Web;
 
use Psr\Http\Message\UriInterface;
 
class IpAddress
{
    protected $ip;

    public function __construct($ip)
    {
        $this->ip = $ip;
    }

    public static function createByName($name)
    {
        $ip = gethostbyname($name);
        return new static($ip);
    }

    public static function createByUri(UriInterface $uri)
    {
        return static::createByName($uri->getHost());
    }

    public function get(): string
    {
        return $this->ip;
    }

    public function __toString()
    {
        return $this->get();
    }

    public function isPrivate(): bool
    {
        return (filter_var($this->ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4 | FILTER_FLAG_IPV6 | FILTER_FLAG_NO_PRIV_RANGE | FILTER_FLAG_NO_RES_RANGE) === false);
    }

    public function isIPv4(): bool
    {
        return (filter_var($this->ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4) !== false);
    }

    public function matchRange(string $cidr): bool
    {
        if (str_contains($cidr, '/'))
        {
            [$subnet, $mask] = explode('/', $cidr);
        }
        else
        {
            $subnet = $cidr;
            $mask = 32;
        }
 
        return (ip2long($this->ip) & ~((1 << (32 - $mask)) - 1)) === ip2long($subnet);
    }

    public function toUnsigned(): string
    {
        return sprintf('%u', ip2long($this->ip));
    }

    public function toRange(int $prefixLen): string
    {
        return long2ip(ip2long($this->ip) & ~((1 << (32 - $prefixLen)) - 1)) . '/' . $prefixLen;
    }
}