class IpAddress in IP address fields 8

IpTools class.

Hierarchy

• class \Drupal\field_ipaddress\IpAddress

2 files declare their use of IpAddress

IpAddressField.php in src/Plugin/Field/FieldType/IpAddressField.php

IpAddressWidgetBase.php in src/Plugin/Field/FieldWidget/IpAddressWidgetBase.php

File

src/IpAddress.php, line 8

Namespace

Drupal\field_ipaddress

class IpAddress {
  const IP_FAMILY_4 = 4;
  const IP_FAMILY_6 = 6;
  const IP_FAMILY_ALL = 10;
  const IP_RANGE_SIMPLE = 2;
  const IP_RANGE_CIDR = 3;
  const IP_RANGE_NONE = 0;
  protected $family = NULL;
  protected $type = NULL;
  protected $start = NULL;
  protected $end = NULL;
  protected $raw = NULL;

  /**
   * Getter for $this->family.
   */
  public function family() {
    return $this->family;
  }

  /**
   * Getter for $this->type.
   */
  public function type() {
    return $this->type;
  }

  /**
   * Getter for $this->start.
   */
  public function start() {
    return $this->start;
  }

  /**
   * Getter for $this->end.
   */
  public function end() {
    return $this->end;
  }

  /**
   * On construction, parse the given value.
   */
  public function __construct($value) {
    $this->raw = $value;
    $result = $this
      ->parse($value);
    if ($result === FALSE) {
      $this->family = NULL;
      $this->type = NULL;
      $this->start = NULL;
      $this->end = NULL;
      throw new \Exception('Invalid value.');
    }
  }

  /**
   * Checks if the stored IP is within $min and $max IPs.
   */
  public function inRange($min, $max) {
    if (!$this
      ->isIpAddress($min) || !$this
      ->isIpAddress($max)) {
      throw new \Exception('Invalid value.');
    }

    // IPs in different families are by default not within range.
    if ($this
      ->getFamily($min) != $this->family || $this
      ->getFamily($max) != $this->family) {
      return FALSE;
    }
    if ($this->family == self::IP_FAMILY_4) {
      return $this
        ->inRange4($min, $max);
    }
    else {
      return $this
        ->inRange6($min, $max);
    }
  }

  /**
   * Checks if the given IP is valid.
   */
  private function isIpAddress($ip) {
    return filter_var($ip, FILTER_VALIDATE_IP);
  }

  /**
   * Checks if the given IP is valid IPv6.
   */
  private function isIpV6($ip) {
    return filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV6);
  }

  /**
   * Checks if the given IP is valid IPv4.
   */
  private function isIpV4($ip) {
    return filter_var($ip, FILTER_VALIDATE_IP, FILTER_FLAG_IPV4);
  }

  /**
   * Find if the IP family is IPv4 or IPv6.
   */
  private function getFamily($ip) {
    if ($this
      ->isIpV4($ip)) {
      return self::IP_FAMILY_4;
    }
    return self::IP_FAMILY_6;
  }

  /**
   * Find if the value given is an IP, IP range, or other.
   */
  private function parse($value) {
    $value = trim(str_replace(' ', '', $value));

    // Check if this is a simple range.
    if (strpos($value, '-') !== FALSE) {

      // Break its parts apart.
      list($start, $end) = explode('-', $value, 2);
      if (!$this
        ->isIpAddress($start) || !$this
        ->isIpAddress($end) || $this
        ->isIpV6($start) && !$this
        ->isIpV6($end) || $this
        ->isIpV4($start) && !$this
        ->isIpV4($end)) {

        // Return false on failure.
        return FALSE;
      }

      // Simple is ... simple, assign the bounds.
      $this->start = $start;
      $this->end = $end;
      $this->family = $this
        ->getFamily($start);
      $this->type = self::IP_RANGE_SIMPLE;
    }
    elseif (strpos($value, '/') !== FALSE) {

      // Break its parts apart.
      list($ip, $prefix) = explode('/', $value, 2);
      if (!$this
        ->isIpAddress($ip) || !is_numeric($prefix) || $prefix <= 0) {
        return FALSE;
      }
      $this->family = $this
        ->getFamily($ip);

      // Check that the prefix is not larger than address.
      if ($this->family == self::IP_FAMILY_4 && $prefix > 32 || $this->family == self::IP_FAMILY_6 && $prefix > 128) {
        return FALSE;
      }
      $this->type = self::IP_RANGE_CIDR;

      // Calculate CIDR address bounds.
      if ($this->family == self::IP_FAMILY_4) {
        $this
          ->calcCidr4($ip, $prefix);
      }
      else {
        $this
          ->calcCidr6($ip, $prefix);
      }
    }
    elseif ($this
      ->isIpAddress($value)) {
      $this->type = self::IP_RANGE_NONE;
      $this->family = $this
        ->getFamily($value);
      $this->start = $value;
      $this->end = $value;
    }
    else {
      return FALSE;
    }
  }

  /**
   * Calculates the IP range for an IPv4 CIDR formatted range.
   *
   * @see https://stackoverflow.com/questions/15961557/calculate-ip-range-using-php-and-cidr#answer-55229198
   */
  private function calcCidr4($ip, $prefix) {
    $this->start = long2ip(ip2long($ip) & -1 << 32 - (int) $prefix);
    $this->end = long2ip(ip2long($this->start) + pow(2, 32 - (int) $prefix) - 1);
  }

  /**
   * Calculates the IP range for an IPv6 CIDR formatted range.
   *
   * @see https://stackoverflow.com/questions/10085266/php5-calculate-ipv6-range-from-cidr-prefix#answer-10086404
   */
  private function calcCidr6($ip, $prefix) {
    $start_bin = $this
      ->packIp6($ip);
    $this->start = inet_ntop($start_bin);

    // Convert the binary string to a string with hexadecimal characters.
    $start_hex = reset(unpack('H*', $start_bin));

    // Calculate flexible bits.
    $flexbits = 128 - $prefix;
    $end_hex = $start_hex;
    $pos = 31;
    while ($flexbits > 0) {

      // Get the character at this position.
      $orig = substr($end_hex, $pos, 1);

      // Convert it to an integer.
      $origval = hexdec($orig);

      // OR it with (2^flexbits)-1, with flexbits limited to 4 at a time.
      $newval = $origval | pow(2, min(4, $flexbits)) - 1;

      // Convert it back to a hexadecimal character.
      $new = dechex($newval);

      // And put that character back in the string.
      $end_hex = substr_replace($end_hex, $new, $pos, 1);

      // We processed one nibble, move to previous position.
      $flexbits -= 4;
      $pos -= 1;
    }
    $end_bin = pack('H*', $end_hex);

    // And create an IPv6 address from the binary string.
    $this->end = inet_ntop($end_bin);
  }

  /**
   * Strips leading zeros and converts an IPv4 to its binary representation.
   */
  private function packIp4($ip) {
    return inet_pton(preg_replace('/\\b0+(?=\\d)/', '', $ip));
  }

  /**
   * Converts an IPv6 to its binary representation.
   */
  private function packIp6($ip) {
    return inet_pton($ip);
  }

  /**
   * Checks if the current IPv4 is within a given min and max IP.
   *
   * @see https://stackoverflow.com/questions/18336908/php-check-if-ip-address-is-in-a-range-of-ip-addresses/18336909#answer-18336909
   */
  private function inRange4($min, $max) {
    $min_long = ip2long($min);
    $max_long = ip2long($max);
    if ($this->type == self::IP_RANGE_NONE) {
      $start_long = $end_long = ip2long($this->start);
    }
    else {
      $start_long = ip2long($this->start);
      $end_long = ip2long($this->end);
    }
    return $start_long >= $min_long && $start_long <= $max_long && ($end_long >= $min_long && $end_long <= $max_long);
  }

  /**
   * Checks if the current IPv6 is within a given min and max IP.
   */
  private function inRange6($min, $max) {
    $min_bin = inet_pton($min);
    $max_bin = inet_pton($max);
    if ($this->type == self::IP_RANGE_NONE) {
      $start_bin = $end_bin = inet_pton($this->start);
    }
    else {
      $start_bin = inet_pton($this->start);
      $end_bin = inet_pton($this->end);
    }
    return $start_bin >= $min_bin && $start_bin <= $max_bin && ($end_bin >= $min_bin && $end_bin <= $max_bin);
  }

}

Members

Name	Modifiers	Type	Description	Overrides
IpAddress::$end	protected	property
IpAddress::$family	protected	property
IpAddress::$raw	protected	property
IpAddress::$start	protected	property
IpAddress::$type	protected	property
IpAddress::calcCidr4	private	function	Calculates the IP range for an IPv4 CIDR formatted range.
IpAddress::calcCidr6	private	function	Calculates the IP range for an IPv6 CIDR formatted range.
IpAddress::end	public	function	Getter for $this->end.
IpAddress::family	public	function	Getter for $this->family.
IpAddress::getFamily	private	function	Find if the IP family is IPv4 or IPv6.
IpAddress::inRange	public	function	Checks if the stored IP is within $min and $max IPs.
IpAddress::inRange4	private	function	Checks if the current IPv4 is within a given min and max IP.
IpAddress::inRange6	private	function	Checks if the current IPv6 is within a given min and max IP.
IpAddress::IP_FAMILY_4		constant
IpAddress::IP_FAMILY_6		constant
IpAddress::IP_FAMILY_ALL		constant
IpAddress::IP_RANGE_CIDR		constant
IpAddress::IP_RANGE_NONE		constant
IpAddress::IP_RANGE_SIMPLE		constant
IpAddress::isIpAddress	private	function	Checks if the given IP is valid.
IpAddress::isIpV4	private	function	Checks if the given IP is valid IPv4.
IpAddress::isIpV6	private	function	Checks if the given IP is valid IPv6.
IpAddress::packIp4	private	function	Strips leading zeros and converts an IPv4 to its binary representation.
IpAddress::packIp6	private	function	Converts an IPv6 to its binary representation.
IpAddress::parse	private	function	Find if the value given is an IP, IP range, or other.
IpAddress::start	public	function	Getter for $this->start.
IpAddress::type	public	function	Getter for $this->type.
IpAddress::__construct	public	function	On construction, parse the given value.