Use libphonenumber library to normalize customer phone number

Author: beesaferoot

src/backend/app/Helpers/PhoneNumberNormalizer.php

@@ -2,10 +2,12 @@
 
 namespace App\Helpers;
 
+use Propaganistas\LaravelPhone\PhoneNumber;
+
 class PhoneNumberNormalizer {
     /**
-     * Normalize a phone number to canonical format: +<digits only>.
-     * Strips spaces, hyphens, parentheses, dots, and other non-digit characters.
+     * Normalize a phone number to E.164 format using libphonenumber.
+     * Trims whitespace, prepends '+' if missing, then formats via PhoneNumber::formatE164().
      */
     public static function normalize(?string $phone): ?string {
         if ($phone === null || trim($phone) === '') {
@@ -14,12 +16,11 @@ public static function normalize(?string $phone): ?string {
 
         $phone = trim($phone);
         $hasPlus = str_starts_with($phone, '+');
-        $digits = preg_replace('/\D/', '', $phone);
 
-        if ($digits === '' || $digits === null) {
-            return null;
-        }
+        $phone = $hasPlus ? $phone : '+'.$phone;
+
+        $phoneNumber = new PhoneNumber($phone);
 
-        return $hasPlus ? '+'.$digits : '+'.$digits;
+        return $phoneNumber->formatE164();
     }
 }

src/backend/composer.json

@@ -28,6 +28,7 @@
     "parsecsv/php-parsecsv": "^1.3",
     "phpoffice/phpspreadsheet": "^1.7",
     "predis/predis": "^1.1.7",
+    "propaganistas/laravel-phone": "^6.0",
     "pusher/pusher-php-server": "^7.0",
     "spatie/geocoder": "^3.14",
     "spatie/laravel-backup": "^9.0",