Download the PHP package giggsey/libphonenumber-for-php without Composer
On this page you can find all versions of the php package giggsey/libphonenumber-for-php. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download giggsey/libphonenumber-for-php
More information about giggsey/libphonenumber-for-php
Files in giggsey/libphonenumber-for-php
Package libphonenumber-for-php
Short Description PHP Port of Google's libphonenumber
License Apache-2.0
Homepage https://github.com/giggsey/libphonenumber-for-php
Informations about the package libphonenumber-for-php
libphonenumber for PHP
What is it?
A PHP library for parsing, formatting, storing and validating international phone numbers. This library is based on Google's libphonenumber.
- Installation
- Documentation
- Online Demo
- Highlights of functionality
- Versioning
- Quick Examples
- Geocoder
- ShortNumberInfo
- Mapping Phone Numbers to Carrier
- Mapping Phone Numbers to TimeZones
- FAQ
- Problems with Invalid Numbers?
- Generating data
- Integration with frameworks
Installation
PHP versions 5.3 to PHP 8.3 are currently supported.
The PECL mbstring extension is required.
It is recommended to use composer to install the library.
You can also use any other PSR-4 compliant autoloader.
If you do not use composer, ensure that you also load any dependencies that this project has, such as giggsey/locale.
giggsey/libphonenumber-for-php-lite
If you only want to make use of the core PhoneNumber Util functionality, you can use giggsey/libphonenumber-for-php-lite, which offers a much smaller package size.
Documentation
- PhoneNumber Util
- ShortNumber Info
- Phone Number Geolocation
- Phone Number to Carrier Mapping
- Phone Number to Timezone Mapping
- Phone Number Matcher
- As You Type Formatter
Online Demo
An online demo is available, and the source can be found at giggsey/libphonenumber-example.
Highlights of functionality
- Parsing/formatting/validating phone numbers for all countries/regions of the world.
getNumberType
- gets the type of the number based on the number itself; able to distinguish Fixed-line, Mobile, Toll-free, Premium Rate, Shared Cost, VoIP and Personal Numbers (whenever feasible).isNumberMatch
- gets a confidence level on whether two numbers could be the same.getExampleNumber
/getExampleNumberByType
- provides valid example numbers for all countries/regions, with the option of specifying which type of example phone number is needed.isValidNumber
- full validation of a phone number for a region using length and prefix information.PhoneNumberOfflineGeocoder
- provides geographical information related to a phone number.PhoneNumberToTimeZonesMapper
- provides timezone information related to a phone number.PhoneNumberToCarrierMapper
- provides carrier information related to a phone number.
Versioning
This library will try to follow the same version numbers as Google. There could be additional releases where needed to fix critical issues that can not wait until the next release from Google.
This does mean that this project may not follow Semantic Versioning, but instead Google's version policy. As a result, jumps in major versions may not actually contain any backwards incompatible changes. Please read the release notes for such releases.
Google try to release their versions according to Semantic Versioning, as laid out of in their Versioning Guide.
Quick Examples
Let's say you have a string representing a phone number from Switzerland. This is how you parse/normalize it into a PhoneNumber object:
At this point, swissNumberProto contains:
class libphonenumber\PhoneNumber#9 (7) {
private $countryCode =>
int(41)
private $nationalNumber =>
double(446681800)
private $extension =>
NULL
private $italianLeadingZero =>
NULL
private $rawInput =>
NULL
private $countryCodeSource =>
NULL
private $preferredDomesticCarrierCode =>
NULL
}
Now let us validate whether the number is valid:
There are a few formats supported by the formatting method, as illustrated below:
You could also choose to format the number in the way it is dialled from another country:
Geocoder
ShortNumberInfo
Mapping Phone Numbers to carrier
Mapping Phone Numbers to TimeZones
FAQ
Problems with Invalid Numbers?
This library uses phone number metadata from Google's libphonenumber. If this library is working as intended, it should provide the same result as the Java version of Google's project.
If you believe that a phone number is returning an incorrect result, first test it with libphonenumber via their Online Demo. If that returns the same result as this project, and you feel it is in error, raise it as an Issue with the libphonenumber project.
If Google's Online Demo gives a different result to the libphonenumber-for-php demo, then please raise an Issue here.
Generating data
Generating the data is not normally needed, as this repository will generally always have the up to data metadata.
If you do need to generate the data, the commands are provided by Phing. Ensure you have all the dev composer dependencies installed, then run
This compile process clones the libphonenumber project at the version specified in METADATA-VERSION.txt.
Running tests
This project uses PHPUnit Bridge to maintain compatibility for the supported PHP versions.
To run the tests locally, run the ./phpunit
script.
Integration with frameworks
Other packages exist that integrate libphonenumber-for-php into frameworks.
Framework | Packages |
---|---|
Symfony | PhoneNumberBundle |
Laravel | Laravel Phone |
Yii2 | PhoneInput |
Kohana | PhoneNumber |
TYPO3 | TYPO3 Phone Extension |
These packages are supplied by third parties, and their quality can not be guaranteed.