PHPackages                             tomcan/subnet-parser - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. tomcan/subnet-parser

ActiveLibrary[Utility & Helpers](/categories/utility)

tomcan/subnet-parser
====================

IP Subnet parser and merger/aggregator

1.3.0(5mo ago)037Apache-2.0PHP

Since Nov 9Pushed 5mo agoCompare

[ Source](https://github.com/TomCan/subnet-parser)[ Packagist](https://packagist.org/packages/tomcan/subnet-parser)[ Docs](https://github.com/tomcan/subnet-parser)[ RSS](/packages/tomcan-subnet-parser/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (3)Versions (8)Used By (0)

TomCan\\SubnetParser
====================

[](#tomcansubnetparser)

TomCan's subnet parser and merger library can parse, merge/aggregate IP subnets into a structured `Subnet` object.

Usage
-----

[](#usage)

Add the library to your project using composer

```
composer require tomcan/subnet-parser

```

Then just instantiate it

```
$parser = new TomCan\SubnetParser\SubnetParser();
// Parse ranges into subnets
$subnets = $parser->parseRanges(['192.168.1.0/24', '192.168.2.0/24', '192.168.0.0/24']);
// Merge subnets
$subnets = $parser->mergeSubnets($subnets);
foreach ($subnets as $subnet) {
    echo 'Network: '.$subnet->network.'/'.$subnet->prefixlenght.PHP_EOL;
}
```

### Parsing

[](#parsing)

This library allows you to parse subnets in various notations. The library will try and figure it out.

```
192.168.0.1
-> 192.168.0.1/32
192.168.1.1/24
-> 192.168.1.0/24
192.168.2.1/255.255.255.0
-> 192.168.2.0/24
192.168.3.0-192.168.3.255
-> 192.168.3.0/24
192.168.4.0-192.168.5.128
-> 192.168.4.0/24 + 192.168.5.0/25 + 192.168.5.128/32

```

### Merging

[](#merging)

It can also merge an array of subnets into the least possible amount of subnets.

```
192.168.0.0/24
192.168.1.0/24
-> 192.168.0.0/23
192.168.0.0/24
192.168.1.0/24
192.168.2.0/24
192.168.3.0/25
192.168.3.128/25
-> 192.168.0.0/22

```

### The `Subnet` object

[](#the-subnet-object)

The `Subnet` object is a very simple but structured object containing the network address and prefix length. It also contains the last IP of the range, as well as the preceding IP (last IP of previous subnet) and the next IP (first IP of the next subnet). IPs are available in their textual representation, as well as in their packed format.

###  Health Score

33

—

LowBetter than 72% of packages

Maintenance73

Regular maintenance activity

Popularity7

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity40

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~20 days

Recently: every ~30 days

Total

7

Last Release

150d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2892620?v=4)[TomCan](/maintainers/TomCan)[@TomCan](https://github.com/TomCan)

---

Top Contributors

[![TomCan](https://avatars.githubusercontent.com/u/2892620?v=4)](https://github.com/TomCan "TomCan (15 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/tomcan-subnet-parser/health.svg)

```
[![Health](https://phpackages.com/badges/tomcan-subnet-parser/health.svg)](https://phpackages.com/packages/tomcan-subnet-parser)
```

###  Alternatives

[backendorf/module-installment

Add installment feature to Magento 2 catalog

177.0k](/packages/backendorf-module-installment)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)