[12.x] Add ability to deduplicate multiple characters with a single Str::deduplicate call (#56548)

WendellAdriel · taylorotwell · web-flow · commit fc4cef42f1ea · 2025-08-05T08:29:13.000-05:00
* Add ability to deduplicate multiple characters with a single call

* Updating to use array_reduce

* Update method docblock

* Update Str.php

---------

Co-authored-by: Taylor Otwell &lt;taylor@laravel.com&gt;
diff --git a/src/Illuminate/Support/Str.php b/src/Illuminate/Support/Str.php
@@ -371,12 +371,20 @@ public static function convertCase(string $string, int $mode = MB_CASE_FOLD, ?st
      * Replace consecutive instances of a given character with a single character in the given string.
      *
      * @param  string  $string
-     * @param  string  $character
+     * @param  array<string>|string  $characters
      * @return string
      */
-    public static function deduplicate(string $string, string $character = ' ')
+    public static function deduplicate(string $string, array|string $characters = ' ')
     {
-        return preg_replace('/'.preg_quote($character, '/').'+/u', $character, $string);
+        if (is_string($characters)) {
+            return preg_replace('/'.preg_quote($characters, '/').'+/u', $characters, $string);
+        }
+
+        return array_reduce(
+            $characters,
+            fn ($carry, $character) => preg_replace('/'.preg_quote($character, '/').'+/u', $character, $carry),
+            $string
+        );
     }
 
     /**
diff --git a/tests/Support/SupportStrTest.php b/tests/Support/SupportStrTest.php
@@ -482,6 +482,7 @@ public function testDedup()
         $this->assertSame('what', Str::deduplicate('whaaat', 'a'));
         $this->assertSame('/some/odd/path/', Str::deduplicate('/some//odd//path/', '/'));
         $this->assertSame('ムだム', Str::deduplicate('ムだだム', 'だ'));
+        $this->assertSame(' laravel forever ', Str::deduplicate(' laravell    foreverrr  ', [' ', 'l', 'r']));
     }
 
     public function testParseCallback()

Original file line number	Diff line number	Diff line change
`@@ -482,6 +482,7 @@ public function testDedup()`
`482`	`482`	`$this->assertSame('what', Str::deduplicate('whaaat', 'a'));`
`483`	`483`	`$this->assertSame('/some/odd/path/', Str::deduplicate('/some//odd//path/', '/'));`
`484`	`484`	`$this->assertSame('ムだム', Str::deduplicate('ムだだム', 'だ'));`
	`485`	`+ $this->assertSame(' laravel forever ', Str::deduplicate(' laravell foreverrr ', [' ', 'l', 'r']));`
`485`	`486`	`}`
`486`	`487`
`487`	`488`	`public function testParseCallback()`