PHP Classes
elePHPant
Icontem

Aggregator: Aggregate multiple IP addresses in single ranges

Recommend this page to a friend!
  Info   View files Documentation   View files View files (6)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2017-10-05 (13 days ago) RSS 2.0 feedNot yet rated by the usersTotal: 45 This week: 42All time: 9,000 This week: 15Up
Version License PHP version Categories
aggregator 1.0Custom (specified...5Networking, PHP 5
Description Author

This package can aggregate multiple IP addresses in single ranges.

It takes an array of IP addresses or ranges and merges those that are contiguous to reduce the number of ranges that may represent the same IP addresses.

The class supports both IPv4 and IPv6 IP addresses.

Name: Caleb <contact>
Classes: 1 package by
Country: Australia Australia
Age: ???
All time rank: 412848 in Australia Australia
Week rank: 18 Up1 in Australia Australia Up

Details

Aggregator.

License: GPL v2

A stand-alone class implementation of the IPv4+IPv6 IP+CIDR aggregator from CIDRAM.

How to install:

As a stand-alone PHP class, installing it is exceptionally easy. You can download the file containing the class, aggregator.php, directly from this repository, and copy it to any projects that need it, or, if you'd prefer, you can install it using Composer:

composer require cidram/aggregator

Note: The code in this class is based upon code in the CIDRAM package, but the two are NOT dependent on each other.

After you've downloaded the file, to allow your projects to use the class, PSR-4 autoloading is preferred (particularly if you're using a large number of different, unrelated classes). If you're installing the class via Composer, then this will already be taken care of for you, and you won't need to worry about it. Alternatively, if you're installing it manually (or without Composer), and don't want to use a PSR-4 autoloader, you can simply require or include the class into your projects (which may be much easier in many cases) by including the respective statement to point to the class file in the relevant PHP files:

<?php
require __DIR__ . '/aggregator.php';

How to use:

The simplest way to use Aggregator is to create a new instance of the class and enter some data to be aggregated as a parameter to the aggregate method. The aggregate method will return an aggregate of the entered data.

Example:

<?php
$Aggregator = new Aggregator();
$Output = $Aggregator->aggregate($Input);

In the case of the above example, if this is entered as $Input:

127.0.0.1 Some arbitrary single IPs from here
127.0.0.2
127.0.0.3
1::
1::1
1:2:3:4::0
1:2:3:4::1
1:2:3:4::2
1:2:3:4::3
2002::1
127.0.0.4
127.0.0.5
257.0.0.999 Some arbitrary INVALID single IPs from here
555.666.777.888
2002:abcd:efgh::1
10.0.0.0/9 Some arbitrary CIDRs from here
10.128.0.0/9
10.192.0.0/10
11.128.0.0/10
11.192.0.0/10
12.0.0.0/9
12.128.0.0/9
13.0.0.0/9
13.128.0.0/9
192.168.0.0/8 Some arbitrary INVALID CIDRs from here
192.168.0.0/9
192.168.0.0/10
192.168.192.0/10
192.169.0.0/10
192.169.64.0/10
Foobar Some garbage data from here
ASDFQWER!@#$
>>HelloWorld<<
SDFSDFSDF
QWEQWEQWE

$Output will be expected to contain this:

1::/127
1:2:3:4::/126
10.0.0.0/8
11.128.0.0/9
12.0.0.0/7
2002::1/128
127.0.0.1/32
127.0.0.2/31
127.0.0.4/31

Data is newline-delimited and each line represents one item to be aggregated. Aggregator handles IPv4+IPv6 seamlessly, attempts to clean up each item (i.e., remove invalid and superfluous data in order to reduce to a valid IP or CIDR), attempts to aggregate the resultant cleaned up data (unreadable and invalid data is rejected), and then returns the resultant aggregated data.

It is possible to obtain more information about each aggregation operation if desired. If "Results" is set to true (it is false by default), then "NumberEntered" (the total number of lines entered when an operation begins), "NumberRejected" (the number of lines or items "rejected", i.e., perceived as invalid, or unreadable; note that this number will also also duplicate items, due to that duplicates are stripped along with invalid and superfluous data prior to aggregation), "NumberAccepted" (the number of lines or items accepted for aggregation; i.e., NumberAccepted = NumberEntered - NumberRejected), "NumberMerged" (the total number of items aggregated or merged), and "NumberReturned" (the total number of items returned at the end of an operation) will be populated during operation accordingly. These values can be retrieved after each operation from the class instance or object:

<?php
$Aggregator = new Aggregator();
$Aggregator->Results = true;
$Output = $Aggregator->aggregate($Input);
echo $Output;
echo "\n\n";
echo $Aggregator->NumberEntered . "\n";
echo $Aggregator->NumberRejected . "\n";
echo $Aggregator->NumberAccepted . "\n";
echo $Aggregator->NumberMerged . "\n";
echo $Aggregator->NumberReturned . "\n";

Generally, it is better to create a new class instance for each aggregation operation. However, if you want to recycle an old instance, and want to continue to retrieve these values after each operation, you can reset these values to their initial state between operations by using the "resetNumbers" method:

$Aggregator->resetNumbers();

Regardless of whether "Results" is true or false, after each aggregation operation, "ProcessingTime" will be available, in case you want to know how much was consumed during the operation. This could be useful both for debugging and for general vanity purposes.

Example:

<?php
$Aggregator = new Aggregator();
$Output = $Aggregator->aggregate($Input);
echo $Aggregator->ProcessingTime . "\n";

Additionally, "ExpandIPv4" and "ExpandIPv6" public methods are provided with the class, and they function in exactly the same way their CIDRAM package closure counterparts. Calling either of these with an IPv4 or IPv6 IP address respectively will return an array containing the potential factors for the given IP address. The potential factors are all possible subnets (or CIDRs) that the given IP address is a member of. When a valid IP address is supplied, "ExpandIPv4" and "ExpandIPv6" and should return an array with 32 and 128 elements respectively.

Other information:

Licensing:

Licensed as GNU General Public License version 2.0 (GPLv2).

For support:

Please use the issues page of this repository.

Last modified: 22 September 2017 (2017.09.22).

  Files folder image Files  
File Role Description
Plain text file .travis.php Class Class source
Accessible without login Plain text file .travis.yml Data Auxiliary data
Plain text file aggregator.php Class Class source
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file LICENSE.txt Lic. License text
Accessible without login Plain text file README.md Doc. Documentation

 Version Control Unique User Downloads Download Rankings  
 100%
Total:45
This week:42
All time:9,000
This week:15Up