league/iso3166
ISO 3166-1 PHP Library
4.4.0
40M downloads/mo
#790 most downloaded on Packagist
alcohol/iso3166
What this package is like to depend on
Last release 7 months ago
02 Jan 2026
Ships fairly regularly
a new release about every 7 months
Nearly every release is documented
notes for 18 of 20 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
20 releases · first in 2016
1 release in the last 12 months
see the full history below
Release timeline
20 releases · Jun 2016 to Jan 2026Releases
latest 20-
4.4.002 Jan 2026Release notes
Open source →What's Changed
- docs: Added throws PHPDoc tags in ISO3166 by @florentausha in #119
- Update Bulgaria currency: from BGN to EUR since 01/01/2026 by @julien-langlois in #121
New Contributors
- @florentausha made their first contribution in #119
- @julien-langlois made their first contribution in #121
Full Changelog: 4.3.3...4.4.0
-
4.3.305 Jun 2025Nothing published for this version
-
4.3.210 Oct 2024Release notes
Open source →What's Changed
- Bump actions/checkout from 3 to 4 by @dependabot in #98
- Bump codecov/codecov-action from 3 to 4 by @dependabot in #99
- Update ISO3166.php - add Kosovo by @EnterVPL in #109
New Contributors
- @dependabot made their first contribution in #98
- @EnterVPL made their first contribution in #109
Full Changelog: 4.3.1...4.3.2
Release notes
Open source →- Updated: added XK for Kosovo ([#101])
- Changed: added types for private properties
-
4.3.111 Sep 2023 -
4.3.005 Jun 2023Release notes
Open source →What's Changed
- Added multibyte string extension to the composer requirements. by @alexandrmazur96 in #93
- Implement exact-match name method for country search by @tomSasaki in #95
New Contributors
- @alexandrmazur96 made their first contribution in #93
- @tomSasaki made their first contribution in #95
Full Changelog: 4.2.1...4.3.0
-
4.2.131 Jan 2023 -
4.2.023 Jan 2023Release notes
Open source →What's Changed
- Update .gitattributes by @bytestream in #81
- run ci with php 8.2 by @Nielsvanpach in #84
- Added aliases by @8ctopus in #76
New Contributors
Full Changelog: 4.1.0...4.2.0
-
4.1.007 Sep 2022Release notes
Open source →Release notes
Open source →- Changed: lookup is now unicode-safe ([#78]) and allows partial (prefix) matches ([#74])
-
4.0.022 Oct 2021 -
3.0.005 Dec 2020 -
2.1.529 Jan 2020 -
2.1.423 Oct 2019 -
2.1.325 Sep 2019 -
2.1.214 Mar 2019 -
2.1.117 Jul 2018 -
2.1.002 Jan 2018 -
2.0.011 May 2017Release notes
Open source →- Changed: renamed
getBy<Identifier>methods to<identifier>([#29]). - Changed: renamed
getAlltoall([#29]). - Changed: renamed
listBytoiterator([#29]). - Changed:
ISO3166andDataValidatorare nowfinal([#24]). - Changed: support for PHP 5.5.x has been dropped ([#23]).
- Changed:
get()method has been removed ([#19]). - Changed:
currencykey in default dataset entries is now always an array ([#15]). - New:
ISO3166now implementsCountableinterface ([#18]). - New: can now replace default dataset by injecting a new one into
ISO3166through the constructor ([#18]). - New:
getBy[Alpha2,Alpha3,Numeric]now throwInvalidArgumentExceptionif anything other than a string is passed in ([#18]).
- Changed: renamed
-
1.0.207 Feb 2017Nothing published for this version
-
1.0.101 Jul 2016Release notes
Open source →- Changed: updated Antarctica currencies ([#6]).
- Deprecated: the
get()method has been deprecated and will be removed in a future release ([#12]).
-
1.0.030 Jun 2016