PHPackages                             meklis/ipv4-subnet-calculator - 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 &amp; Helpers](/categories/utility)
4. /
5. meklis/ipv4-subnet-calculator

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

meklis/ipv4-subnet-calculator
=============================

Network calculator for subnet mask and other classless (CIDR) network information.

3.2(4y ago)01.1k1MITPHPPHP &gt;=5.5.0

Since Apr 13Pushed 4y agoCompare

[ Source](https://github.com/meklis/ipv4-subnet-calculator-php)[ Packagist](https://packagist.org/packages/meklis/ipv4-subnet-calculator)[ Docs](https://github.com/markrogoyski/ipv4-subnet-calculator-php)[ RSS](/packages/meklis-ipv4-subnet-calculator/feed)WikiDiscussions master Synced yesterday

READMEChangelog (2)Dependencies (6)Versions (12)Used By (1)

IPv4 Subnet Calculator (PHP)
============================

[](#ipv4-subnet-calculator-php)

Network calculator for subnet mask and other classless (CIDR) network information.

[![Coverage Status](https://camo.githubusercontent.com/58a46f789a2865e1dc25c75253f1314be25f9aa02ca663aaaa075c78dc6fd8d0/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6d61726b726f676f79736b692f697076342d7375626e65742d63616c63756c61746f722d7068702f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/markrogoyski/ipv4-subnet-calculator-php?branch=master)[![Build Status](https://camo.githubusercontent.com/f190722a05db7bb61307f4f5f4ecf0f410e46d60dfae0df4a920d57f63f9f95e/68747470733a2f2f7472617669732d63692e6f72672f6d61726b726f676f79736b692f697076342d7375626e65742d63616c63756c61746f722d7068702e7376673f6272616e63683d6d6173746572)](https://travis-ci.org/markrogoyski/ipv4-subnet-calculator-php)[![License](https://camo.githubusercontent.com/11f0e9c92718bfe2c34420fdc7d615c108bc177c1e6cd7149f0d88acc53a9562/68747470733a2f2f706f7365722e707567782e6f72672f6d61726b726f676f79736b692f6d6174682d7068702f6c6963656e7365)](https://packagist.org/packages/markrogoyski/ipv4-subnet-calculator-php)

Features
--------

[](#features)

Given an IP address and CIDR network size, it calculates the network information and provides all-in-one aggregated reports.

### Calculations

[](#calculations)

- IP address
- Network size
- Subnet mask
- Network portion
- Host portion
- Number of IP addresses in the network
- Number of addressable hosts in the network
- IP address range
- Broadcast address
- Min and max host
- All IP addresses
- Is an IP address in the subnet

Provides each data in dotted quads, hexadecimal, and binary formats, as well as array of quads.

### Aggregated Network Calculation Reports

[](#aggregated-network-calculation-reports)

- Associative array
- JSON
- String
- Printed to STDOUT

### Standard Interfaces

[](#standard-interfaces)

- JsonSerializable

Setup
-----

[](#setup)

Add the library to your `composer.json` file in your project:

```
{
  "require": {
      "markrogoyski/ipv4-subnet-calculator": "3.*"
  }
}
```

Use [composer](http://getcomposer.org) to install the library:

```
$ php composer.phar install
```

Composer will install IPv4 Subnet Calculator inside your vendor folder. Then you can add the following to your .php files to the use library with Autoloading.

```
require_once(__DIR__ . '/vendor/autoload.php');
```

Alternatively, use composer on the command line to require and install IPv4 SubnetCalculator:

```
$ php composer.phar require markrogoyski/ipv4-subnet-calculator:3.*

```

### Minimum Requirements

[](#minimum-requirements)

- PHP 5.5

Usage
-----

[](#usage)

### Create New SubnetCalculator

[](#create-new-subnetcalculator)

```
// For network 192.168.112.203/23
$sub = new IPv4\SubnetCalculator('192.168.112.203', 23);
```

### Various Network Information

[](#various-network-information)

```
$number_ip_addresses    = $sub->getNumberIPAddresses();      // 512
$number_hosts           = $sub->getNumberAddressableHosts(); // 510
$address_range          = $sub->getIPAddressRange();         // [192.168.112.0, 192.168.113.255]
$addressable_host_range = $sub->getAddressableHostRange();   // [192.168.112.1, 192.168.113.254]
$network_size           = $sub->getNetworkSize();            // 23
$broadcast_address      = $sub->getBroadcastAddress();       // 192.168.113.255
```

### IP Address

[](#ip-address)

```
$ip_address        = $sub->getIPAddress();       // 192.168.112.203
$ip_address_quads  = $sub->getIPAddressQuads();  // [192, 168, 112, 203]
$ip_address_hex    = $sub->getIPAddressHex();    // C0A870CB
$ip_address_binary = $sub->getIPAddressBinary(); // 11000000101010000111000011001011
```

### Subnet Mask

[](#subnet-mask)

```
$subnet_mask        = $sub->getSubnetMask();       // 255.255.254.0
$subnet_mask_quads  = $sub->getSubnetMaskQuads();  // [255, 255, 254, 0]
$subnet_mask_hex    = $sub->getSubnetMaskHex();    // FFFFFE00
$subnet_mask_binary = $sub->getSubnetMaskBinary(); // 11111111111111111111111000000000
```

### Network Portion

[](#network-portion)

```
$network        = $sub->getNetworkPortion();       // 192.168.112.0
$network_quads  = $sub->getNetworkPortionQuads();  // [192, 168, 112, 0]
$network_hex    = $sub->getNetworkPortionHex();    // C0A87000
$network_binary = $sub->getNetworkPortionBinary(); // 11000000101010000111000000000000
```

### Host Portion

[](#host-portion)

```
$host        = $sub->getHostPortion();       // 0.0.0.203
$host_quads  = $sub->getHostPortionQuads();  // [0, 0, 0, 203]
$host_hex    = $sub->getHostPortionHex();    // 000000CB
$host_binary = $sub->getHostPortionBinary(); // 00000000000000000000000011001011
```

### Min and Max Host

[](#min-and-max-host)

```
$min_host        = $sub->getMinHost();       // 192.168.112.1
$min_host_quads  = $sub->getMinHostQuads();  // [192, 168, 112, 1]
$min_host_hex    = $sub->getMinHostHex();    // C0A87001
$min_host_binary = $sub->getMinHostBinary(); // 11000000101010000111000000000001

$max_host        = $sub->getMaxHost();       // 192.168.113.254
$max_host_quads  = $sub->getMaxHostQuads();  // [192, 168, 113, 254]
$max_host_hex    = $sub->getMaxHostHex();    // C0A871FE
$max_host_binary = $sub->getMaxHostBinary(); // 11000000101010000111000111111110
```

### All IP Addresses

[](#all-ip-addresses)

```
foreach ($sub->getAllIPAddresses() as $ip_address) {
    echo $ip_address;
}

foreach ($sub->getAllHostIPAddresses() as $host_address) {
    echo $host_address;
}
```

### Is IP Address in Subnet

[](#is-ip-address-in-subnet)

```
$bool_true  = $sub->isIPAddressInSubnet('192.168.112.5');
$bool_false = $sub->isIPAddressInSubnet('192.168.111.5');
```

### Reports

[](#reports)

#### Printed Report

[](#printed-report)

```
$sub->printSubnetReport();
/*
192.168.112.203/23           Quads      Hex                           Binary
------------------ --------------- -------- --------------------------------
IP Address:        192.168.112.203 C0A870CB 11000000101010000111000011001011
Subnet Mask:         255.255.254.0 FFFFFE00 11111111111111111111111000000000
Network Portion:     192.168.112.0 C0A87000 11000000101010000111000000000000
Host Portion:            0.0.0.203 000000CB 00000000000000000000000011001011

Number of IP Addresses:      512
Number of Addressable Hosts: 510
IP Address Range:            192.168.112.0 - 192.168.113.255
Broadcast Address:           192.168.113.255
Min Host:                    192.168.112.1
Max Host:                    192.168.113.254
*/
```

#### Array Report

[](#array-report)

```
$sub->getSubnetArrayReport();
/*
Array
(
    [ip_address_with_network_size] => 192.168.112.203/23
    [ip_address] => Array
        (
            [quads] => 192.168.112.203
            [hex] => C0A870CB
            [binary] => 11000000101010000111000011001011
        )

    [subnet_mask] => Array
        (
            [quads] => 255.255.254.0
            [hex] => FFFFFE00
            [binary] => 11111111111111111111111000000000
        )

    [network_portion] => Array
        (
            [quads] => 192.168.112.0
            [hex] => C0A87000
            [binary] => 11000000101010000111000000000000
        )

    [host_portion] => Array
        (
            [quads] => 0.0.0.203
            [hex] => 000000CB
            [binary] => 00000000000000000000000011001011
        )

    [network_size] => 23
    [number_of_ip_addresses] => 512
    [number_of_addressable_hosts] => 510
    [ip_address_range] => Array
        (
            [0] => 192.168.112.0
            [1] => 192.168.113.255
        )

    [broadcast_address] => 192.168.113.255
    [min_host] => 192.168.112.1
    [max_host] => 192.168.113.254
)
*/
```

#### JSON Report

[](#json-report)

```
$sub->getSubnetJSONReport();
/*
{
    "ip_address_with_network_size": "192.168.112.203/23",
    "ip_address": {
        "quads": "192.168.112.203",
        "hex": "C0A870CB",
        "binary": "11000000101010000111000011001011"
    },
    "subnet_mask": {
        "quads": "255.255.254.0",
        "hex": "FFFFFE00",
        "binary": "11111111111111111111111000000000"
    },
    "network_portion": {
        "quads": "192.168.112.0",
        "hex": "C0A87000",
        "binary": "11000000101010000111000000000000"
    },
    "host_portion": {
        "quads": "0.0.0.203",
        "hex": "000000CB",
        "binary": "00000000000000000000000011001011"
    },
    "network_size": 23,
    "number_of_ip_addresses": 512,
    "number_of_addressable_hosts": 510,
    "ip_address_range": [
        "192.168.112.0",
        "192.168.113.255"
    ],
    "broadcast_address": "192.168.113.255",
    "min_host": "192.168.112.1",
    "max_host": "192.168.113.254"
}
*/
```

#### String Report

[](#string-report)

```
$string_report = $sub->getPrintableReport();
/*
192.168.112.203/23           Quads      Hex                           Binary
------------------ --------------- -------- --------------------------------
IP Address:        192.168.112.203 C0A870CB 11000000101010000111000011001011
Subnet Mask:         255.255.254.0 FFFFFE00 11111111111111111111111000000000
Network Portion:     192.168.112.0 C0A87000 11000000101010000111000000000000
Host Portion:            0.0.0.203 000000CB 00000000000000000000000011001011

Number of IP Addresses:      512
Number of Addressable Hosts: 510
IP Address Range:            192.168.112.0 - 192.168.113.255
Broadcast Address:           192.168.113.255
Min Host:                    192.168.112.1
Max Host:                    192.168.113.254
*/
```

#### Printing - String Representation

[](#printing---string-representation)

```
print($sub);
/*
192.168.112.203/23           Quads      Hex                           Binary
------------------ --------------- -------- --------------------------------
IP Address:        192.168.112.203 C0A870CB 11000000101010000111000011001011
Subnet Mask:         255.255.254.0 FFFFFE00 11111111111111111111111000000000
Network Portion:     192.168.112.0 C0A87000 11000000101010000111000000000000
Host Portion:            0.0.0.203 000000CB 00000000000000000000000011001011

Number of IP Addresses:      512
Number of Addressable Hosts: 510
IP Address Range:            192.168.112.0 - 192.168.113.255
Broadcast Address:           192.168.113.255
Min Host:                    192.168.112.1
Max Host:                    192.168.113.254
*/
```

### Standard Interfaces

[](#standard-interfaces-1)

#### JsonSerializable

[](#jsonserializable)

```
$json = json_encode($sub);
```

Unit Tests
----------

[](#unit-tests)

```
$ cd tests
$ phpunit
```

[![Coverage Status](https://camo.githubusercontent.com/58a46f789a2865e1dc25c75253f1314be25f9aa02ca663aaaa075c78dc6fd8d0/68747470733a2f2f636f766572616c6c732e696f2f7265706f732f6769746875622f6d61726b726f676f79736b692f697076342d7375626e65742d63616c63756c61746f722d7068702f62616467652e7376673f6272616e63683d6d6173746572)](https://coveralls.io/github/markrogoyski/ipv4-subnet-calculator-php?branch=master)

Standards
---------

[](#standards)

IPv4 Subnet Calculator (PHP) conforms to the following standards:

- PSR-1 - Basic coding standard ()
- PSR-2 - Coding style guide ()
- PSR-4 - Autoloader ()

License
-------

[](#license)

IPv4 Subnet Calculator (PHP) is licensed under the MIT License.

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity65

Established project with proven stability

 Bus Factor1

Top contributor holds 94.3% 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 ~301 days

Recently: every ~341 days

Total

8

Last Release

1623d ago

Major Versions

v2.1.0 → v3.0.02018-10-27

PHP version history (2 changes)v2.0.0PHP &gt;=5.3.0

v3.0.0PHP &gt;=5.5.0

### Community

Maintainers

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

---

Top Contributors

[![markrogoyski](https://avatars.githubusercontent.com/u/10004372?v=4)](https://github.com/markrogoyski "markrogoyski (83 commits)")[![meklis](https://avatars.githubusercontent.com/u/16430599?v=4)](https://github.com/meklis "meklis (2 commits)")[![jfillmor](https://avatars.githubusercontent.com/u/42222404?v=4)](https://github.com/jfillmor "jfillmor (1 commits)")[![rafihm](https://avatars.githubusercontent.com/u/34249562?v=4)](https://github.com/rafihm "rafihm (1 commits)")[![tomothumb](https://avatars.githubusercontent.com/u/1335922?v=4)](https://github.com/tomothumb "tomothumb (1 commits)")

---

Tags

addressIPnetworkcalculatoripv4cidrsubnet

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/meklis-ipv4-subnet-calculator/health.svg)

```
[![Health](https://phpackages.com/badges/meklis-ipv4-subnet-calculator/health.svg)](https://phpackages.com/packages/meklis-ipv4-subnet-calculator)
```

###  Alternatives

[markrogoyski/ipv4-subnet-calculator

Network calculator for subnet mask and other classless (CIDR) network information.

175852.6k14](/packages/markrogoyski-ipv4-subnet-calculator)[mlocati/ip-lib

Handle IPv4, IPv6 addresses and ranges

3167.3M70](/packages/mlocati-ip-lib)[s1lentium/iptools

PHP Library for manipulating network addresses (IPv4 and IPv6)

2446.6M28](/packages/s1lentium-iptools)[jaaulde/php-ipv4

PHP classes for working with IPV4 addresses and networks.

1034.8k](/packages/jaaulde-php-ipv4)[longman/ip-tools

PHP IP Tools for manipulation with IPv4 and IPv6

147256.8k7](/packages/longman-ip-tools)[kigkonsult/iptools

ipv4/ipv6 tools

1183.1k](/packages/kigkonsult-iptools)

PHPackages © 2026

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