BlueSpice MediaWiki master
 All Classes Namespaces Files Functions Variables Groups Pages
IP Class Reference

Static Public Member Functions

static isIPAddress ($ip)
 
static isIPv6 ($ip)
 
static isIPv4 ($ip)
 
static isValid ($ip)
 
static isValidBlock ($ipRange)
 
static isValidRange ($ipRange)
 
static sanitizeIP ($ip)
 
static prettifyIP ($ip)
 
static splitHostAndPort ($both)
 
static combineHostAndPort ($host, $port, $defaultPort=false)
 
static formatHex ($hex)
 
static hexToOctet ($ip_hex)
 
static hexToQuad ($ip_hex)
 
static isPublic ($ip)
 
static toHex ($ip)
 
static parseCIDR ($range)
 
static parseRange ($range)
 
static isInRange ($addr, $range)
 
static isInRanges ($ip, $ranges)
 
static canonicalize ($addr)
 
static sanitizeRange ($range)
 
static getSubnet ($ip)
 

Detailed Description

A collection of public static functions to play with IP address and IP ranges.

Member Function Documentation

static IP::canonicalize (   $addr)
static

Convert some unusual representations of IPv4 addresses to their canonical dotted quad representation.

This currently only checks a few IPV4-to-IPv6 related cases. More unusual representations may be added later.

Parameters
string$addrSomething that might be an IP address
Returns
string|null Valid dotted quad IPv4 address or null
static IP::combineHostAndPort (   $host,
  $port,
  $defaultPort = false 
)
static

Given a host name and a port, combine them into host/port string like you might find in a URL. If the host contains a colon, wrap it in square brackets like in RFC 2732. If the port matches the default port, omit the port specification

Parameters
string$host
int$port
bool | int$defaultPort
Returns
string
static IP::formatHex (   $hex)
static

Convert an IPv4 or IPv6 hexadecimal representation back to readable format

Parameters
string$hexNumber, with "v6-" prefix if it is IPv6
Returns
string Quad-dotted (IPv4) or octet notation (IPv6)
static IP::getSubnet (   $ip)
static

Returns the subnet of a given IP

Parameters
string$ip
Returns
string|false
static IP::hexToOctet (   $ip_hex)
static

Converts a hexadecimal number to an IPv6 address in octet notation

Parameters
string$ip_hexPure hex (no v6- prefix)
Returns
string (of format a:b:c:d:e:f:g:h)
static IP::hexToQuad (   $ip_hex)
static

Converts a hexadecimal number to an IPv4 address in quad-dotted notation

Parameters
string$ip_hexPure hex
Returns
string (of format a.b.c.d)
static IP::isInRange (   $addr,
  $range 
)
static

Determine if a given IPv4/IPv6 address is in a given CIDR network

Parameters
string$addrThe address to check against the given range.
string$rangeThe range to check the given address against.
Returns
bool Whether or not the given address is in the given range.
Note
This can return unexpected results for invalid arguments! Make sure you pass a valid IP address and IP range.
static IP::isInRanges (   $ip,
  $ranges 
)
static

Determines if an IP address is a list of CIDR a.b.c.d/n ranges.

Since
1.25
Parameters
string$ipthe IP to check
array$rangesthe IP ranges, each element a range
Returns
bool true if the specified adress belongs to the specified range; otherwise, false.
static IP::isIPAddress (   $ip)
static

Determine if a string is as valid IP address or network (CIDR prefix). SIIT IPv4-translated addresses are rejected.

Note
canonicalize() tries to convert translated addresses to IPv4.
Parameters
string$ipPossible IP address
Returns
bool
static IP::isIPv4 (   $ip)
static

Given a string, determine if it as valid IP in IPv4 only.

Note
Unlike isValid(), this looks for networks too.
Parameters
string$ipPossible IP address
Returns
bool
static IP::isIPv6 (   $ip)
static

Given a string, determine if it as valid IP in IPv6 only.

Note
Unlike isValid(), this looks for networks too.
Parameters
string$ipPossible IP address
Returns
bool
static IP::isPublic (   $ip)
static

Determine if an IP address really is an IP address, and if it is public, i.e. not RFC 1918 or similar

Parameters
string$ip
Returns
bool
static IP::isValid (   $ip)
static

Validate an IP address. Ranges are NOT considered valid. SIIT IPv4-translated addresses are rejected.

Note
canonicalize() tries to convert translated addresses to IPv4.
Parameters
string$ip
Returns
bool True if it is valid
static IP::isValidBlock (   $ipRange)
static

Validate an IP range (valid address with a valid CIDR prefix). SIIT IPv4-translated addresses are rejected.

Note
canonicalize() tries to convert translated addresses to IPv4.
Deprecated:
since 1.30. Use the equivalent IP::isValidRange().
Parameters
string$ipRange
Returns
bool True if it is valid
static IP::isValidRange (   $ipRange)
static

Validate an IP range (valid address with a valid CIDR prefix). SIIT IPv4-translated addresses are rejected.

Note
canonicalize() tries to convert translated addresses to IPv4.
Parameters
string$ipRange
Returns
bool True if it is valid
Since
1.30
static IP::parseCIDR (   $range)
static

Convert a network specification in CIDR notation to an integer network and a number of bits

Parameters
string$rangeIP with CIDR prefix
Returns
array(int or string, int)
static IP::parseRange (   $range)
static

Given a string range in a number of formats, return the start and end of the range in hexadecimal.

Formats are: 1.2.3.4/24 CIDR 1.2.3.4 - 1.2.3.5 Explicit range 1.2.3.4 Single IP

2001:0db8:85a3::7344/96 CIDR 2001:0db8:85a3::7344 - 2001:0db8:85a3::7344 Explicit range 2001:0db8:85a3::7344 Single IP

Parameters
string$rangeIP range
Returns
array [ string, string ]
static IP::prettifyIP (   $ip)
static

Prettify an IP for display to end users. This will make it more compact and lower-case.

Parameters
string$ip
Returns
string
static IP::sanitizeIP (   $ip)
static

Convert an IP into a verbose, uppercase, normalized form. Both IPv4 and IPv6 addresses are trimmed. Additionally, IPv6 addresses in octet notation are expanded to 8 words; IPv4 addresses have leading zeros, in each octet, removed.

Parameters
string$ipIP address in quad or octet form (CIDR or not).
Returns
string
static IP::sanitizeRange (   $range)
static

Gets rid of unneeded numbers in quad-dotted/octet IP strings For example, 127.111.113.151/24 -> 127.111.113.0/24

Parameters
string$rangeIP address to normalize
Returns
string
static IP::splitHostAndPort (   $both)
static

Given a host/port string, like one might find in the host part of a URL per RFC 2732, split the hostname part and the port part and return an array with an element for each. If there is no port part, the array will have false in place of the port. If the string was invalid in some way, false is returned.

This was easy with IPv4 and was generally done in an ad-hoc way, but with IPv6 it's somewhat more complicated due to the need to parse the square brackets and colons.

A bare IPv6 address is accepted despite the lack of square brackets.

Parameters
string$bothThe string with the host and port
Returns
array|false Array normally, false on certain failures
static IP::toHex (   $ip)
static

Return a zero-padded upper case hexadecimal representation of an IP address.

Hexadecimal addresses are used because they can easily be extended to IPv6 support. To separate the ranges, the return value from this function for an IPv6 address will be prefixed with "v6-", a non- hexadecimal string which sorts after the IPv4 addresses.

Parameters
string$ipQuad dotted/octet IP address.
Returns
string|bool False on failure

The documentation for this class was generated from the following file: