NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #522 most downloaded on Packagist
Adds phone number functionality to Laravel based on Google's libphonenumber API.
Latest stable
6.1.0
Last release 1 months ago
02 Oct 2026
Release timing varies
gaps range from 3 weeks to 11 months
Most releases are documented
notes for 46 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
89 releases · first in 2014
Drag across the ruler to compare, or tap a release to open it.
Ability to define a default set of countries for validation by @kblais in https://github.com/Propaganistas/Laravel-Phone/pull/283
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/6.0.3...6.1.0
Support Laravel 13 Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/6.0.2...6.0.3
Support Laravel 13
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/6.0.2...6.0.3
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fix mb_strtoupper(): Passing null deprecated errors by @ziming in https://github.com/Propaganistas/Laravel-Phone/pull/272
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/6.0.1...6.0.2
Nothing published for this version
This version has feature-parity with the last version of 5.x, but the codebase has been reworked because libphonenumber shifted from using class const
This version has feature-parity with the last version of 5.x, but the codebase has been reworked because libphonenumber shifted from using class constants to native enums. Most applications should be able to upgrade quite easily though, but no need to rush (see below). Read the upgrade guide for more information.
Additionally:
No. The last version of 5.x has been deliberately released to allow libphonenumber updates to be installed for a considerable period of time while staying on 5.x.
No, not for the (long?) time being. This package is quite feature-complete. You only need to upgrade if you want to use libphonenumber's enums or just want to stay ahead of things and be future-proof anyway.
…of time without having to account for semantic breaking changes.
libphonenumber v9.Note: this is the last minor/patch version in the v5 realm of this package.
libphonenumber shifted from using class constants to native enums. Conditional statements were added to achieve combined support for v8 and v9 while keeping Laravel-Phone as-is. This way, given that this package is quite feature-complete, updates on libphonenumber can still be installed for a considerable period of time without having to account for semantic breaking changes.
Starting from the next major version, Laravel-Phone will be reworked to fully harness the power of enums.
Added PhpDoc to casts for improved IDE-helper support (fixes #268 )
Added PhpDoc to casts for improved IDE-helper support (fixes #268 )
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.3.4...5.3.5
Laravel 12 support by @jonnott in https://github.com/Propaganistas/Laravel-Phone/pull/265
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.3.3...5.3.4
Update README.md by @siarheipashkevich in https://github.com/Propaganistas/Laravel-Phone/pull/257
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.3.2...5.3.3
Marking classes as internal to denote that they shouldn't be used publicly.
Marking classes as internal to denote that they shouldn't be used publicly.
Bugfix for #250 Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.3.0...5.3.1
Bugfix for #250
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.3.0...5.3.1
This is a non-breaking change for functionality provided by Laravel-Phone.
libphonenumber-for-php-lite instead of libphonenumber-for-php by @bperel in https://github.com/Propaganistas/Laravel-Phone/pull/248libphonenumber-for-php-lite is a lightweight drop-in replacement for libphonenumber-for-php which significantly reduces the package size being pulled in. libphonenumber-for-php-lite excludes geolocation, carrier information and short number info.
This is a non-breaking change for functionality provided by Laravel-Phone.
[!IMPORTANT]
If you have defined a macro, please review your code and if needed requiregiggsey/libphonenumber-for-phpas an explicit dependency in your project.
Added support for Laravel 11 Dropped support for Laravel 9 Dropped support for PHP 8.0
Added support for Laravel 11 Dropped support for Laravel 9 Dropped support for PHP 8.0
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.1.1...5.2.0
Added missing delimiter for the regular expression pattern by @DhPandya in https://github.com/Propaganistas/Laravel-Phone/pull/240
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.1.0...5.1.1
Sync validation translation with Laravel's "must" convention by @choowx in https://github.com/Propaganistas/Laravel-Phone/pull/220
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/5.0.3...5.1.0
The package now minimally requires PHP 8.0 and Laravel 9.0. It also supports Laravel 10. All documented behavior is preserved. There are just some min
The long-due codebase cleanup.
The package now minimally requires PHP 8.0 and Laravel 9.0. It also supports Laravel 10. All documented behavior is preserved. There are just some minor syntactical changes that might need your attention.
Please review the upgrade guide.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Bugfix for #213 - Support international numbers prefixed with country code
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.4.3...4.4.4
Bugfix for #213 - Support international numbers prefixed with country code
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.4.2...4.4.3 Bugfix: fixes #215
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.4.2...4.4.3
Bugfix: fixes #215
Update arrange namespaces by @sevannerse in https://github.com/Propaganistas/Laravel-Phone/pull/211
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.4.1...4.4.2
Fix validation by fetching countries from libphonenumber by @sevannerse in https://github.com/Propaganistas/Laravel-Phone/pull/210
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.4.0...4.4.1
Add equals() and notEquals() methods to PhoneNumber by @Propaganistas
equals() and notEquals() methods to PhoneNumber by @PropaganistasFull Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.3.8...4.4.0
[PHP 8.2] Fix ${var} string interpolation deprecation by @Ayesh in https://github.com/Propaganistas/Laravel-Phone/pull/198
${var} string interpolation deprecation by @Ayesh in https://github.com/Propaganistas/Laravel-Phone/pull/198Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.3.7...4.3.8
Fixed deprecation notices on PHP 8.1
Fixed deprecation notices on PHP 8.1
Nothing published for this version
Fix PHP8.1 deprecation warnings by @Propaganistas in https://github.com/Propaganistas/Laravel-Phone/pull/190
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.3.4...4.3.5
Improve auto detection validation
Improve auto detection validation
* Support league/iso3166 ^4.0
^4.0improved lenient parsing of phone numbers by @scybulski in https://github.com/Propaganistas/Laravel-Phone/pull/183
Full Changelog: https://github.com/Propaganistas/Laravel-Phone/compare/4.3.1...4.3.2
Nothing published for this version
Introduced two custom cast classes. See this section in the documentation.
Introduced two custom cast classes. See this section in the documentation.
Dropped support for Laravel 6, Laravel 7 and Laravel 8.0 - 8.8.
Nothing published for this version
Added the getRawNumber() method to PhoneNumber to retrieve the original raw number.
Added the getRawNumber() method to PhoneNumber to retrieve the original raw number.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Dropped support for Laravel 5.4 and below.
Dropped support for Laravel 5.4 and below.
Added support for Laravel 6. Since Laravel now follows semver, the package should be good to go for all future 6.x releases as well.
Bug fix: - #117 - Support mixed case country fields
Bug fix:
The PhoneNumber class is now macroable
New feature:
PhoneNumber class is now macroableHighly unexpected breaking change:
Bug fix:
Highly unexpected breaking change:
$types property of ParsesTypes, it is now renamed to $resolvedTypes.Bug fix: - #105 - Casting phone(null) to string results in __toString() PHP error.
Bug fix:
phone(null) to string results in __toString() PHP error.Because of the return type changes in PHPunit 8, support for PHP 7.0 needed to be dropped. Since this only affects the tests and the actual code is le
Buckle up for Laravel 5.8!
Because of the return type changes in PHPunit 8, support for PHP 7.0 needed to be dropped. Since this only affects the tests and the actual code is left untouched, you can safely use --ignore-platform-reqs if you're using 7.0.
Formatting a PhoneNumber instance now outputs a different exception message when a country was provided but is rather mismatched to the number.
Non-breaking change
Formatting a PhoneNumber instance now outputs a different exception message when a country was provided but is rather mismatched to the number.
Also added the getNumber() and getCountries() methods to NumberParseException
Non-breaking change: * #98 - Invalid validation parameters are now ignored instead of raising an InvalidParameterException. This won't affect previous
Non-breaking change:
InvalidParameterException. This won't affect previously defined validations. A cleanup of your exception handling could be applicable but is not mandatory.Changed julien-c/iso3166 dependency to league/iso3166.
Changed julien-c/iso3166 dependency to league/iso3166.
Nothing published for this version
Case insensitive validator parameters
Case insensitive validator parameters
Fixes #81 - Additionally check for the unsure type when applicable.
Bug fix:
Nothing published for this version
Prevent validator parameter hijacking through the country field
Enhancements
InvalidCountryExceptionBug fix
Nothing published for this version
* #65 - Use provided countries for additional international parsing (global region recognition)
Bug fix: - #60 - Throw an exception for an ambigious parameter
Bug fix:
Bug fix: * #58 - Re-enabled validation support for combining a custom country field, fallback countries and AUTO.
Bug fix:
AUTO.Catch the parent NumberParseException
Bug fix:
Exposed an expressive Rule class.
Overview
Breaking changes
Propaganistas\LaravelPhone\PhoneServiceProvider.libphonenumber is removed in favor of the new PhoneNumber utility class. If you really need the Facade, just create it yourself.false.Propaganistas\LaravelPhone\Exceptions\NumberParseException: when the number could not be parsed by libphonenumber (e.g. invalid country, no country, ...).Propaganistas\LaravelPhone\Exceptions\NumberFormatException: when an invalid phone format is provided.Propaganistas\LaravelPhone\Exceptions\CountryCodeException: when an invalid calling-from country is provided (formatForCountry() and formatForMobileDialingInCountry()).Auto-discover the Service Provider as of Laravel 5.5
Auto-discover the Service Provider as of Laravel 5.5
One column per quarter.