PhutilIPAddress.php
No OneTemporary
Actions

Subscribers

None

File Metadata

	<?php

	/**
	* Represent and manipulate IP addresses.
	*
	* NOTE: This class only supports IPv4 for now.
	*/
	final class PhutilIPAddress extends Phobject {

	private $ip;
	private $bits;

	private function __construct() {
	// <private>
	}

	public static function newAddress($in) {
	if ($in instanceof PhutilIPAddress) {
	return $in;
	}

	return self::newFromString($in);
	}

	private static function newFromString($str) {
	$matches = null;
	$ok = preg_match('(^(\d+)\.(\d+)\.(\d+).(\d+)\z)', $str, $matches);
	if (!$ok) {
	throw new Exception(
	pht(
	'IP address "%s" is not properly formatted. Expected an IP '.
	'address like "23.45.67.89".',
	$str));
	}

	$parts = array_slice($matches, 1);
	foreach ($parts as $part) {
	if (preg_match('/^0\d/', $part)) {
	throw new Exception(
	pht(
	'IP address "%s" is not properly formatted. Address segments '.
	'should have no leading zeroes, but segment "%s" has a leading '.
	'zero.',
	$str,
	$part));
	}

	$value = (int)$part;
	if ($value < 0 \|\| $value > 255) {
	throw new Exception(
	pht(
	'IP address "%s" is not properly formatted. Address segments '.
	'should be between 0 and 255, inclusive, but segment "%s" has '.
	'a value outside of this range.',
	$str,
	$part));
	}
	}

	$obj = new PhutilIPAddress();
	$obj->ip = $str;

	return $obj;
	}

	public function toBits() {
	if ($this->bits === null) {
	$bits = '';
	foreach (explode('.', $this->ip) as $part) {
	$value = (int)$part;
	for ($ii = 7; $ii >= 0; $ii--) {
	$mask = (1 << $ii);
	if (($value & $mask) === $mask) {
	$bits .= '1';
	} else {
	$bits .= '0';
	}
	}
	}

	$this->bits = $bits;
	}

	return $this->bits;
	}

	}