v3.4.0 Country/Language names in different languages, Number/Currency formatting based on country/language, National call prefixes

What's Changed

• Add national call prefixes by @PrinsFrank in #104
• Add methods for country names in language by @PrinsFrank in #116
• Add 'getNameInLanguage' methods for languages by @PrinsFrank in #117
• Mark Name enums deprecated by @PrinsFrank in #122
• Add currency formatting by @PrinsFrank in #120
• Add formatNumber methods to country and language standards by @PrinsFrank in #123

Full Changelog: v3.3.0...v3.4.0

v3.3.0 Relationship between country and language & Minor units for currencies

What's Changed

• Add minor units to currency by @PrinsFrank in #101
• Add relation between countries and languages by @PrinsFrank in #103

Full Changelog: v3.2.0...v3.3.0

v3.2.0 Add relationships between Countries and Currencies

What's Changed

• Add relationship between countries and currencies by @PrinsFrank in #100

Full Changelog: v3.1.0...v3.2.0

v3.1.0 Add TravelDocuments Alpha2/Alpha3 UserAssigned country codes in new specfication

What's Changed

• Add TravelDocuments Alpha2/Alpha3 UserAssigned country codes in new specfication by @rbiya in #96

New Contributors

• @rbiya made their first contribution in #96

Full Changelog: v3.0.0...v3.1.0

v3.0.0

New features

RFC 5646 language tags added by @PrinsFrank in #69

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);

Relation added between countries and Country Calling Cod(es) by @PrinsFrank in #81

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] 

Relation added between countries and international call prefix(es) by @PrinsFrank in #82

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]

Methods added to create language tags from languages by @PrinsFrank in #83

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.

"getFlagEmoji" method added to country standards by @PrinsFrank in #93

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.

Breaking changes

(See UPGRADING.md)

Removal of LanguageAlpha3Common; merged into LanguageAlpha3Bibliographic and LanguageAlpha3Terminology by @PrinsFrank in #91

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

ScriptCode and ScriptNumber naming inverted

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

Typo fixed in CountryCallingCode enum case by @szepeviktor in #65

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;

BackedEnum and UnitEnum are now marked internal @PrinsFrank in #92

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.

Other

• Do not distribute PNG images by @szepeviktor in #79
• Speed up PHPStan execution by @szepeviktor in #89
• Fix PHPStan usage by @szepeviktor in #88
• Synchronize PHPStan usage by @szepeviktor in #90
• Update documentation for languages by @PrinsFrank in #94

Full Changelog: v2.5.0...v3.0.0

v2.5.0 Extensive language tags from ISO639-3 and several fixes

What's Changed

• Rewrite source parsing to allow for more source formats by @PrinsFrank in #72
• Deprecate "unused" status code as multiple status codes are unused and it's not part of the spec by @PrinsFrank in #73
• Exclude "Reserved for local use" from being included in language names as it doesn't have a single code by @PrinsFrank in #75
• Fix incorrect column count in script mapping resulting in incorrect Scripts by @PrinsFrank in #76
• Add missing old "Bolivar Soberano" and "Leone" as due to a name collision it was missing from the spec by @PrinsFrank in #74
• Add extensive alpha3 languages from ISO639-3 by @PrinsFrank in #71

Full Changelog: v2.4.0...v2.5.0

v2.4.0 Geographic regions from M49 added

What's Changed

• Add Geographic regions by @PrinsFrank in #68

Full Changelog: v2.3.0...v2.4.0

v2.3.0 Scripts added: Latin, Hangul etc (ISO-15924)

What's Changed

• Introduce ISO-15924 Scripts by @PrinsFrank in #67

Full Changelog: v2.2.0...v2.3.0

v2.2.0 Country groups added: EU, EEA, EFTA, BRICS etc

What's Changed

• Fix typos by @szepeviktor in #64
• Introduce EditorConfig by @szepeviktor in #66
• Add Country groups: EU, EEA, EFTA, BRICS etc

Full Changelog: v2.1.0...v2.2.0

v2.1.0 Currency symbols added

Full Changelog: v2.0.1...v2.1.0