A PHP Intl library to retrieve states for a given country.

4.0.0 2022-09-21 22:15 UTC

This package is auto-updated.

Last update: 2023-09-22 00:53:19 UTC


PHPUnit Build Status Test Coverage Code Climate

A companion component to Symfony's Intl Component. This component allows for easy retrieval of a country's states/provinces using the country's ISO 3166-1 alpha-2 code.

The Symfony Intl component is a replacement for the C intl extension. It is limited to only the "en" locale. If you want to have access to more locales you should install the intl PECL extension.


// States/Provinces for the United States of America
$subdivisionsForUS = \Symfony\Component\IntlSubdivision\IntlSubdivision::getStatesAndProvincesForCountry('US');
// States/Provinces for Canada
$subdivisionsForCA = \Symfony\Component\IntlSubdivision\IntlSubdivision::getStatesAndProvincesForCountry('CA');
// States/Provinces for the United Arab Emirates
$subdivisionsForAE = \Symfony\Component\IntlSubdivision\IntlSubdivision::getStatesAndProvincesForCountry('AE');


  • PHP 7+ or 8+
  • Symfony Intl package 5.0+ or 6.0+
    • older versions can still support 4.0+ but are not actively supported