Merge pull request #17 from ginkelsoft-development/fix/require-intl-extension

fix: require intl extension for consistent normalization

Author: ginkelsoft-development

composer.json

@@ -20,7 +20,8 @@
   ],
   "require": {
     "php": "^8.1 || ^8.2 || ^8.3 || ^8.4",
-    "illuminate/support": "^9.0 || ^10.0 || ^11.0 || ^12.0"
+    "illuminate/support": "^9.0 || ^10.0 || ^11.0 || ^12.0",
+    "ext-intl": "*"
   },
   "require-dev": {
     "phpunit/phpunit": "^9.5.10 || ^10.0 || ^11.0",

src/Support/Normalizer.php

@@ -20,8 +20,11 @@
  *
  * Features:
  * - Lowercases all text (UTF-8 safe)
- * - Optionally removes diacritics using PHP’s Normalizer (if available)
+ * - Removes diacritics using PHP's intl extension (required)
  * - Strips all non-alphanumeric characters
+ *
+ * Requirements:
+ * - The intl PHP extension must be installed for consistent normalization
  */
 class Normalizer
 {
@@ -44,11 +47,9 @@ public static function normalize(?string $v): ?string
         // Convert to lowercase (UTF-8 safe)
         $s = mb_strtolower($v, 'UTF-8');
 
-        // Optionally remove diacritics if intl extension is available
-        if (class_exists(\Normalizer::class)) {
-            $s = \Normalizer::normalize($s, \Normalizer::FORM_D);
-            $s = preg_replace('/\p{M}/u', '', $s); // strip diacritics
-        }
+        // Remove diacritics using intl extension
+        $s = \Normalizer::normalize($s, \Normalizer::FORM_D);
+        $s = preg_replace('/\p{M}/u', '', $s); // strip diacritics
 
         // Retain only letters and digits
         $s = preg_replace('/[^a-z0-9]/u', '', $s);