1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
|
# Matomo/Network
Component providing Network tools.
[](https://github.com/matomo-org/component-network/actions/workflows/phpunit.yml)
## Installation
With Composer:
```json
{
"require": {
"matomo/network": "*"
}
}
```
## Usage
### IP
To manipulate an IP address, you can use the `Matomo\Network\IP` class:
```php
$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:
```php
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](http://choosealicense.com/licenses/lgpl-3.0/).
|
