PHPackages                             mikegarde/country-codes - 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. [Utility & Helpers](/categories/utility)
4. /
5. mikegarde/country-codes

ActiveLibrary[Utility & Helpers](/categories/utility)

mikegarde/country-codes
=======================

ISO 3166-1 Country Codes

0.6.1(2y ago)448.6k↓50%2GPL-3.0-onlyPHPPHP ^7.4 || ^8.0CI failing

Since Jul 28Pushed 1y ago1 watchersCompare

[ Source](https://github.com/MikeGarde/country-codes)[ Packagist](https://packagist.org/packages/mikegarde/country-codes)[ RSS](/packages/mikegarde-country-codes/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (2)Versions (18)Used By (0)

[![Packagist](https://camo.githubusercontent.com/19b2fce145dae8003604950d4285e973884a02f2095fd3a7299076af7d3cf780/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d696b6567617264652f636f756e7472792d636f6465732e737667)](https://packagist.org/packages/mikegarde/country-codes)[![Packagist](https://camo.githubusercontent.com/6e635a001bd405ca614dc98a12b7207dd7f594082483418b89a4bb3bef9b1d9f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64642f6d696b6567617264652f636f756e7472792d636f6465732e737667)](https://packagist.org/packages/mikegarde/country-codes)[![GitHub](https://camo.githubusercontent.com/d431d635a62a9ba76de93c178755a8962225f8b019a1bfc40d5508f5de396f99/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f6d696b6567617264652f636f756e7472792d636f6465732e737667)](https://github.com/MikeGarde/country-codes)[![GitHub code size in bytes](https://camo.githubusercontent.com/5dc21fac964bc9464a7313f60dd90441c5d2f1db80c24409f77510c51e6ecdd4/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c616e6775616765732f636f64652d73697a652f6d696b6567617264652f636f756e7472792d636f6465732e737667)](https://github.com/MikeGarde/country-codes)[![Libraries.io dependency status for GitHub repo](https://camo.githubusercontent.com/b066e6c72b230eee083f622be247c7d3354fb365f49cab99ea39907516369a1d/68747470733a2f2f696d672e736869656c64732e696f2f6c6962726172696573696f2f6769746875622f6d696b6567617264652f636f756e7472792d636f6465732e737667)](http://bit.ly/2Yuoi8w)[![codecov](https://camo.githubusercontent.com/cfff84c7c3e9eb335a6298e437c0a7776a929457a8dc97466c469b0bf7356425/68747470733a2f2f636f6465636f762e696f2f6769746875622f4d696b6547617264652f636f756e7472792d636f6465732f67726170682f62616467652e7376673f746f6b656e3d454b4f31495556465633)](https://codecov.io/github/MikeGarde/country-codes)

Country Codes & US States
=============================

[](#country-codes--us-states)

ISO 3166-1, 3166-2-US

Install
-------

[](#install)

Find on [Packagist](https://packagist.org/packages/mikegarde/country-codes), and install using [Composer](http://getcomposer.org).

```
composer require mikegarde/country-codes
```

Use
---

[](#use)

### Country Codes

[](#country-codes)

```
include 'vendor/autoload.php';

use Countries\Countries;

$countries = new Countries();
$result    = $countries->getCountry('US');
$result    = $countries->getCountry('USA');
$result    = $countries->getCountry('UnitedStates');
$result    = $countries->getCountry('United States');
$result    = $countries->getCountry('United States of America');

/*
$result = [
    'name'    => 'United States',
    'iso2'    => 'US',
    'iso3'    => 'USA',
    'isoNum'  => '840',
    'fips'    => 'US',
    'capital' => 'Washington',
    'isEU'    => 0,
    'isUK'    => 0,
    'isUS'    => 0,
];
*/
```

For your UI

```
$countries = new Countries();
$results   = $countries->getAllCountries();

return json_encode($results);
```

US Territory

```
$countries = new Countries(true);
if ($countries->isUSTerritory('PR'))
{
    echo 'Yep, a US Territory';
}
```

Do something for Canada

```
if ($countries->validate('CA', $order['consignee']['countryCode']))
{
    echo 'Blame Canada';
}
```

### US States

[](#us-states)

Do something different when shipping outside the lower 48

```
$stateTest = new US();

if ($stateTest->isCONUS($order['consignee']['state']))
{
    echo 'You can select USPS, UPS, or DHL';
}
else // OCONUS
{
   echo 'USPS is your only option for shipping to AK, HI, APO, or an FPO address';
}
```

Local Development Notes
-----------------------

[](#local-development-notes)

The numeric value after the command represents the PHP version

```
task build-8.3
task setup-8.3
task test-8.3
```

Alternatively you can run `task test-all` to build, setup, and test against all supported PHP versions.

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance35

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~237 days

Recently: every ~445 days

Total

13

Last Release

731d ago

PHP version history (3 changes)0.4.1PHP ^5.6 || ^7.0

0.5.0PHP ^8.0

0.6.1PHP ^7.4 || ^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/38661d707f6a81eb0c2855c2f16143a3c744b89e8ef63044fc05fceb9b28f46a?d=identicon)[MikeGarde](/maintainers/MikeGarde)

---

Top Contributors

[![MikeGarde](https://avatars.githubusercontent.com/u/1537877?v=4)](https://github.com/MikeGarde "MikeGarde (41 commits)")

---

Tags

autocorrectcmscountriescountry-codesoms

###  Code Quality

TestsPHPUnit

Code StylePHP\_CodeSniffer

### Embed Badge

![Health badge](/badges/mikegarde-country-codes/health.svg)

```
[![Health](https://phpackages.com/badges/mikegarde-country-codes/health.svg)](https://phpackages.com/packages/mikegarde-country-codes)
```

PHPackages © 2026

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