README

Component providing Network tools.

Installation

With Composer:

{ "require": { "matomo/network": "*" } }

Usage

IP

To manipulate an IP address, you can use the Matomo\Network\IP class:

$ip = IP::fromStringIP('127.0.0.1'); // IPv6 $ip = IP::fromStringIP('::1'); // In binary format: $ip = IP::fromBinaryIP("\x7F\x00\x00\x01"); echo $ip->toString(); // 127.0.0.1 echo $ip->toBinary(); // IPv4 & IPv6 if ($ip instanceof IPv4) {} if ($ip instanceof IPv6) {} // Hostname reverse lookup echo $ip->getHostname(); if ($ip->isInRange('192.168.1.1/32')) {} if ($ip->isInRange('192.168.*.*')) {} // Anonymize an IP by setting X bytes to null bytes $ip->anonymize(2);

The Matomo\Network\IPUtils class provides utility methods:

echo IPUtils::binaryToStringIP("\x7F\x00\x00\x01"); echo IPUtils::stringToBinaryIP('127.0.0.1'); // Sanitization methods $sanitizedIp = IPUtils::sanitizeIp($_GET['ip']); $sanitizedIpRange = IPUtils::sanitizeIpRange($_GET['ipRange']); // IP range $bounds = IPUtils::getIPRangeBounds('192.168.1.*'); echo $bounds[0]; // 192.168.1.0 echo $bounds[1]; // 192.168.1.255

License

The Network component is released under the LGPL v3.0.