✨ Compatibility

• Compatibility with libphonenumber-for-php v9

💥 BC breaks

• Dropped compatibility with libphonenumber-for-php v7 and v8

💥 BC breaks

• The PhoneNumberParseException constructor now takes a libphonenumber\NumberParseException instance

This change is unlikely to affect you, unless you're throwing PhoneNumberParseException instances yourself.

✨ New features

• PhoneNumberParseException now has a $errorType property which contains a PhoneNumberParseErrorType enum
• New methods:
  • PhoneNumber::formatForMobileDialing()
  • PhoneNumber::getCarrierName()
  • PhoneNumber::getTimeZones()

💥 BC breaks

• Minimum PHP version is now 8.1
• PhoneNumberType and PhoneNumberFormat are now native PHP enums

💥 BC breaks

• Minimum PHP version is now 7.4

✨ Improvements

• Static analysis: Psalm & PHPStan -compatible annotations for PhoneNumberType and PhoneNumberFormat constants

✨ New features

• PhoneNumber::getDescription()

💥 BC breaks

• The following classes are now final:
  • PhoneNumber
  • PhoneNumberFormat
  • PhoneNumberParseException
  • PhoneNumberType

✨ New features

• PhoneNumber::isEqualTo()
• PhoneNumber now implements JsonSerializable

💥 BC breaks

• The library now requires the json extension (always available as of PHP 8.0)

✨ New method: PhoneNumber::getGeographicalAreaCode()

New method: PhoneNumber::isPossibleNumber()

Thanks @xificurk

Minimum PHP version is now 7.1.