README

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.

Usage:

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

Requirements

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

Resources

• Symfony Intl Documentation
• Report issues and send Pull Requests