jonasraoni/tld-to-iso

Maps top level domains (TLD) against countries using the ISO 3166-1 alpha-2 format and vice-versa.

Maintainers

Details

github.com/jonasraoni/tld-to-iso

Homepage

Source

Issues

Installs: 17

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 1

Forks: 0

Open Issues: 0

pkg:composer/jonasraoni/tld-to-iso

1.0.0 2021-07-17 07:38 UTC

Requires

  • php: >=7.2.0

MIT 847897d511933f9f144d8e7dd4482576f3be0cec

mappingcountrytldIso3166

This package is auto-updated.

Last update: 2025-10-17 17:09:50 UTC

README

Mappings from top level domains (TLDs) to ISO 3166-1 alpha-2 and vice-versa.

Usage

Install the package:

composer require jonasraoni/tld-to-iso

The package provides 2 separated mappings (just to decrease the amount of processing/bloat data loaded into memory):

Choose the one that fits your needs and call the static method get, it might return the right mapping or null if it's invalid.

use JonasRaoni\TldToIso\TldToIso;

echo 'UK = ' . TldToIso::get('UK');

Data Generation

To regenerate the classes, ensure the submodules are updated, then call the build.php script (just a simple code generator) and it will overwrite the existing classes.

Data Source

  • The list of countries/TLDs was retrieved from this link: https://datahub.io/core/country-codes (the .csv is linked to this repository as a submodule). The list isn't complete, as it's missing IDN entries (e.g. .рф) and custom domains (e.g. .barcelona), but let it be... The Wikipedia's entry looks more complete, but I'll be unable to keep it synchronized.