renderbit / normalize-phone
Normalize phone numbers (with or without country code)
Installs: 1 431
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 3
Forks: 0
Open Issues: 0
Requires
- php: ~7.1|^8.0
Requires (Dev)
- phpunit/phpunit: >=7.0
- psy/psysh: ^0.9.9
- squizlabs/php_codesniffer: ^3.0
This package is auto-updated.
Last update: 2024-12-04 12:53:00 UTC
README
Normalize a phone number (with or without country code).
Background
We needed to send phone numbers to a third-party API as an amalgamation of the phone number and the country code, without the plus sign, brackets or any other special characters such as hyphens or spaces. We built this package as a solution to automatically parse user-input phone numbers and pass them as-is to the API, if already in the correct format - otherwise amend them and send the formatted numbers to the API.
This package looks for the environment variable PHONE_DEFAULT_COUNTRY_CODE to define the base country code to be prepended to the numbers with no country code. If no such variable is define, the package assumes a default of India (91).
Install
Via Composer
$ composer require renderbit/normalize-phone
Usage
normalize_phone('9434012345'); // '919434012345' normalize_phone('+919434012345'); // '919434012345' normalize_phone('+91-9434012345'); // '919434012345' normalize_phone('+19434012345'); // '19434012345' normalize_phone('+91 9434012345'); // '919434012345' normalize_phone('(+91) 94340 12345'); // '919434012345'
Change log
Please see CHANGELOG for more information on what has changed recently.
Testing
$ composer test
Contributing
Please see CONTRIBUTING and CODE_OF_CONDUCT for details.
Security
If you discover any security related issues, please email “contact at renderbit dot com” instead of using the issue tracker.
Credits
License
The MIT License (MIT). Please see License File for more information.