PHPackages                             on2media/us-zip-code-to-state - 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. on2media/us-zip-code-to-state

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

on2media/us-zip-code-to-state
=============================

Maps a US ZIP code to a state

1.0.0(5y ago)349.0k↓10.7%MITPHP

Since Jul 19Pushed 5y ago1 watchersCompare

[ Source](https://github.com/on2media/us-zip-code-to-state)[ Packagist](https://packagist.org/packages/on2media/us-zip-code-to-state)[ RSS](/packages/on2media-us-zip-code-to-state/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)DependenciesVersions (2)Used By (0)

US ZIP Code to State
====================

[](#us-zip-code-to-state)

Some payment providers require a state to be sent when the cardholder is based in the United States. Rather than add an additional field to our payment form we created this mapping based on data obtained from [https://simple.wikipedia.org/wiki/List\_of\_ZIP\_Code\_prefixes](https://simple.wikipedia.org/wiki/List_of_ZIP_Code_prefixes).

Usage:

```
$state = (new \On2Media\UsZipCodeToState\UsZipCodeToState())->getState('90210'); // `CA`
```

Exceptions are thrown if the ZIP code is not five numeric characters or if no match is found.

In addition to state abbreviations (AK, AL, AR, AZ, CA, CO, CT, DE, FL, GA, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MI, MN, MO, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, RI, SC, SD, TN, TX, UT, VA, VT, WA, WI, WV, WY) the following other codes are also returned:

- Armed Forces (AA, AE, AP)
- District of Columbia (DC)
- Territories (GU, PR, VI)

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity32

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity55

Maturing project, gaining track record

 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

Unknown

Total

1

Last Release

2129d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/1434eb1bb61fa4f70e202499ee89e7c4677dd8d80aa0c8ad89ba454f4d6a52e4?d=identicon)[on2media](/maintainers/on2media)

---

Top Contributors

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

---

Tags

statezip codeon2 media

### Embed Badge

![Health badge](/badges/on2media-us-zip-code-to-state/health.svg)

```
[![Health](https://phpackages.com/badges/on2media-us-zip-code-to-state/health.svg)](https://phpackages.com/packages/on2media-us-zip-code-to-state)
```

###  Alternatives

[symfony/workflow

Provides tools for managing a workflow or finite state machine

62942.3M170](/packages/symfony-workflow)[yohang/finite

A simple PHP Finite State Machine

1.3k3.5M10](/packages/yohang-finite)[winzou/state-machine

A very lightweight yet powerful PHP state machine

52113.7M18](/packages/winzou-state-machine)[ip2location/ip2location-php

\[Official Release\] IP2Location PHP API to get location info from IPv4 and IPv6 address.

2133.9M33](/packages/ip2location-ip2location-php)[sebdesign/laravel-state-machine

Winzou State Machine service provider for Laravel

3401.3M1](/packages/sebdesign-laravel-state-machine)[dougsisk/laravel-country-state

Country & state helper for Laravel.

1681.7M](/packages/dougsisk-laravel-country-state)

PHPackages © 2026

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