FileUtils::slugifyFilename Slugify and normalize filename + tests

CHANGELOG.md

@@ -1,5 +1,9 @@
 CHANGELOG for 1.x
 ===================
+## v1.14.4 - (2025-06-24)
+### Added
+- `FileUtils::slugifyFilename` Slugify and normalize filename + tests
+
 ## v1.14.3 - (2025-03-06)
 ### Fixed
 - `ProcessMonitor::logException` switch $e param type from `\Exception` to `\Throwable` to better handle lower level error log (such as undefined method, ...) 

src/Utils/FileUtils.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Smart\CoreBundle\Utils;
+
+use Symfony\Component\String\Slugger\AsciiSlugger;
+
+class FileUtils
+{
+    /**
+     * Slugify and normalize filename
+     */
+    public static function slugifyFilename(string $fileName): string
+    {
+        $slugger = new AsciiSlugger('fr');
+
+        $extension = pathinfo($fileName, PATHINFO_EXTENSION);
+        $baseName = pathinfo($fileName, PATHINFO_FILENAME);
+        $slugifiedBase = $slugger->slug($baseName)->lower()->toString();
+
+        if (!empty($extension)) {
+            $downloadFileName = $slugifiedBase . '.' . strtolower($extension);
+        } else {
+            $downloadFileName = $slugifiedBase;
+        }
+
+        return $downloadFileName;
+    }
+}

tests/Utils/FileUtilsTest.php

@@ -0,0 +1,50 @@
+<?php
+
+namespace Smart\CoreBundle\Tests\Utils;
+
+use Smart\CoreBundle\Utils\FileUtils;
+use PHPUnit\Framework\TestCase;
+
+/**
+ * vendor/bin/simple-phpunit tests/Utils/FileUtilsTest.php
+ */
+class FileUtilsTest extends TestCase
+{
+    /**
+     * @dataProvider slugifyFilenameProvider
+     */
+    public function testSlugifyFilename(string $expected, string $filename): void
+    {
+        $this->assertSame($expected, FileUtils::slugifyFilename($filename));
+    }
+
+    public function slugifyFilenameProvider(): array
+    {
+        return [
+            'basic' => [
+                // expected
+                'smartcore.pdf',
+                // filename
+                'smartcore.pdf',
+            ],
+            'with_ascii_issue' => [
+                // expected
+                'smartcore.pdf',
+                // filename
+                'smàrtcôre.pdf',
+            ],
+            'with_space' => [
+                // expected
+                'smart-core.pdf',
+                // filename
+                'smart core.pdf',
+            ],
+            'without_extension' => [
+                // expected
+                'smartcore',
+                // filename
+                'smartcôre',
+            ],
+        ];
+    }
+}