NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #690 most downloaded on Packagist
Addressing library powered by CLDR and Google's address data.
Latest stable
v2.3.2
Last release 1 months ago
09 Oct 2026
Release timing varies
gaps range from 2 weeks to 12 months
Most releases are documented
notes for 35 of 41 stable releases
Nothing withdrawn
no release was ever pulled
12 years old
49 releases · first in 2015
Drag across the ruler to compare, or tap a release to open it.
Add the missing has_children flag for Ñuble (CL). by @robinvdvleuten in https://github.com/commerceguys/addressing/pull/252
Full Changelog: https://github.com/commerceguys/addressing/compare/v2.3.1...v2.3.2
Two fixes for bugs introduced in v2.3.0:
Two fixes for bugs introduced in v2.3.0:
subdivision_data_fields).Full Changelog: https://github.com/commerceguys/addressing/compare/v2.3.0...v2.3.1
Your coding agent can read these notes before it upgrades. Set up the MCP server →
AddressFormat now has getSubdivisionDataFields(), replacing getSubdivisionDepth() which is now deprecated. Custom definitions using subdivision_depth…
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.
State suffix dropped from Ogun.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.locale now default local_name to name, for less verbosity.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: https://github.com/commerceguys/addressing/compare/v2.2.5...v2.3.0
Improved CLDR country generation script (now fully automated).
Full Changelog: https://github.com/commerceguys/addressing/compare/v2.2.4...v2.2.5
PHP 8.4 support: switch implicit nullable types to explicit by @NickDickinsonWilde in https://github.com/commerceguys/addressing/pull/221
Full Changelog: https://github.com/commerceguys/addressing/compare/v2.2.3...v2.2.4
Update to CLDR v46. Full Changelog: https://github.com/commerceguys/addressing/compare/v2.2.2...v2.2.3
Update to CLDR v46.
Full Changelog: https://github.com/commerceguys/addressing/compare/v2.2.2...v2.2.3
Remove unneeded files from the archives by @stof in https://github.com/commerceguys/addressing/pull/215
Full Changelog: https://github.com/commerceguys/addressing/compare/v2.2.1...v2.2.2
Correct suffixes for ukrainian region names
Full Changelog: https://github.com/commerceguys/addressing/compare/v2.2.0...v2.2.1
Allow address formats to declare default values.
API improvements:
Address format updates:
Use the Town/City locality type for New Zealand.
Compatible with Symfony 7.0.
Address format changes:
Fixed the reported currency for countries CU and VG.
Note for integrators: a new locality type was added.
Fixes https://github.com/commerceguys/addressing/issues/196.
Fixes https://github.com/commerceguys/addressing/issues/196.
Removed the postal code prefix for Switzerland. Requested in #96.
Changes since v2.0.0-rc1:
Changes since v1.4.3:
Added administrative areas for 8 countries: Barbados (BB), Micronesia (FM), Honduras (HN), Kiribati (KI), Panama (PA), Papua New Guinea (PG), Seychell
Changes since v2.0.0-beta2:
Please see the v2.0.0-beta1 release notes for a list of all v2.0.0 changes.
Please see the v2.0.0-beta1 release notes for a list of all v2.0.0 changes.
Changes since v2.0.0-beta1:
Dropped PHP 7 support, started using PHP 8 language features.
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.
Fixed PHP 8.1 deprecation warning
Quick followup to v.1.4.0, improving BC in the Address class by making the type hints nullable.
Quick followup to v.1.4.0, improving BC in the Address class by making the type hints nullable.
Now using PHP 7.3 language features and typehints. Thanks @Chris53897!
Country list updated to CLDR v41.
Country list updated to CLDR v41.
Dropped support for PHP 7.1 and 7.2. Thanks @Chris53897!
Nothing published for this version
Country list updated to CLDR v39.
Country list updated to CLDR v39.
Updated subdivisions for India.
Updates subdivisions for CL, CN, IR, KR, RU and address formats for BH, BY, KH, NA.
Drops PHP 7.0 support.
Updates subdivisions for CL, CN, IR, KR, RU and address formats for BH, BY, KH, NA.
Updated the CLDR country list to v38. Updated the filtering of CLDR locales, now matches CLDR's "modern" locale list.
Updated the CLDR country list to v38. Updated the filtering of CLDR locales, now matches CLDR's "modern" locale list.
Deprecates subdivision-level postal code validation. See #147.
Deprecates subdivision-level postal code validation. See #147.
Updates the address format for Ireland. Updates the ISO code and postal code pattern for Sud Sardegna (Italy).
Dataset updates for CN, HK, IE, IT, KR, TW, UA.
Update the country list to CLDR v37.
Update the country list to CLDR v37.
Dropped PHP5 support. Added the canton administrative area type.
Dropped PHP5 support. Added the canton administrative area type.
Update the country list to CLDR v36.
Update the country list to CLDR v36.
Update the country list to CLDR v35.1
Update the country list to CLDR v35.1
Update the dataset (NA/RO address formats, AU/IN/KR subdivisions)
Update the dataset (NA/RO address formats, AU/IN/KR subdivisions)
Updated subdivisions for Nicaragua.
Updated countries to CLDR v35.
Updated subdivisions for Nicaragua.
Improved handling of unknown countries in DefaultFormatter.
Updated the dataset (BY/HM/KZ/SY address formats; CU/CN/IR/MX/PE/PH subdivisions)
Updated countries to CLDR v34.
Updated the dataset (BY/HM/KZ/SY address formats; CU/CN/IR/MX/PE/PH subdivisions)
Stop stripping BV, HM, CP from the country list. Fixes #106.
Removed the commerceguys/intl integration, the library now contains its own country list. Added a field override API (Fixing #102). Made the formatter
Removed the commerceguys/intl integration, the library now contains its own country list. Added a field override API (Fixing #102). Made the formatters stateless (Fixing #104).
Address format updates for ES, CO, CU, SD, KP, MZ. Administrative areas for CO, KP, MZ.
Dropped HHVM support.
Various bugfixes.
Removed the commerceguys/enum dependency. Updated the dataset (updated postal code patterns for India and Turkey, state name tweaks for Russia).
Removed the commerceguys/enum dependency. Updated the dataset (updated postal code patterns for India and Turkey, state name tweaks for Russia).
Switched to the new Google endpoint for the dataset generation. Updated definitions.
Switched to the new Google endpoint for the dataset generation. Updated definitions.
Dropped support for Symfony < 3.2,
Implemented a simplified zone system as a replacement for commerceguys/zone. See #79.
Address formats can now specify no required fields.
Rewrite the address format storage. Fixes #61.
Dropped PHP 5.4 support.
Biggest changes:
Nothing published for this version
Updated address formats for 35 countries, subdivisions for 10 countries.
Updated address formats: CO, ID, IE, SO. Updated subdivisions: AE, BR, CN, TW.
Updated address formats: CO, ID, IE, SO. Updated subdivisions: AE, BR, CN, TW.
Remove Swiss administrative areas, they aren't used for addressing.
Nothing published for this version
Remove setters from AddressInterface, add an optional ImmutableAddressInterface.
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.