PHPackages                             trickeyone/intl-subdivision - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Localization & i18n](/categories/localization)
4. /
5. trickeyone/intl-subdivision

ActiveLibrary[Localization & i18n](/categories/localization)

trickeyone/intl-subdivision
===========================

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

5.0.1(2mo ago)564.3k—7.5%6[1 issues](https://github.com/trickeyone/intl-subdivision/issues)MITPHPPHP ^7.1 || ^8.0CI failing

Since Nov 8Pushed 2mo ago1 watchersCompare

[ Source](https://github.com/trickeyone/intl-subdivision)[ Packagist](https://packagist.org/packages/trickeyone/intl-subdivision)[ RSS](/packages/trickeyone-intl-subdivision/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (15)Used By (0)

IntlSubdivision Component
=========================

[](#intlsubdivision-component)

[![PHPUnit](https://github.com/trickeyone/intl-subdivision/actions/workflows/unit-tests.yml/badge.svg)](https://github.com/trickeyone/intl-subdivision/actions/workflows/unit-tests.yml)[![code coverage badge](https://raw.githubusercontent.com/trickeyone/intl-subdivision/gh-images/coverage.svg)](https://raw.githubusercontent.com/trickeyone/intl-subdivision/gh-images/coverage.svg)[![Test Coverage](https://camo.githubusercontent.com/e17e5e160e9cbf29e99bfa0d79e7f00131c111498c982cf569d0d8b3bfbfcfbe/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f747269636b65796f6e652f696e746c2d7375626469766973696f6e2f6261646765732f636f7665726167652e737667)](https://codeclimate.com/github/trickeyone/intl-subdivision/coverage)[![Code Climate](https://camo.githubusercontent.com/523b1c09b615f25e5170470f6dfc5621356ea991c4b4b38a3b6ce45f53ec10ef/68747470733a2f2f636f6465636c696d6174652e636f6d2f6769746875622f747269636b65796f6e652f696e746c2d7375626469766973696f6e2f6261646765732f6770612e737667)](https://codeclimate.com/github/trickeyone/intl-subdivision)

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](http://www.iso.org/iso/home/standards/country_codes.htm) 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](http://www.php.net/manual/en/intl.setup.php).

### Usage:

[](#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
------------

[](#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
---------

[](#resources)

- [Symfony Intl Documentation](https://symfony.com/doc/current/components/intl.html)
- [Report issues](https://github.com/trickeyone/intl-subdivision/issues) and [send Pull Requests](https://github.com/trickeyone/intl-subdivision/pulls)

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance82

Actively maintained with recent releases

Popularity37

Limited adoption so far

Community15

Small or concentrated contributor base

Maturity76

Established project with proven stability

 Bus Factor1

Top contributor holds 91% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~284 days

Recently: every ~448 days

Total

13

Last Release

67d ago

Major Versions

1.1.1 → 2.0.02020-08-09

2.0.1 → 3.0.02021-01-30

3.0.6 → 4.0.02022-09-21

4.0.0 → 5.0.12026-03-12

PHP version history (3 changes)v1.0.0PHP ^5.6 || ^7.0

2.0.0PHP ^7.1

3.0.2PHP ^7.1 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/61d36be58a4cd04cf233882fbeed4d467e564bea9d15b787132b36f9dbb8ce3f?d=identicon)[trickeyone](/maintainers/trickeyone)

---

Top Contributors

[![trickeyone](https://avatars.githubusercontent.com/u/1680555?v=4)](https://github.com/trickeyone "trickeyone (61 commits)")[![JoyceBabu](https://avatars.githubusercontent.com/u/502942?v=4)](https://github.com/JoyceBabu "JoyceBabu (3 commits)")[![aspergarus](https://avatars.githubusercontent.com/u/3192939?v=4)](https://github.com/aspergarus "aspergarus (1 commits)")[![iatanasov77](https://avatars.githubusercontent.com/u/9389929?v=4)](https://github.com/iatanasov77 "iatanasov77 (1 commits)")[![yaremkoP](https://avatars.githubusercontent.com/u/34648775?v=4)](https://github.com/yaremkoP "yaremkoP (1 commits)")

---

Tags

countrycountry-codesintl-extensionintl-subdvisionphpprovinceprovincesstatestatessubdivisionsymfonysymfony-intl-component

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/trickeyone-intl-subdivision/health.svg)

```
[![Health](https://phpackages.com/badges/trickeyone-intl-subdivision/health.svg)](https://phpackages.com/packages/trickeyone-intl-subdivision)
```

###  Alternatives

[willdurand/js-translation-bundle

A pretty nice way to expose your translation messages to your JavaScript.

58917.1M55](/packages/willdurand-js-translation-bundle)[php-translation/symfony-bundle

3244.1M9](/packages/php-translation-symfony-bundle)[sonata-project/intl-bundle

Symfony SonataIntlBundle

2159.0M48](/packages/sonata-project-intl-bundle)[lunetics/locale-bundle

A Bundle for switching Languages

1861.1M8](/packages/lunetics-locale-bundle)[elegantly/laravel-translator

All on one translations management for Laravel

6216.9k](/packages/elegantly-laravel-translator)[sylius/locale

Locale handling for PHP applications.

10530.4k17](/packages/sylius-locale)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)