PHP-IPAddress

A set of utility classes for working with IP addresses in PHP. Supports both IPv4 and IPv6 schemes.

Requirements

• PHP version 5.3.0 or greater.
• (optional) The PEAR Math_BigInteger class.

  •   Required for add & subtract operations on IPv6 addresses, and finding IPs in IPv6 address blocks.
    

Examples

<?php
// Creates an instance
$ip = IP_Address::factory('127.0.0.1');

// Prints "127.0.0.1"
echo $ip . "\n";

/**
 * IP_Address::factory(...) will attempt to guess the address version from the arguments 
 */
// Returns an instance of IPv4Address
$ip = IP_Address::factory('127.0.0.1');
$ip = IPv4Address::factory('127.0.0.1');

// Returns an instance of IPv6Address
$ip = IP_Address::factory('::1');
$ip = IPv6_Address::factory('::1');

/**
 * IP_Network_Address::factory(...) will also attempt to guess protocol versions
 */
// Can either be called with the subnet size encoded in the address string,
$net_addr = IP_Network_Address::factory('192.168.0.1/24');
// Or as the second parameter
$net_addr = IP_Network_Address::factory('192.168.0.1', 24);

// Prints '192.168.0.0'
echo $net_addr->get_network_address() . "\n";
// Prints '192.168.0.255'
echo $net_addr->get_broadcast_address() . "\n";
// Prints '255.255.255.0'
echo $net_addr->get_subnet_mask() . "\n";

Test Cases

To run the test cases, the following commands will do the trick:

• No-frills tests

  phpunit --bootstrap tests/bootstrap.php tests

• Generate code coverage reports to 'phpunit/coverage/'

  phpunit --bootstrap tests/bootstrap.php --coverage-html phpunit/coverage/ tests

• With colours and verbose output

  phpunit --bootstrap tests/bootstrap.php --colors --verbose tests

• All togeather

  phpunit --bootstrap tests/bootstrap.php --coverage-html phpunit/coverage/ --colors --verbose tests