PHPackages                             gmaniac/us-address-normalization - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. gmaniac/us-address-normalization

ActiveLibrary[Parsing & Serialization](/categories/parsing)

gmaniac/us-address-normalization
================================

US address normalization and hashing library

v1.0.0(4mo ago)046MITPHPPHP >=8.0CI passing

Since Feb 11Pushed 4mo agoCompare

[ Source](https://github.com/gmaniac/us-address-normalization-php)[ Packagist](https://packagist.org/packages/gmaniac/us-address-normalization)[ Docs](https://github.com/gmaniac/us-address-normalization-php)[ RSS](/packages/gmaniac-us-address-normalization/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (1)Versions (2)Used By (0)

US Address Normalization
========================

[](#us-address-normalization)

A PHP library to normalize and hash US addresses without requiring an external service. This is the PHP implementation of [us-address-normalization](https://github.com/gmaniac/us-normalize-address) (TypeScript).

Based on the Perl module [Geo::StreetAddress::US](https://metacpan.org/pod/Geo::StreetAddress::US) originally written by Schuyler D. Erle.

Purpose
-------

[](#purpose)

The main purpose of this package is as the first layer of address normalization and standardization. Recommended use is to pre-parse/normalize an address and compare to an existing cache/record set using the hash functions.

Limitations
-----------

[](#limitations)

This is a basic normalizer. It realistically only handles US-based addresses, and should not be considered dependable for strict address-to-address comparison. **This normalizer does not verify the validity of the address!** If you are dependent on accurate addresses, you should use a 3rd party service to verify addresses.

Installation
------------

[](#installation)

```
composer require gmaniac/us-address-normalization
```

Usage
-----

[](#usage)

### Normalizing

[](#normalizing)

```