bentools/hostname-extractor

Hostname extractor - A library to find parts of a hostname (suffix, tld, subdomain, ...)

, _(*1)

Hostname Extractor

A simple library to manipulate domains., _(*2)

Usage

require_once __DIR__ . '/vendor/autoload.php';

use BenTools\HostnameExtractor\HostnameExtractor;
use BenTools\HostnameExtractor\SuffixProvider\PublicSuffixProvider;

$extractor = new HostnameExtractor(new PublicSuffixProvider());
$hostname = $extractor->extract('my.preferred.domain.co.uk');
dump($hostname->getSubdomain()); // my.preferred
dump($hostname->getDomain()); // domain
dump($hostname->getSuffix()); // co.uk
dump($hostname->getTld()); // uk
dump($hostname->getSuffixedDomain()); // domain.co.uk
dump($hostname->isIp()); // false
dump($hostname->isIpv4()); // false
dump($hostname->isIpv6()); // false

As you can see, co.uk is considered as a suffix (otherwise, we would have considered that co is the domain and uk the suffix / tld)., _(*3)

The library parses the Public Suffix List, which stores thousands of existing suffixes., _(*4)

To avoid network latency feel free to implement your own BenTools\HostnameExtractor\SuffixProvider\SuffixProviderInterface or to use your favorite PSR-16 library into a BenTools\HostnameExtractor\SuffixProvider\PSR16CacheSuffixProvider object., _(*5)

Installation

PHP 7.1+ with mbstring extension is required., _(*6)

composer require bentools/hostname-extractor ^1.0, _(*7)

Tests

./vendor/bin/phpunit, _(*8)

License

MIT., _(*9)

See also

bentools/querystring - Easily manipulate your query strings., _(*10)

bentools/uri-factory - PSR-7 UriInterface factory with multiple libaries support., _(*11)