athlon1600/php-cidr-range-optimizer

Given a list of IP ranges, merge them into the smallest possible list of CIDRs.

Maintainers

Details

github.com/Athlon1600/php-cidr-range-optimizer

Source

Issues

Installs: 15

Dependents: 0

Suggesters: 0

Security: 0

Stars: 2

Watchers: 1

Forks: 2

Open Issues: 0

v1.0.2 2024-08-16 19:26 UTC

Requires

  • php: >=7.4.0

Requires (Dev)

MIT f080cb2db0fcb1bfbc81bc13bd7066b47c483d89

cidrip rangescidr optimizersubnet optimizernetwork range optimizercidr merge

This package is auto-updated.

Last update: 2024-12-16 20:33:51 UTC

README

Minimum PHP Version GitHub Workflow Status (with event)

Given a list of IP address ranges, minify that list to the smallest possible size by performing the following optimizations:

  • removing invalid IP addresses/ranges from the list
  • removing duplicates
  • removing IP ranges already covered by larger ranges in the list
  • merging adjacent IP ranges into larger, contiguous blocks

⭐ Demo

An online tool that uses a near exact version of this library:

Installation

composer require athlon1600/php-cidr-range-optimizer

Usage

Build your list of IP ranges into CIDRList object, then use RangeOptimizer class to optimize it. Example:

use ProxyNova\RangeOptimizer\CIDRList;
use ProxyNova\RangeOptimizer\RangeOptimizer;

$ranges = CIDRList::fromArray([
    "192.168.1.0/26",
    "192.168.1.64/27",
    "192.168.1.96/27",
    "10.1.0.0/26",
    "10.1.0.64/26"
]);

// returns new optimized CIDRList object
$optimized = RangeOptimizer::optimize($ranges);

echo $optimized;

Output:

10.1.0.0/25
192.168.1.0/25