commerceguys/addressing

Two fixes for bugs introduced in v2.3.0:

• getSubdivisionDepth() returned an error for some address formats due to a lack of a default value.
• Guatemala (GT) subdivisions were not wired in (missing subdivision_data_fields).

Full Changelog: v2.3.0...v2.3.1

Address formats now declare which fields have subdivision data

subdivision_depth has been replaced by subdivision_data_fields, which names the fields directly instead of encoding them as a count (#213):

// Before: 1 meant "administrative areas", 2 meant "administrative areas and localities".
'subdivision_depth' => 1,

// After.
'subdivision_data_fields' => ['administrativeArea'],

AddressFormat now has getSubdivisionDataFields(), replacing getSubdivisionDepth() which is now deprecated. Custom definitions using subdivision_depth are still accepted and converted automatically.

New subdivisions

• Great Britain — the 217 counties from ISO 3166-2:GB, keyed by ISO code, with Welsh names as translations
• Guatemala — the 22 departments, contributed by @jgalindosl (#242).

Data corrections

• AE - optional city field added; the missing hamza restored in the Umm Al Quwain local name.
• CO - spelling of Guainía.
• IT - province list updated and sorted alphabetically, thanks to @McAle16 (#237).
• NG-— the State suffix dropped from Ogun.
• PE - administrative areas are now labelled as regions, matching ISO 3166-2:PE.
• RU - the Udmurt Republic now uses its official name.
• TH - romanization fixed for Chumphon, Phatthalung and Suphan Buri; the changwat prefix
  dropped from the Bueng Kan local name.
• TR - Afyon renamed to Afyonkarahisar.
• VE - Distrito Federal renamed to Distrito Capital, its official and ISO 3166-2 name since
  1999; La Guaira moved to its alphabetical position after the rename from Vargas.
• VN - the city prefix dropped from the Ho Chi Minh local name.

Other improvements

• Reworked DefaultFormatter's logic for rendering empty fields, fixing bugs where separators
  were sometimes left behind (affecting CO, GT, JP, MX, PY, TR, UY, VE).
• Subdivision definitions with a locale now default local_name to name, for less verbosity.
• Malformed subdivision definition files are ignored instead of raising errors (#246).
• PostalCodeHelper accepts modifiers in regular expression rules, so /ZE[0-9]/i works (#164).
• doctrine/collections 3 is now allowed, thanks to @Chris53897 (#241).
• SubdivisionUpdater mappings for Vietnam now match VN.json, thanks to @eugene-brit (#240), and cover the VN renames shipped in v2.2.5.

Full Changelog: v2.2.5...v2.3.0

What's Changed

• CLDR v47 and v48
• Improved CLDR country generation script (now fully automated).
• Update Vietnam subdivisions by @lenamsoft in #230
• ci: add tests for PHP 8.5 by @Chris53897 in #233
• ci: allow symfony/validator 8 (dev) by @Chris53897 in #234

New Contributors

• @lenamsoft made their first contribution in #230

Full Changelog: v2.2.4...v2.2.5

What's Changed

• PHP 8.4 support: switch implicit nullable types to explicit by @NickDickinsonWilde in #221

New Contributors

• @NickDickinsonWilde made their first contribution in #221

Full Changelog: v2.2.3...v2.2.4

Update to CLDR v46.

Full Changelog: v2.2.2...v2.2.3

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

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

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

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.

• 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.