forked from vergnet/site-accueil-insa
67 lines
1.4 KiB
Markdown
67 lines
1.4 KiB
Markdown
# Matomo/Network
|
|
|
|
Component providing Network tools.
|
|
|
|
[](https://travis-ci.org/matomo-org/component-network)
|
|
|
|
## 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/).
|