Top Level Domain (TLD) validation library for PHP

1.2.103 2021-11-21 04:01 UTC


Latest Version on Packagist Build Status Codecov Quality Score Total Downloads

This package allows validation of top level domains against the official The DNS Root Zone database from
Use this to validate e.g. domains or email addresses.

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.

The database is stored locally and automatically updated for new database versions.


Install this package via composer:

composer require arubacao/tld-checker


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.)

// config/app.php

'providers' => [
    // Other Service Providers


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


Check a TLD using Validator::isTld():

use Arubacao\TldChecker\Validator;

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

Check if a string ends with a valid TLD using Validator::endsWithTld():

use Arubacao\TldChecker\Validator;

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

This package extends the Laravel Validator with these 2 methods:

  • is_tld
  • ends_with_tld

Use them as follows:

    'tld' => 'required|is_tld',
    'email' => 'required|ends_with_tld'


composer test


Please see CONTRIBUTING for details.



The MIT License (MIT). Please see License File for more information.