v2.2.2

What's Changed

• Remove unneeded files from the archives by @stof in #215

New Contributors

• @stof made their first contribution in #215

Full Changelog: v2.2.1...v2.2.2

v2.2.1

What's Changed

• Update to CLDR v45.
• Correct suffixes for ukrainian region names (#214)
• Update UA subdivisions to follow the latest romanization system (and match ISO).

New Contributors

• @vladdancer made their first contribution in #214

Full Changelog: v2.2.0...v2.2.1

v2.2.0

API improvements:

• Allow address formats to declare default values.
• Allow turning off postal code validation in AddressFormatConstraint.

Address format updates:

• Singapore lacks city/locality field.
• Update subdivisions for India (IN).
• Add missing Indonesian (ID) provinces: PD, PE, PS, PT.
• Update subdivisions for Philippines (PH).
• Chile's administrative areas are called regions, not provinces.
• Simplify the postal code pattern for Peru (PE).
• Make the administrative area required for BB, CL, CV, EG, IR, KI, MY, PE, TH, VN

v2.1.1

Compatible with Symfony 7.0.

Address format changes:

• Use the Town/City locality type for New Zealand.
• Rebuild the address format for Kazakhstan.
• Add subdivisions for Kazakhstan.
• When uppercasing address lines 1 and 2, uppercase line 3 as well.

v2.1.0

• Updated to CLDR v44.
• Fixed the reported currency for countries CU and VG.
• UK locality_type is now town_city (#200).

Note for integrators: a new locality type was added.

v2.0.1

Fixes #196.

v2.0.0

Changes since v2.0.0-rc1:

• Removed the postal code prefix for Switzerland. Requested in #96.
• Added punctuation to the PY/UY address formats, as specified by UPU.
• Added administrative areas for Paraguay (PY).

Changes since v1.4.3:

• Added an address line 3 to the data model.
• Address formats and subdivisions are no longer auto-generated from Google's dataset, allowing us to accept community changes and bug reports.
• Subdivisions are now always keyed by ISO code when one is available. See the beta1 docs for instructions on updating data.
• The "additional name" field is now visible for countries that use patronymics.
• Added administrative areas for 12 countries (BB, CR, EE, FM, HN, KI, PA, PG, PY, SC, UM, ZW).
• Rebuilt administrative areas for 2 countries (BS, PH).
• Many smaller address format improvements.
• Country list now sourced from CLDR v43.
• Dropped PHP 7 support.

v2.0.0-rc1

Changes since v2.0.0-beta2:

• Added administrative areas for 8 countries:
  Barbados (BB), Micronesia (FM), Honduras (HN), Kiribati (KI), Panama (PA),
  Papua New Guinea (PG), Seychelles (SC), United States Minor Outlying Islands (UM).
• Renamed VE-X from Vargas to La Guaira.
• Removed the administrative area field from AS, MP, VI.
  These are islands and the format was copied from from the parent US one.
• Removed the administrative area field from CC, CX, HM, NF.
  These are islands and the format was copied from from the parent AU one.
• Use 'region' instead of 'oblast' as the administrative area type for BY/UA/RU.
  All three countries use 'region' when referring to oblasts in English.

v2.0.0-beta2

Please see the v2.0.0-beta1 release notes for a list of all v2.0.0 changes.

Changes since v2.0.0-beta1:

• Revert the 2.0.0-beta1 changes to Cabo Verde subdivisions.
  These are islands, not municipalities as defined by ISO, so not all of them have a two-letter code. For the sake of consistency we're going back to specifying the full island name as the ID.
• Fix several wrong type hints.
• Make Address type hints non-nullable again.
  This reverts 8b1bcd4 from v1.4.1.

v2.0.0-beta1

Major changes

• Dropped PHP 7 support, started using PHP 8 language features.
• Added address line 3 to the address data model.
• Subdivisions are now keyed by ISO code when one is available. See the "Updating data" section for more information.
• Address formats and subdivisions are no longer auto-generated from Google's dataset, allowing us to accept community changes and bug reports.
• Updated address formats / subdivisions for 20 countries:
  • The "additional name" field is now visible for countries that use patronymics.
  • Defined subdivisions for Costa Rica (CR), Estonia (EE) and Zimbabwe (ZW).
  • Rebuilt subdivisions for Bahamas (BS) and Philippines (PH).
  • Additional localities defined for South Korea (KR) and Chile (CL).
• Country list (and translations) updated to CLDR v43.

Updating data

The library now ships with a SubdivisionUpdater.

It can be used in two ways:
a) Call SubdivisionUpdater::updateValue($countryCode, $value) to update an address's administrativeArea in a postLoad() event or equivalent place.

b) Use SubdivisionUpdater::getUpdateMap() to get the full list of updates, and use it to generate update queries for your data.