在线时间:8:00-16:00
迪恩网络APP
随时随地掌握行业动态
扫描二维码
关注迪恩网络微信公众号
开源软件名称(OpenSource Name):giggsey/libphonenumber-for-php开源软件地址(OpenSource Url):https://github.com/giggsey/libphonenumber-for-php开源编程语言(OpenSource Language):PHP 100.0%开源软件介绍(OpenSource Introduction):libphonenumber for PHPWhat is it?A PHP library for parsing, formatting, storing and validating international phone numbers. This library is based on Google's libphonenumber.
InstallationPHP versions 5.3 up to PHP 8.1 are currently supported. The PECL mbstring extension is required. It is recommended to use composer to install the library. $ composer require giggsey/libphonenumber-for-php 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. Documentation
Online DemoAn online demo is available, and the source can be found at giggsey/libphonenumber-example. Highlights of functionality
VersioningThis 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 ExamplesLet's say you have a string representing a phone number from Switzerland. This is how you parse/normalize it into a PhoneNumber object: $swissNumberStr = "044 668 18 00";
$phoneUtil = \libphonenumber\PhoneNumberUtil::getInstance();
try {
$swissNumberProto = $phoneUtil->parse($swissNumberStr, "CH");
var_dump($swissNumberProto);
} catch (\libphonenumber\NumberParseException $e) {
var_dump($e);
} At this point, swissNumberProto contains:
Now let us validate whether the number is valid: $isValid = $phoneUtil->isValidNumber($swissNumberProto);
var_dump($isValid); // true There are a few formats supported by the formatting method, as illustrated below: // Produces "+41446681800"
echo $phoneUtil->format($swissNumberProto, \libphonenumber\PhoneNumberFormat::E164);
// Produces "044 668 18 00"
echo $phoneUtil->format($swissNumberProto, \libphonenumber\PhoneNumberFormat::NATIONAL);
// Produces "+41 44 668 18 00"
echo $phoneUtil->format($swissNumberProto, \libphonenumber\PhoneNumberFormat::INTERNATIONAL); You could also choose to format the number in the way it is dialled from another country: // Produces "011 41 44 668 1800", the number when it is dialled in the United States.
echo $phoneUtil->formatOutOfCountryCallingNumber($swissNumberProto, "US");
// Produces "00 41 44 668 18 00", the number when it is dialled in Great Britain.
echo $phoneUtil->formatOutOfCountryCallingNumber($swissNumberProto, "GB"); Geocoder$phoneUtil = \libphonenumber\PhoneNumberUtil::getInstance();
$swissNumberProto = $phoneUtil->parse("044 668 18 00", "CH");
$usNumberProto = $phoneUtil->parse("+1 650 253 0000", "US");
$gbNumberProto = $phoneUtil->parse("0161 496 0000", "GB");
$geocoder = \libphonenumber\geocoding\PhoneNumberOfflineGeocoder::getInstance();
// Outputs "Zurich"
echo $geocoder->getDescriptionForNumber($swissNumberProto, "en_US");
// Outputs "Zürich"
echo $geocoder->getDescriptionForNumber($swissNumberProto, "de_DE");
// Outputs "Zurigo"
echo $geocoder->getDescriptionForNumber($swissNumberProto, "it_IT");
// Outputs "Mountain View, CA"
echo $geocoder->getDescriptionForNumber($usNumberProto, "en_US");
// Outputs "Mountain View, CA"
echo $geocoder->getDescriptionForNumber($usNumberProto, "de_DE");
// Outputs "미국" (Korean for United States)
echo $geocoder->getDescriptionForNumber($usNumberProto, "ko-KR");
// Outputs "Manchester"
echo $geocoder->getDescriptionForNumber($gbNumberProto, "en_GB");
// Outputs "영국" (Korean for United Kingdom)
echo $geocoder->getDescriptionForNumber($gbNumberProto, "ko-KR"); ShortNumberInfo$shortNumberInfo = \libphonenumber\ShortNumberInfo::getInstance();
// true
var_dump($shortNumberInfo->isEmergencyNumber("999", "GB"));
// true
var_dump($shortNumberInfo->connectsToEmergencyNumber("999", "GB"));
// false
var_dump($shortNumberInfo->connectsToEmergencyNumber("911", "GB"));
// true
var_dump($shortNumberInfo->isEmergencyNumber("911", "US"));
// true
var_dump($shortNumberInfo->connectsToEmergencyNumber("911", "US"));
// false
var_dump($shortNumberInfo->isEmergencyNumber("911123", "US"));
// true
var_dump($shortNumberInfo->connectsToEmergencyNumber("911123", "US")); Mapping Phone Numbers to carrier$phoneUtil = \libphonenumber\PhoneNumberUtil::getInstance();
$swissNumberProto = $phoneUtil->parse("798765432", "CH");
$carrierMapper = \libphonenumber\PhoneNumberToCarrierMapper::getInstance();
// Outputs "Swisscom"
echo $carrierMapper->getNameForNumber($swissNumberProto, "en"); Mapping Phone Numbers to TimeZones$phoneUtil = \libphonenumber\PhoneNumberUtil::getInstance();
$swissNumberProto = $phoneUtil->parse("798765432", "CH");
$timeZoneMapper = \libphonenumber\PhoneNumberToTimeZonesMapper::getInstance();
// returns array("Europe/Zurich")
$timeZones = $timeZoneMapper->getTimeZonesForNumber($swissNumberProto); FAQProblems 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 dataGenerating 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 $ vendor/bin/phing compile This compile process clones the libphonenumber project at the version specified in METADATA-VERSION.txt. Running testsThis project uses PHPUnit Bridge to maintain compatibility for the supported PHP versions. To run the tests locally, run the Integration with frameworksOther packages exist that integrate libphonenumber-for-php into frameworks.
These packages are supplied by third parties, and their quality can not be guaranteed. |
2023-10-27
2022-08-15
2022-08-17
2022-09-23
2022-08-13
请发表评论