Utopia Domains library is a simple and lite library for parsing domain names structure. This library is aiming to be as simple and easy to learn and use.
Although this library is part of the Utopia Framework project, it is completely dependency-free and can be used as standalone with any other PHP project or framework.
Install using composer:
composer require utopia-php/domains
<?php
require_once '../vendor/autoload.php';
use Utopia\Domains\Domain;
// demo.example.co.uk
$domain = new Domain('demo.example.co.uk');
$domain->get(); // demo.example.co.uk
$domain->getTLD(); // uk
$domain->getSuffix(); // co.uk
$domain->getRegisterable(); // example.co.uk
$domain->getName(); // example
$domain->getSub(); // demo
$domain->isKnown(); // true
$domain->isICANN(); // true
$domain->isPrivate(); // false
$domain->isTest(); // false
// demo.localhost
$domain = new Domain('demo.localhost');
$domain->get(); // demo.localhost
$domain->getTLD(); // localhost
$domain->getSuffix(); // ''
$domain->getRegisterable(); // ''
$domain->getName(); // demo
$domain->getSub(); // ''
$domain->isKnown(); // false
$domain->isICANN(); // false
$domain->isPrivate(); // false
$domain->isTest(); // true
Utopia Domains parser uses a public suffix PHP dataset auto-generated from the publicsuffix.org. The dataset get periodically updates from us, but you can also manually update it by cloning this library and running the import script with the import command:
php ./data/import.php
- get() - Return you full domain name.
- getTLD() - Return only the top-level-domain.
- getSuffix() - Return only the public suffix of your domain, for example: co.uk, ac.be, org.il, com, org.
- getRegisterable() - Return the registered or registrable domain, which is the public suffix plus one additional label.
- getName() - Returns only the regiterable domain name. For example, blog.example.com will return 'example', and demo.co.uk will return 'demo'.
- getSub() - Returns the full sub domain path for you domain. For example, blog.example.com will return 'blog', and subdomain.demo.co.uk will return 'subdomain.demo'.
- isKnown() - Returns true if public suffix is know and false otherwise.
- isICANN() - Returns true if the public suffix is found in the ICANN DOMAINS section of the public suffix list.
- isPrivate() - Returns true if the public suffix is found in the PRIVATE DOMAINS section of the public suffix list.
- isTest() - Returns true if the domain TLD is 'locahost' or 'test' and false otherwise.
Utopia Framework requires PHP 7.1 or later. We recommend using the latest PHP version whenever possible.
Eldad Fux
The MIT License (MIT) http://www.opensource.org/licenses/mit-license.php