trickeyone/intl-subdivision

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


Keywords
country, country-codes, intl-extension, intl-subdvision, php, province, provinces, state, states, subdivision, symfony, symfony-intl-component
License
MIT

Documentation

IntlSubdivision Component

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.

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