arubacao/tld-checker

Top Level Domain (TLD) validation library for PHP

Top Level Domain (TLD) validation library for PHP

, _(*1)

This package allows validation of top level domains against the official The DNS Root Zone database from iana.org.
Use this to validate e.g. domains or email addresses., _(*2)

The DNS Root Zone is the upper-most part of the DNS hierarchy, and involves delegating administrative responsibility of “top-level domains”, which are the last segment of a domain name, such as .com, .uk and .nz., _(*3)

The database is stored locally and automatically updated for new database versions., _(*4)

Installation

Install this package via composer:, _(*5)

composer require arubacao/tld-checker

Laravel

If you would like to use arubacao/tld-checker with the Laravel Validator, you must also register the service provider:
(only required for Laravel <=5.4, for Laravel >=5.5 auto-discovery is enabled.), _(*6)

// config/app.php

'providers' => [
    // Other Service Providers
    Arubacao\TldChecker\TldCheckerServiceProvider::class,
],

Notes:, _(*7)

• arubacao/tld-checker is functional and fully tested for PHP 7.0 - 8.0 & Laravel 5.0 - 8.x.

Usage

Check a TLD using Validator::isTld(): ``` php use Arubacao\TldChecker\Validator;, _(*8)

Validator::isTld('com'); // true Validator::isTld('CN'); // true (case insensitiv) Validator::isTld('москва'); // true (works with internationalized domain name (IDN) | unicode) Validator::isTld('XN--CZRS0T'); // true (works with encoded IDN | 商店) Validator::isTld('.org'); // true (allows dot prefix) Validator::isTld('apricot'); // false, _(*9)

Check if a string ends with a valid TLD using `Validator::endsWithTld()`:
``` php
use Arubacao\TldChecker\Validator;

Validator::endsWithTld('apple.com');                            // true
Validator::endsWithTld('NEWS.CN');                              // true (case insensitiv)
Validator::endsWithTld('müller.vermögensberater');              // true (works with internationalized domain name (IDN) | unicode)
Validator::endsWithTld('xn--mller-kva.xn--vermgensberater-ctb');// true (works with encoded IDN | müller.vermögensberater)
Validator::endsWithTld('farming.apricot');                      // false

This package extends the Laravel Validator with these 2 methods:, _(*10)

• is_tld
• ends_with_tld

Use them as follows:, _(*11)

$request->validate([
    'tld' => 'required|is_tld',
    'email' => 'required|ends_with_tld'
]);

Testing

bash composer test, _(*12)

Contributing

Please see CONTRIBUTING for details., _(*13)

Credits

• Christopher Lass
• All Contributors

License

The MIT License (MIT). Please see License File for more information., _(*14)