Download the PHP package dxw/cidr without Composer
On this page you can find all versions of the php package dxw/cidr. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Package cidr
Short Description IP address matching with CIDR ranges
License MIT
Homepage https://github.com/dxw/cidr
Informations about the package cidr
cidr
PHP library for matching an IP address to a CIDR range.
Supports IPv4 and IPv6.
Installation
composer require dxw/cidr
Usage
To simply match two addresses:
$result = \Dxw\CIDR\IP::contains('2001:db8:123::/64', '2001:db8:123::42');
if ($result->isErr()) {
// handle the error
}
$match = $result->unwrap();
if ($match) {
echo "The addresses match!\n";
} else {
echo "The addresses don't match.\n";
}
Notes
IPv4-compatible IPv6 addresses and IPv4-mapped IPv6 addresses are partially supported.
An address of the form ::127.0.0.1
or ::ffff:127.0.0.1
will be parsed. But only if they fall within ::/96
or ::ffff:0:0/96
. For example, 2001:db8::127.0.0.1
will be rejected.
But the resulting address will be treated as an IPv6 and as such it will never match an IPv4 address. For example, 127.0.0.1
will never match ::ffff:127.0.0.1
or ::127.0.0.1
.
API
Example of testing if an IPv6 address falls within a particular IPv6 range:
$result = \Dxw\CIDR\IPv6Range::Make('2001:db8:123::/64');
if ($result->isErr()) {
// handle the error
}
$range = $result->unwrap();
$result = \Dxw\CIDR\IPv6Address::Make('2001:db8:123::42');
if ($result->isErr()) {
// handle the error
}
$address = $result->unwrap();
if ($range->containsAddress($address)) {
echo "It matches!\n";
} else {
echo "It doesn't match.\n";
}
To make the example IPv4-only, replace IPv6
with IPv4
. To make the example version agnostic, replace IPv6
with just IP
.
IP
::contains(string $addressOrRange, string $address): \Dxw\Result\Result<bool>
IPAddress
::Make(string $address): \Dxw\Result\Result<AddressBase>
(AddressBase
is the abstract superclass ofIPv4Address
andIPv6Address
)
IPRange
::Make(string $range): \Dxw\Result\Result<RangeBase>
(RangeBase
is the abstract superclass ofIPv4Range
andIPv6Range
)
IPv4Address
::Make(string $address): \Dxw\Result\Result<IPv4Address>
::FromBinary(\phpseclib\Math\BigInteger $binary): \Dxw\Result\Result<IPv4Address>
->__toString(): string
->getBinary(): \phpseclib\Math\BigInteger
IPv6Address
::Make(string $address): \Dxw\Result\Result<IPv6Address>
::FromBinary(\phpseclib\Math\BigInteger $binary): \Dxw\Result\Result<IPv6Address>
->__toString(): string
->getBinary(): \phpseclib\Math\BigInteger
IPv4Block
::Make(int $value): \Dxw\Result\Result<IPv4Block>
->__toString(): string
->getValue(): int
->getNetmask(): \phpseclib\Math\BigInteger
IPv6Block
::Make(int $value): \Dxw\Result\Result<IPv6Block>
->__toString(): string
->getValue(): int
->getNetmask(): \phpseclib\Math\BigInteger
IPv4Range
::Make(string $range): \Dxw\Result\Result<IPv4Range>
->__toString(): string
->getAddress(): \Dxw\CIDR\IPv4Address
->getBlock(): \Dxw\CIDR\IPv4Block
->containsAddress(\Dxw\CIDR\AddressBase $address): bool
IPv6Range
::Make(string $range): \Dxw\Result\Result<IPv6Range>
->__toString(): string
->getAddress(): \Dxw\CIDR\IPv6Address
->getBlock(): \Dxw\CIDR\IPv6Block
->containsAddress(\Dxw\CIDR\AddressBase $address): bool