SanitizeFileNameEvent 

Example: Sanitize a file name with hyphens instead of underscores 

The following listener uses the original (unsanitized) file name to replace whitespace with hyphens and assigns the result as sanitized file name.

<?php

declare(strict_types=1);

namespace MyVendor\MyExtension\EventListener;

use TYPO3\CMS\Core\Attribute\AsEventListener;
use TYPO3\CMS\Core\Resource\Event\SanitizeFileNameEvent;

#[AsEventListener(
    identifier: 'my-extension/seo-friendly-filename',
)]
final readonly class SeoFriendlyFileNameListener
{
    public function __invoke(SanitizeFileNameEvent $event): void
    {
        $originalFileName = $event->getOriginalFileName();

        if (!str_contains($originalFileName, ' ')) {
            return;
        }
        // Apply custom logic based on the original file name
        $customFileName = str_replace(' ', '-', $originalFileName);

        $event->setFileName($customFileName);
    }
}

SanitizeFileNameEvent API 

class SanitizeFileNameEvent

Fully qualified name

\TYPO3\CMS\Core\Resource\Event\SanitizeFileNameEvent

This event is fired after a file name has been sanitized and before a file is added to FAL. Listeners can use this event to modify the file name, and name the file according to naming conventions of a specific project.

getFileName ( )

Returns

string

getOriginalFileName ( )

Returns

string

setFileName ( string $fileName)

param $fileName

the fileName

getTargetFolder ( )

Returns

\TYPO3\CMS\Core\Resource\Folder

getStorage ( )

Returns

\TYPO3\CMS\Core\Resource\ResourceStorage

getDriver ( )

Returns

\TYPO3\CMS\Core\Resource\Driver\DriverInterface