matomo/network

Maintainers

Details

github.com/matomo-org/component-network

Source

Issues

Installs: 520 078

Dependents: 2

Suggesters: 0

Security: 0

Stars: 20

Watchers: 21

Forks: 12

Open Issues: 1

2.0.1 2020-10-05 06:09 UTC

Requires

  • php: >=5.4

Requires (Dev)

LGPL-3.0 ff654b8fc7778b80279815d06a368f7b41249501

This package is auto-updated.

Last update: 2024-10-29 05:53:12 UTC

README

Component providing Network tools.

Build Status

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.