Utility for converting and formatting phone numbers

v1.0.0 2020-12-20 20:45 UTC

This package is auto-updated.

Last update: 2024-09-21 05:35:56 UTC


README

This is just a teeny tiny tested library for parsing, formatting, and validating phone numbers.

It is mostly aimed towards US formatting as many countries and customs have their own form of formatting phone numbers.

Installation

Use composer

composer require salernolabs/phone

Instantiate a class as necessary!

General Usage

$phone = new \SalernoLabs\Phone\PhoneNumber('1234567890');
echo $phone->formatNumber();

If all works as expected this will output 1 (123) 456-7890

You can also just echo (string)$phone;

It implements \Serializable so it should be serializable.

Class Documentation

The class requires a valid phone number string to be entered as a constructor parameter. It is parsed at construction time. It may throw \InvalidArgumentException if it is unable to properly parse the phone number.

Contributing

Submit pull requests or fork it if you want. You are, after all, the Homerun Hitter of your Phone Number Formatter (sorry Chef John).