This package is abandoned and no longer maintained. The author suggests using the league/iso3166 package instead.

ISO 3166-1 PHP Library

4.1.0 2016-04-22 22:49 UTC

This package is auto-updated.

Last update: 2022-02-01 12:34:14 UTC


A PHP library providing ISO 3166-1 data.

Build Status License

Deprecated (2016/06/30)

This project has been superseded by league/iso3166.

What is ISO 3166-1

ISO 3166-1 is part of the ISO 3166 standard published by the International Organization for Standardization (ISO), and defines codes for the names of countries, dependent territories, and special areas of geographical interest. The official name of the standard is Codes for the representation of names of countries and their subdivisions – Part 1: Country codes. It defines three sets of country codes:

  • ISO 3166-1 alpha-2 – two-letter country codes which are the most widely used of the three, and used most prominently for the Internet's country code top-level domains (with a few exceptions).
  • ISO 3166-1 alpha-3 – three-letter country codes which allow a better visual association between the codes and the country names than the alpha-2 codes.
  • ISO 3166-1 numeric – three-digit country codes which are identical to those developed and maintained by the United Nations Statistics Division, with the advantage of script (writing system) independence, and hence useful for people or systems using non-Latin scripts.

-- Wikipedia


$ composer require alcohol/iso3166




use Alcohol\ISO3166\ISO3166;

$iso3166 = new ISO3166();

// methods defined by interface Alcohol\ISO3166\DataProvider

// methods provided for convenience
foreach ($iso3166 as $key => $value) {
    // simple iterator implementation using a generator (uses alpha2 for keys)
foreach ($iso3166->listBy(ISO3166::KEY_ALPHA3) as $key => $value) {
    // use a specific generator to iterate using other available keys
    // constants available are KEY_ALPHA2, KEY_ALPHA3, KEY_NUMERIC

The data returned is in the format of:

    [name] => Netherlands
    [alpha2] => NL
    [alpha3] => NLD
    [numeric] => 528
    [currency] => EUR


Feel free to submit a pull request or create an issue.


alcohol/iso3166 is licensed under the MIT license.