NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #2629 most downloaded on Packagist
A collection of standards as PHP Enums: ISO3166, ISO4217, ISO639...
Latest stable
v3.16.8
Last release 3 months ago
17 Aug 2026
Ships fairly regularly
a new release about every 4 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
4 years old
67 releases · first in 2022
Drag across the ruler to compare, or tap a release to open it.
This package reached 1 million downloads!
This package reached 1 million downloads!
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates regardless, but sponsorships help cover the time it takes to review changes and keep everything accurate.
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.7...v3.16.8
This package reached 1 million downloads!
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates regardless, but sponsorships help cover the time it takes to review changes and keep everything accurate.
Full Changelog: v3.16.7...v3.16.8
Your coding agent can read these notes before it upgrades. Set up the MCP server →
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates rega
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates regardless, but sponsorships help cover the time it takes to review changes and keep everything accurate.
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.6...v3.16.7
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates regardless, but sponsorships help cover the time it takes to review changes and keep everything accurate.
Full Changelog: v3.16.6...v3.16.7
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates rega
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates regardless, but sponsorships help cover the time it takes to review changes and keep everything accurate.
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.5...v3.16.6
If you depend on this package and want to support its maintenance, please consider sponsoring me. I'll continue maintaining and releasing updates regardless, but sponsorships help cover the time it takes to review changes and keep everything accurate.
Full Changelog: v3.16.5...v3.16.6
Automatic uri-scheme spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/380
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.4...v3.16.5
Full Changelog: v3.16.4...v3.16.5
Automatic uri-scheme spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/379
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.3...v3.16.4
Full Changelog: v3.16.3...v3.16.4
Automatic language-extensive spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/375
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.2...v3.16.3
This package is actively maintained. 💖 Sponsorship helps support ongoing maintenance and review of upstream changes.
Full Changelog: v3.16.2...v3.16.3
This package is actively maintained. 💖 Sponsorship helps support ongoing maintenance and review of upstream changes.
Automatic language-subtag spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/370
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.1...v3.16.2
Automatic language-extensive spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/364
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.16.0...v3.16.1
Full Changelog: v3.16.0...v3.16.1
Upgrade from PSR12 to PER3 by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/357
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.15.0...v3.16.0
Full Changelog: v3.15.0...v3.16.0
Automatic uri-scheme spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/356
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.14.1...v3.15.0
Full Changelog: v3.14.1...v3.15.0
Automatic http-methods spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/351
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.14.0...v3.14.1
Automatic tld spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/344
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.13.5...v3.14.0
Automatic language-extensive spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/340
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.13.4...v3.13.5
Automatic uri-scheme spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/338
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.13.3...v3.13.4
Automatic uri-scheme spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/336
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.13.2...v3.13.3
Automatic http-status-codes spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/334
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.13.1...v3.13.2
Bump actions/checkout from 4 to 5 by @dependabot[bot] in https://github.com/PrinsFrank/standards/pull/333
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.13.0...v3.13.1
Automatic tld spec update by @github-actions[bot] in https://github.com/PrinsFrank/standards/pull/315
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.12.3...v3.13.0
Fix currency spec update Arab Accounting Dinar by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/314
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.12.2...v3.12.3
Automatic language-extensive spec update by @github-actions in https://github.com/PrinsFrank/standards/pull/307
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.12.1...v3.12.2
Automatic currency spec update by @github-actions in https://github.com/PrinsFrank/standards/pull/302
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.12...v3.12.1
Add several ancient egyption language codes to LanguageTagVariant by @github-actions in https://github.com/PrinsFrank/standards/pull/294
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.11.4...v3.11.5
Do not export editorconfig by @szepeviktor in https://github.com/PrinsFrank/standards/pull/286
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.11.3...v3.11.4
Automatic scripts spec update by @github-actions in https://github.com/PrinsFrank/standards/pull/283
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.11.2...v3.11.3
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.11.1...v3.11.2
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.11.1...v3.11.2
Add Allattaasitaamut to language-subtag spec update by @github-actions in https://github.com/PrinsFrank/standards/pull/278
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.11.0...v3.11.1
Automatic update: HTTP status code 104 (Upload Resumption Supported) added by @github-actions in https://github.com/PrinsFrank/standards/pull/273
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.10.4...v3.11.0
Add automatic spec update for EU by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/266
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.10.3...v3.10.4
Add Bulgaria and Romania as schengen members by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/264
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.10.2...v3.10.3
Gracefully handle language renames by mapping previous name to new name instead of deprecating old key and adding a new one by @PrinsFrank in https://…
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.10.1...v3.10.2
Zimbabwe dollar has been removed as currency (Replaced by Zimbabwe Gold) by @github-actions in https://github.com/PrinsFrank/standards/pull/249
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.10.0...v3.10.1
Add nameOrder specification by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/247
shaw got unassigned by @github-actions in https://github.com/PrinsFrank/standards/pull/245Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.9.0...v3.10.0
Implement country subdivisions by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/230
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.8...v3.9.0
Add missing currency symbol for zimbabwe gold by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/232
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.7...v3.8.8
Zimbabwe gold has been added to currency standard for Zimbabwe by @github-actions in https://github.com/PrinsFrank/standards/pull/229
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.6...v3.8.7
Automatic language-subtag spec update by @github-actions in https://github.com/PrinsFrank/standards/pull/227
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.5...v3.8.6
Automatic tld spec update by @github-actions in https://github.com/PrinsFrank/standards/pull/226
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.4...v3.8.5
This minor release adds missing @throws annotations for InvalidArgumentExceptions
This minor release adds missing @throws annotations for InvalidArgumentExceptions
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.3...v3.8.4
TLD Avianca is now unassigned by @github-actions in https://github.com/PrinsFrank/standards/pull/219
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.2...v3.8.3
Automatic tld spec update by @github-actions in https://github.com/PrinsFrank/standards/pull/217
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.1...v3.8.2
.comcast and .xfinity Top Level Domains are now not assigned;
.comcast and .xfinity Top Level Domains are now not assigned;
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.8.0...v3.8.1
Add top level domains by @szepeviktor and @PrinsFrank in https://github.com/PrinsFrank/standards/pull/171, https://github.com/PrinsFrank/standards/pul
There are 6 categories of Top Level Domains, and all of them have been introduced as seperate enums:
CountryCodeTLD::from('nl'); // CountryCodeTLD::nl
CountryCodeTLD::nl; // CountryCodeTLD::nl
CountryCodeTLD::from('nl')->value; // 'nl'
CountryCodeTLD::from('nl')->name; // 'nl'
CountryCodeTLD::from('nl')->isAssigned(); // true
CountryCodeTLD::from('nl')->getCountryAlpha2(); // CountryAlpha2::Netherlands
CountryCodeTLD::from('nl')->getCountryAlpha3(); // CountryAlpha3::Netherlands
CountryCodeTLD::from('nl')->getCountryNumeric(); // CountryNumeric::Netherlands
GenericRestrictedTLD::from('name'); // GenericRestrictedTLD::name
GenericRestrictedTLD::name; // GenericRestrictedTLD::name
GenericRestrictedTLD::from('name')->value; // 'name'
GenericRestrictedTLD::from('name')->name; // 'name'
GenericRestrictedTLD::from('name')->isAssigned(); // true
GenericTLD::from('aaa'); // GenericTLD::aaa
GenericTLD::aaa; // GenericTLD::aaa
GenericTLD::from('aaa')->value; // 'aaa'
GenericTLD::from('aaa')->name; // 'aaa'
GenericTLD::from('aaa')->isAssigned(); // true
InfrastructureTLD::from('arpa'); // InfrastructureTLD::arpa
InfrastructureTLD::arpa; // InfrastructureTLD::arpa
InfrastructureTLD::from('arpa')->value; // 'arpa'
InfrastructureTLD::from('arpa')->name; // 'arpa'
InfrastructureTLD::from('arpa')->isAssigned(); // true
SponsoredTLD::from('aero'); // SponsoredTLD::aero
SponsoredTLD::arpa; // SponsoredTLD::aero
SponsoredTLD::from('aero')->value; // 'aero'
SponsoredTLD::from('aero')->name; // 'aero'
SponsoredTLD::from('aero')->isAssigned(); // true
TestTLD::from('テスト'); // TestTLD::tesuto_katakana
TestTLD::tesuto_katakana; // TestTLD::tesuto_katakana
TestTLD::from('テスト')->value; // 'テスト'
TestTLD::from('テスト')->name; // 'tesuto_katakana'
TestTLD::from('テスト')->isAssigned() // false
It is now possible to retrieve the script(s) for a string:
ScriptAlias::allForString('еюeuеюευ'); // [ScriptAlias::Cyrillic, ScriptAlias::Greek, ScriptAlias::Latin]
ScriptAlias::hasMultipleForString('еюeuеюευ'); // true
ScriptAlias::mostCommonInString('еюeuеюευ'); // ScriptAlias::Cyrillic
ScriptCode::allForString('еюeuеюευ'); // [ScriptCode::Cyrillic, ScriptCode::Greek, ScriptCode::Latin]
ScriptCode::hasMultipleForString('еюeuеюευ'); // true
ScriptCode::mostCommonInString('еюeuеюευ'); // ScriptCode::Cyrillic
ScriptNumber::allForString('еюeuеюευ'); // [ScriptNumber::Cyrillic, ScriptAlias::Greek, ScriptAlias::Latin]
ScriptNumber::hasMultipleForString('еюeuеюευ'); // true
ScriptNumber::mostCommonInString('еюeuеюευ'); // ScriptNumber::Cyrillic
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.7.0...v3.8.0
Sierra Leone has finished currency transition: Sierra_Leone_Old is now deprecated and not returned by currencyForCountry by @github-actions in https:/…
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.6.0...v3.7.0
Allow configurable subtag separator when parsing from string or casting to string by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/125
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.5.0...v3.6.0
Add Stringable/__toString() to LanguageTags (Locales) by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/124
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.4.0...v3.5.0
Mark Name enums deprecated by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/122
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.3.0...v3.4.0
Add minor units to currency by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/101
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.2.0...v3.3.0
Add relationship between countries and currencies by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/100
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.1.0...v3.2.0
Add TravelDocuments Alpha2/Alpha3 UserAssigned country codes in new specfication by @rbiya in https://github.com/PrinsFrank/standards/pull/96
Full Changelog: https://github.com/PrinsFrank/standards/compare/v3.0.0...v3.1.0
Language tags have been added. It is possible to construct a language tag from seperate parts, but much more useful is the parsing of language tags fr
Language tags have been added. It is possible to construct a language tag from seperate parts, but much more useful is the parsing of language tags from strings:
+ LanguageTag::from('yue-HK'); // new LanguageTag(LanguageAlpha3Extensive::Yue_Chinese, regionSubtag: CountryAlpha2::Hong_Kong)
+ LanguageTag::from('yue-HK')->regionSubtag; // CountryAlpha2::Hong_Kong
+ new LanguageTag(LanguageAlpha3Extensive::Yue_Chinese, regionSubtag: CountryAlpha2::Hong_Kong);
If you have a country, it is now possible to get it's country calling prefix and the other way round:
+ CountryAlpha2::from('US')->getCountryCallingCodes(); // [CountryCallingCode::Integrated_numbering_plan]
+ CountryCallingCode::from(358)->getCountriesAlpha2(); // [CountryAlpha2::Finland, CountryAlpha2::Aland_Islands]
International call prefixes were already added, but the relation to specific countries was not there yet. In this release it is now possible to retrieve an international call prefix for a country and the other way round:
+ CountryAlpha2::from('NL')->getInternationalCallPrefix()->value; // '00'
+ InternationalCallPrefix::from('000')->getCountries(); // [CountryAlpha2::Kenya, CountryAlpha2::Singapore, CountryAlpha2::Tanzania, CountryAlpha2::Uganda]
With the introduction of language tags, it is now also possible to create a language tag instance from a language directly:
$language = LanguageAlpha3Terminology::from('nld')
+ $languageTag = $language->toLanguageTag();
This method has been added to LanguageAlpha2, LanguageAlpha3Bibliographic, LanguageAlpha3Terminology and LanguageAlpha3Extensive.
It is now possible to retrieve the country flag emoji from a country:
+ CountryAlpha3::from('NLD')->getFlagEmoji(); // '🇳🇱'
This might not be displayed correctly in these release notes if you're on windows, see https://prinsfrank.nl/2021/01/25/Non-existing-flag-emojis-on-windows to make these flag emojis visible for Windows users.
(See UPGRADING.md)
LanguageAlpha3Common contained all the cases that were present in both LanguageAlpha3Bibliographic and LanguageAlpha3Terminology. That resulted in complicated type hints. For the sake of simplicity these have now been merged. All the cases that were present in the LanguageAlpha3Common enum are now also present in the LanguageAlpha3Bibliographic and LanguageAlpha3Terminology enums, and the LanguageAlpha3Common class has been removed.
This change also results in the return types of the methods on language classes 'toLanguageAlpha3Terminology' changing from an intersection type with the common class to just an instance of LanguageAlpha3Terminology or null and the 'toLanguageAlpha3Bibliographic' changing from an intersection type with the common class to just an instance of LanguageAlpha3Bibliographic or null.
To process this change, simply remove all references to the following class:
- LanguageAlpha3Common
In the previous release 2.5.0, the naming for scriptCode and ScriptNumber were swapped. In this release the naming has been fixed. If you used any of these classes already, please swap them in your code as well:
- ScriptCode
+ ScriptName
- ScriptName
+ ScriptCode
A typo in the name of Global Mobile Satellite System has been fixed. If you were using the Global_Mobile_Satelite_System_shared_code case of CountryCallingCode as a hardcoded value in your codebase, you schould change it: (Note the extra letter 'l')
- CountryCallingCode::Global_Mobile_Satelite_System_shared_code;
+ CountryCallingCode::Global_Mobile_Satellite_System_shared_code;
These classes should not be used outside of this package, as the method signature might change between minor versions. As such, these classes are now marked internal. If you use the classes in your code you can continue to do so at your own risk, or you might want to remove their usages.
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.5.0...v3.0.0
Deprecate "unused" status code as multiple status codes are unused and it's not part of the spec by @PrinsFrank in https://github.com/PrinsFrank/stand…
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.4.0...v2.5.0
Add Geographic regions by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/68
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.3.0...v2.4.0
Introduce ISO-15924 Scripts by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/67
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.2.0...v2.3.0
Fix typos by @szepeviktor in https://github.com/PrinsFrank/standards/pull/64
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.1.0...v2.2.0
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.0.1...v2.1.0
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.0.1...v2.1.0
"Netherlands (the)" has been renamed to "Netherlands (Kingdom of the)" in the CountryName specification by @github-actions in https://github.com/Prins
"Netherlands (the)" has been renamed to "Netherlands (Kingdom of the)" in the CountryName specification by @github-actions in https://github.com/PrinsFrank/standards/pull/51
Full Changelog: https://github.com/PrinsFrank/standards/compare/v2.0.0...v2.0.1
As this package is getting adopted and more people start using it, I got some valid feedback on the readability of the standards in codebases.
As this package is getting adopted and more people start using it, I got some valid feedback on the readability of the standards in codebases.
This update solves both of these problems.
For an upgrade guide please check the UPGRADING.md in the root of this project.
Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.6.0...v2.0.0
…when used in code. As to not make any backwards incompatible changes, a new set of country code enums was added in the CountryCodeShort namespace that…
As the country code enums names are based on the actual country name, they can become quite long and decrease readability when used in code. As to not make any backwards incompatible changes, a new set of country code enums was added in the CountryCodeShort namespace that are optimised for use in code.
…specification package and will just be marked as deprecated.
As of today Croatia joined the Eurozone and Schengen area, and the country will use the Euro instead of the Croatian Kuna. As such, the Kuna has already been removed from the ISO4217 specification by the maintaining upstream party for it - the six group.
To maintain backwards compatibility in this minor release, the enum cases will stay in this specification package and will just be marked as deprecated.
Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.5.0...v1.5.1
Add incremental backoff to spec updating so manual retries are not ne… by @PrinsFrank in https://github.com/PrinsFrank/standards/pull/46
Full Changelog: https://github.com/PrinsFrank/standards/compare/v1.4.0...v1.5.0
One column per quarter.