PHPackages                             aklump/phone-number - 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. aklump/phone-number

ActiveLibrary

aklump/phone-number
===================

A lean, non-dependency PHP library to work with phone numbers.

0.0.9(1y ago)026BSD-3-ClausePHPPHP >=7.3

Since Aug 14Pushed 1y ago1 watchersCompare

[ Source](https://github.com/aklump/phone-number)[ Packagist](https://packagist.org/packages/aklump/phone-number)[ Docs](https://github.com/aklump/phone-number)[ RSS](/packages/aklump-phone-number/feed)WikiDiscussions main Synced 1mo ago

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

Phone Number
============

[](#phone-number)

A lean, non-dependency PHP library to work with phone numbers. The focus of the library is on U.S. phone numbers only at this time. To work with international phone numbers you might try [Phone Normalizer](https://github.com/aklump/phone-number), from which we've taken the same formatting strategy. (Thank you, [dmamontov](https://github.com/dmamontov) and [1on](https://github.com/1on).)

[![aklump/phone-number](images/aklump_phone_number.jpg)](images/aklump_phone_number.jpg)

Install with Composer
---------------------

[](#install-with-composer)

1. Require this package:

    ```
    composer require aklump/phone-number:^0.0

    ```

Usage
-----

[](#usage)

### Formatting Numbers

[](#formatting-numbers)

- Tokens are:
    - `#CC#` for the country code.
    - `#c#` for the area code
    - `###` (leftmost three) for the local exchange.
    - `####` (rightmost four) for subscriber number.
- Pre-defined formats provided by `\AKlump\PhoneNumber\PhoneNumberFormats`
- Invalid phone numbers will not format, but throw an exception.
- To obtain a list of violations for an invalid phone number use the `::validate` method.

```
$phone = (new \AKlump\PhoneNumber\USPhoneNumberFormatter();
$number = $phone->format('3608881223');
// '(360) 888-1223' === $formatted
```

If the context of your app is regional, you maybe want to assume a default area code.

```
$default_area_code = 360;
$phone = (new \AKlump\PhoneNumber\USPhoneNumberFormatter($default_area_code);

$number = $phone->format('8881223');
// '(360) 888-1223' === $formatted
```

#### Formatted for SMS

[](#formatted-for-sms)

```
$number = $phone->format('888-1223', \AKlump\PhoneNumber\PhoneNumberFormats::SMS);
// '+13608881223' === $number
```

#### Using Custom Formats

[](#using-custom-formats)

```
// Provide a custom default format.
$phone = (new \AKlump\PhoneNumber\USPhoneNumberFormatter(360, '+#CC#.#c#.###.####');
$number = $phone->format('888-1223');
// '+1.360.888.1223' === $number
```

#### Outside the Box Thinking

[](#outside-the-box-thinking)

```
// Convert to a JSON string.
$phone = (new \AKlump\PhoneNumber\USPhoneNumberFormatter(360, \AKlump\PhoneNumber\PhoneNumberFormats::JSON);
$number = $phone->format('888-1223');
// '{"country":"+1","areaCode":206,"localExchange":555,"subscriberNumber":1212}' === $number
```

### Validating Numbers

[](#validating-numbers)

```
$phone = (new \AKlump\PhoneNumber\USPhoneNumberFormatter();
$violations = $phone->validate('3608881223');
foreach($violations as $violation) {
  echo $violation;
}
$is_valid = empty($violations);
```

- See also `\AKlump\PhoneNumber\PhoneNumberViolations`

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance37

Infrequent updates — may be unmaintained

Popularity6

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity30

Early-stage or recently created project

 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 ~0 days

Total

9

Last Release

634d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/79476f3b82f9c766433c7eb401cbcfc636cd5d5ccf2b2e6b50ea81d1de6c2730?d=identicon)[aklump](/maintainers/aklump)

---

Top Contributors

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

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/aklump-phone-number/health.svg)

```
[![Health](https://phpackages.com/badges/aklump-phone-number/health.svg)](https://phpackages.com/packages/aklump-phone-number)
```

PHPackages © 2026

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