Download the PHP package layershifter/tld-extract without Composer
On this page you can find all versions of the php package layershifter/tld-extract. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download layershifter/tld-extract
More information about layershifter/tld-extract
Files in layershifter/tld-extract
Package tld-extract
Short Description TLDExtract, library for extracting parts of domain, e.q. domain parser
License Apache-2.0
Informations about the package tld-extract
DEPRECATED
Consider to use https://github.com/jeremykendall/php-domain-parser as maintained alternative.
TLDExtract
TLDExtract
accurately separates the gTLD or ccTLD (generic or country code top-level domain) from the registered domain and subdomains of a URL, e.g. domain parser. For example, say you want just the 'google' part of 'http://www.google.com'.
Everybody gets this wrong. Splitting on the '.' and taking the last 2 elements goes a long way only if you're thinking of simple e.g. .com domains. Think parsing http://forums.bbc.co.uk for example: the naive splitting method above will give you 'co' as the domain and 'uk' as the TLD, instead of 'bbc' and 'co.uk' respectively.
TLDExtract
on the other hand knows what all gTLDs and ccTLDs look like by looking up the currently living ones according to the Public Suffix List. So, given a URL, it knows its subdomain from its domain, and its domain from its country code.
Result
implements ArrayAccess interface, so you simple can access to its result.
Also you can simply convert result to JSON.
This package is compliant with PSR-1, PSR-2, PSR-4. If you notice compliance oversights, please send a patch via pull request.
Does TLDExtract make requests to Public Suffix List website?
No. TLDExtract
uses database from TLDDatabase that generated from Public Suffix List and updated regularly. It does not make any HTTP requests to parse or validate a domain.
Requirements
The following versions of PHP are supported.
- PHP 5.5
- PHP 5.6
- PHP 7.0
- PHP 7.1
- PHP 7.2
- PHP 7.3
- HHVM
Install
Via Composer
Additional result methods
Class LayerShifter\TLDExtract\Result
has some usable methods:
Custom database
By default package is using database from TLDDatabase package, but you can override this behaviour simply:
For more details and how keep database updated TLDDatabase.
Implement own result
By default after parse you will receive object of LayerShifter\TLDExtract\Result
class, but sometime you need own methods or additional functionality.
You can create own class that implements LayerShifter\TLDExtract\ResultInterface
and use it as parse result.
Parsing modes
Package has three modes of parsing:
- allow ICANN suffixes (domains are those delegated by ICANN or part of the IANA root zone database);
- allow private domains (domains are amendments submitted to Public Suffix List by the domain holder, as an expression of how they operate their domain security policy);
- allow custom (domains that are not in list, but can be usable, for example: example, mycompany, etc).
For keeping compatibility with Public Suffix List ideas package runs in all these modes by default, but you can easily change this behavior:
Change log
Please see CHANGELOG for more information what has changed recently.
Testing
Contributing
Please see CONDUCT for details.
License
This library is released under the Apache 2.0 license. Please see License File for more information.
All versions of tld-extract with dependencies
layershifter/tld-database Version ^1.0
layershifter/tld-support Version ^1.1
symfony/polyfill-intl-idn Version ^1.10