Hampel Validator

Simple validator library composer package

By Simon Hampel

Requirements

PHP 8.3 or later, and the filter extension. No framework, and no runtime dependencies.

Installation

The recommended way of installing Hampel Validator is through Composer:

composer require hampel/validate

Usage

Every method takes any value — null, an integer and a Stringable object are all accepted — and returns a strict boolean.

use Hampel\Validate\Validator;

$validator = new Validator();

var_dump($validator->isBool("1")); // bool(true)

isEmail returns true for validly formed email addresses

isBool returns true for "1", "true", "on" and "yes", "0", "false", "off", "no", and "", and NULL ... and returns false for any other value

// the following all evaluate to boolean true
$validator->isBool(true);
$validator->isBool(1);
$validator->isBool("on");
$validator->isBool("yes");
$validator->isBool(false);
$validator->isBool(0);
$validator->isBool("off");
$validator->isBool("no");
$validator->isBool("");
$validator->isBool(null);

// the following will evaluate to boolean false (ie not valid boolean values)
$validator->isBool("foo");
$validator->isBool(2);

isIpv4 returns true for any valid IPv4 address, including private and reserved addresses

// the following all evaluate to true
$validator->isIpv4("0.0.0.0");
$validator->isIpv4("1.1.1.1");
$validator->isIpv4("10.0.0.1");
$validator->isIpv4("192.168.0.1");
$validator->isIpv4("255.255.255.255");

isPublicIpv4 returns true for valid IPv4 addresses which are not in the private or reserved ranges

// the following evaluate to true
$validator->isPublicIpv4("1.1.1.1");
$validator->isPublicIpv4("74.125.237.2");

// the following evaluate to false
$validator->isPublicIpv4("0.0.0.0");
$validator->isPublicIpv4("10.0.0.1");
$validator->isPublicIpv4("192.168.0.1");

isIpv6 returns true for any valid IPv6 address, including private and reserved addresses

isPublicIpv6 returns true for valid IPv6 addresses which are not considered non-routable

// the following evaluate to true
$validator->isPublicIpv6("2606:4700:4700::1111");

// the following evaluate to false
$validator->isPublicIpv6("::1"); // reserved
$validator->isPublicIpv6("fd01:db8::ff00:42:8329"); // private range
$validator->isPublicIpv6("2001:db8::ff00:42:8329"); // reserved for documentation

The documentation range 2001:db8::/32 is rejected by this library rather than by filter_var, which stopped treating it as reserved in PHP 8.3. The answer is therefore the same on every supported PHP version.

isIp returns true for any valid IPv4 or IPv6 address

isPublicIp returns true for any public IPv4 or IPv6 address

isDomain returns true for any validly constructed domain name, including internationalisation in punycode notation

// the following evaluate to true
$validator->isDomain("example.com");
$validator->isDomain("www.example.com.au");
$validator->isDomain("www-2.example.com");
$validator->isDomain("example.foo"); // valid because we don't perform strict checking of TLDs

// the following evaluate to false
$validator->isDomain("example_1.com"); // underscores not allowed
$validator->isDomain("example."); // no TLD
$validator->isDomain("example"); // no TLD

// Supply an array of TLDs to validate against for more strict validation
$tlds = ['com', 'au', 'travel', 'xn--3e0b707e'];

$validator->isDomain('example.com', $tlds); // true
$validator->isDomain('example.foo', $tlds); // false

isTld returns true for any valid TLD when compared to the list of TLDs passed to the function in an array

You may pass a full domain and isTld will check that the TLD extension is valid (but will not validate the domain itself)

// Supply an array of TLDs to validate against for more strict validation
$tlds = ['com', 'au', 'travel', 'xn--3e0b707e'];

$validator->isTld('com', $tlds); // true
$validator->isTld('.com', $tlds); // true
$validator->isTld('example.com', $tlds); // true
$validator->isTld('---.com', $tlds); // true, since we don't validate the domain itself

$validator->isDomain('---.com', $tlds); // false, validates both domain and TLD
$validator->isDomain('foo', $tlds); // false
$validator->isDomain('example.foo', $tlds); // false

Notes

No TLD list ships with this package. Pass your own array of lowercase TLDs to isDomain() and isTld(), or pass nothing and get structural validation only.

If using Laravel, we recommend installing the "hampel/tlds" package, which uses this package and also supplies a simple mechanism for retrieving (and optionally caching) the TLD list directly from IANA or other sources. The TLDs package also extends the Laravel validation service with additional rules for validating domain names and TLDs.