NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #793 most downloaded on Packagist
ISO 3166-1 PHP Library
Latest stable
4.7.1
Last release 20 days ago
02 Nov 2026
Ships fairly regularly
a new release about every 7 months
Nearly every release is documented
notes for 24 of 25 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
25 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Reject codes with a trailing newline by @alcohol in https://github.com/alcohol/iso3166/pull/135
Full Changelog: https://github.com/alcohol/iso3166/compare/4.7.0...4.7.1
alpha2(), alpha3() and numeric() now reject input with a trailing newline (e.g. "NL\n") with a DomainException instead of reporting it as not found ([#135])Fix currency data (#130) by @alcohol in https://github.com/alcohol/iso3166/pull/133
Full Changelog: https://github.com/alcohol/iso3166/compare/4.6.0...4.7.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Nauru alias for Naoero in ISO3166WithAliasesBump symfony/process from 7.3.4 to 7.4.5 in /tools/php-cs-fixer by @dependabot[bot] in https://github.com/alcohol/iso3166/pull/124
Full Changelog: https://github.com/alcohol/iso3166/compare/4.5.1...4.6.0
League\ISO3166\Exception marker interface, implemented by every exception thrown by this libraryLeague\ISO3166\Exception\ISO3166Exception, catch League\ISO3166\Exception instead (it will be removed in 5.0)Guards assertions (non-empty-string / numeric-string) and iterator generics@PER-CS instead of @PSR2main and on pull requests, with read-only permissions, concurrency, composer validate and a single coverage upload; dropped the prefer-lowest jobs (there are no runtime dependencies, so they only downgraded dev tools)dev-mainalcohol/iso3166 ([#131])Update CHANGELOG for version 4.5.0 by @alcohol in https://github.com/alcohol/iso3166/pull/128
Full Changelog: https://github.com/alcohol/iso3166/compare/4.5.0...4.5.1
Full Changelog: https://github.com/alcohol/iso3166/compare/4.4.0...4.5.0
Full Changelog: https://github.com/alcohol/iso3166/compare/4.4.0...4.5.0
docs: Added throws PHPDoc tags in ISO3166 by @florentausha in https://github.com/alcohol/iso3166/pull/119
Full Changelog: https://github.com/alcohol/iso3166/compare/4.3.3...4.4.0
@throws PHPDoc tags ([#119])Fixed: Turkey spelling ([#116])
Bump actions/checkout from 3 to 4 by @dependabot in https://github.com/alcohol/iso3166/pull/98
Full Changelog: https://github.com/alcohol/iso3166/compare/4.3.1...4.3.2
Add an alias for The Democratic Republic of the Congo by @8ctopus in https://github.com/thephpleague/iso3166/pull/96
Full Changelog: https://github.com/thephpleague/iso3166/compare/4.3.0...4.3.1
Added multibyte string extension to the composer requirements. by @alexandrmazur96 in https://github.com/thephpleague/iso3166/pull/93
Full Changelog: https://github.com/thephpleague/iso3166/compare/4.2.1...4.3.0
Cleanup unused uses by @8ctopus in https://github.com/thephpleague/iso3166/pull/88
Full Changelog: https://github.com/thephpleague/iso3166/compare/4.2.0...4.2.1
Update .gitattributes by @bytestream in https://github.com/thephpleague/iso3166/pull/81
Full Changelog: https://github.com/thephpleague/iso3166/compare/4.1.0...4.2.0
Changed: Lookup is now unicode-safe (#78) and allows partial (prefix) matches
- Changed: Added return types
Deprecated: dropped support for PHP < 7.3
Changed: added a common ISO3166Exception interface (#53).
Changed: update currency for Estonia to EUR
Changed: update currency for Latvia to EUR
Changed: update short names of Eswatini and Macedonia.
Changed: Swaziland was renamed to Eswatini.
New: can now lookup by name (#44).
name (#44).Changed: renamed getBy methods to (#29).
getBy<Identifier> methods to <identifier> (#29).getAll to all (#29).listBy to iterator (#29).ISO3166 and DataValidator are now final (#24).get() method has been removed (#19).currency key in default dataset entries is now always an array (#15).ISO3166 now implements Countable interface (#18).ISO3166 through the constructor (#18).getBy[Alpha2,Alpha3,Numeric] now throw InvalidArgumentException if anything other than a string is passed in (#18).Nothing published for this version
Deprecated: the get() method has been deprecated and will be removed in a future release ([#12]).
get() method has been deprecated and will be removed in a future release ([#12]).New: initial release of league/iso3166.
league/iso3166.One column per quarter.