9.0.2

PHP Changes

• Make PhoneNumberUtil::UNKNOWN_REGION visible again (#691 - thanks @gsteel)
• Fix 32bit PHP issue in truncateLongNumber (#689)

Google v9.0.2 changes: Mar 27, 2025

Metadata changes:

• Updated phone metadata for region code(s): NR, US, UZ, ZA
• New geocoding data for country calling code(s): 1821 (en)
• Updated geocoding data for country calling code(s): 27 (en)
• Updated carrier data for country calling code(s):
  27 (en), 389 (en), 674 (en)
• Updated / refreshed time zone meta data.

9.0.1

PHP Changes

• Fix composer autoload dumping (giggsey/libphonenumber-for-php-lite#91 and #682)
• Use constants instead of static properties in PhoneNumberUtil

Google v9.0.1 changes: Mar 13, 2025

Metadata changes:

• Updated phone metadata for region code(s): AR, MM, SG, US, ZM
• Updated carrier data for country calling code(s):
  36 (en), 65 (en), 260 (en), 855 (en)

9.0.0

Google has bumped libphonenumber to v9 for Java compatibility reasons. We've taken this opportunity to make some improvements to this library.

Most projects can upgrade safely without requiring any code changes.

PHP Changes

• Minimum PHP version: Now 8.1+.
• Function & parameter types: All functions and parameters now have explicit type definitions.
• Backed Enums replace const classes:
  • Example: PhoneNumberType is now an enum instead of a class with constants.
  • If you previously referenced the constants directly, no changes are required.
  • If you stored constant values (integers), you'll need to use from() to load the corresponding enum.
• Metadata storage improvement:
  • Metadata is now stored directly in PHP classes instead of arrays.
  • This improves performance when loading metadata but does not affect usage.

Google v9.0.0 changes: Feb 27, 2025

Metadata changes:

• Updated alternate formatting data for country calling code(s): 385
• Updated phone metadata for region code(s):
  AR, BL, GF, GP, GY, HK, JP, MF, RE, SG, SL, SN, TJ, UG, VE, ZA
• Updated geocoding data for country calling code(s): 27 (en)
• Updated carrier data for country calling code(s):
  58 (en), 65 (en), 221 (en), 256 (en), 592 (en), 852 (en, zh), 992 (en)
• Updated / refreshed time zone meta data.

8.13.55

Google v8.13.55 changes: Feb 13, 2025

Metadata changes:

• Updated phone metadata for region code(s): BE, CZ, SR
• Updated short number metadata for region code(s): NO
• Updated carrier data for country calling code(s):
  33 (en), 41 (en), 255 (en), 351 (en), 503 (en), 597 (en)

8.13.54

Google v8.13.54 changes: Jan 29, 2025

Metadata changes:

• Updated phone metadata for region code(s): HK, ML, NC, PL, US
• New geocoding data for country calling code(s): 1274 (en)
• Updated carrier data for country calling code(s):
  41 (en), 48 (en), 51 (en), 223 (en), 268 (en), 852 (en, zh)
• Updated / refreshed time zone meta data.

8.13.53

Google v8.13.53 changes: Jan 13, 2025

Code changes:

• Fixed a bug where the extension was appended twice in formatOutOfCountryKeepingAlphaChars

Metadata changes:

• Updated phone metadata for region code(s):
  EH, IL, LV, MA, MK, MM, MU, PW, SO
• Updated carrier data for country calling code(s):
  90 (en), 92 (en), 212 (en), 229 (en), 252 (en), 351 (en), 371 (en), 389 (en),
  597 (en), 680 (en)
• Updated / refreshed time zone meta data.

8.13.52

Google v8.13.52 changes: Dec 11, 2024

Metadata changes:

• Updated phone metadata for region code(s):
  CA, DE, DK, IL, JP, KY, MN, UG, US, UZ
• Updated short number metadata for region code(s): DK
• Updated geocoding data for country calling code(s): 86 (en, zh), 1345 (en)
• Updated carrier data for country calling code(s):
  45 (en), 229 (en), 972 (en), 976 (en)
• Updated / refreshed time zone meta data.

8.13.51

Google v8.13.51 changes: Nov 28, 2024

Metadata changes:

• Updated phone metadata for region code(s):
  870, CA, GE, GF, GU, HK, HN, MQ, PM, RE, SN, SY, TG, US, YT
• New geocoding data for country calling code(s): 1327 (en), 1942 (en)
• Updated carrier data for country calling code(s):
  27 (en), 34 (en), 81 (en), 221 (en), 228 (en), 262 (en), 351 (en), 508 (en),
  594 (en), 596 (en), 852 (en, zh), 963 (en), 995 (en), 1671 (en)
• Updated / refreshed time zone meta data.

8.13.50

Google v8.13.50 changes: Nov 13, 2024

Metadata changes:

• Updated phone metadata for region code(s):
  AR, BJ, BL, FI, GE, GP, HR, MF, PL, SG
• Updated short number metadata for region code(s): BJ, FI
• Updated carrier data for country calling code(s):
  48 (en), 65 (en), 229 (en), 385 (en), 590 (en), 995 (en)

8.13.49

Google v8.13.49 changes: Oct 30, 2024

Metadata changes:

• Updated phone metadata for region code(s): CO, EE, MG, MQ, MV, PM, SG, TJ
• Updated short number metadata for region code(s): MQ, PM
• Updated geocoding data for country calling code(s): 960 (en)
• Updated carrier data for country calling code(s):
  65 (en), 372 (en), 596 (en), 992 (en)