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.


After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package libphonenumber-for-php

libphonenumber for PHP Build Status Coverage Status

Total Downloads Downloads per month Latest Stable Version License

What is it?

A PHP library for parsing, formatting, storing and validating international phone numbers. This library is based on Google's libphonenumber.


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.


If you only want to make sure of the core PhoneNumber Util functionality, you can use giggsey/libphonenumber-for-php-lite, which offers a much smaller package size.


Online Demo

An online demo is available, and the source can be found at giggsey/libphonenumber-example.

Highlights of functionality


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 =>
 private $nationalNumber =>
 private $extension =>
 private $italianLeadingZero =>
 private $rawInput =>
 private $countryCodeSource =>
 private $preferredDomesticCarrierCode =>

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:



Mapping Phone Numbers to carrier

Mapping Phone Numbers to TimeZones


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.

All versions of libphonenumber-for-php with dependencies

PHP Build Version
Package Version
Requires php Version >=5.3.2
giggsey/locale Version ^1.7|^2.0
symfony/polyfill-mbstring Version ^1.17
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package giggsey/libphonenumber-for-php contains the following files

Loading the files please wait ....