[6.x] Ability to add to the filename replacements list (#14316)

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Jason Varga <jason@pixelfear.com>

Author: 3 people

config/assets.php

@@ -207,6 +207,19 @@
 
     'additional_uploadable_extensions' => [],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Additional Filename Character Replacements
+    |--------------------------------------------------------------------------
+    |
+    | When uploading files, certain characters in filenames will be replaced
+    | to ensure a safe filename. You may configure additional replacements.
+    | These are in addition to the native ones. They are not overridable.
+    |
+    */
+
+    'additional_filename_replacements' => [],
+
     /*
     |--------------------------------------------------------------------------
     | SVG Sanitization

src/Assets/AssetUploader.php

@@ -80,7 +80,7 @@ protected function getNewExtension()
 
     public static function getSafeFilename($string)
     {
-        $replacements = [
+        $replacements = array_merge(config('statamic.assets.additional_filename_replacements', []), [
             ' ' => '-',
             '#' => '-',
             ':' => '-',
@@ -95,7 +95,7 @@ public static function getSafeFilename($string)
             '%' => '-',
             "'" => '-',
             '--' => '-',
-        ];
+        ]);
 
         return (string) Str::of(urldecode($string))
             ->replace(array_keys($replacements), array_values($replacements))

tests/Assets/AssetUploaderTest.php

@@ -11,8 +11,9 @@ class AssetUploaderTest extends TestCase
 {
     #[Test]
     #[DataProvider('filenameReplacementsProvider')]
-    public function it_gets_safe_filename($originalFilename, $expectedFilename)
+    public function it_gets_safe_filename($originalFilename, $expectedFilename, $config = [])
     {
+        config(['statamic.assets.additional_filename_replacements' => $config]);
         $this->assertEquals($expectedFilename, AssetUploader::getSafeFilename($originalFilename));
     }
 
@@ -34,6 +35,25 @@ public static function filenameReplacementsProvider()
             'single quote' => ["one'two'three.jpg", 'one-two-three.jpg'],
             'double dash' => ['one--two--three.jpg', 'one-two-three.jpg'],
             'ascii' => ['fòô-bàř', 'foo-bar'],
+            'additional config' => [
+                'one,two(6)',
+                'onetwo6',
+                [
+                    ',' => '',
+                    '(' => '',
+                    ')' => '',
+                ],
+            ],
+            'additional config does not override native replacements' => [
+                'one,two%three-(6)',
+                'onetwo-three-6',
+                [
+                    ',' => '',
+                    '(' => '',
+                    ')' => '',
+                    '%' => '_',
+                ],
+            ],
         ];
     }
 }