numero2/contao-proper-filenames

Replaces special characters in filenames right after upload

v2.2.4 2026-02-11 14:59 UTC

Requires

• php: >=8.0
• ausi/slug-generator: ^1.1
• contao/core-bundle: ^4.13 || ^5.0
• doctrine/dbal: ^3.6 || ^4.3
• symfony/config: ^5.4 || ^6.4 || ^7.4
• symfony/console: ^5.4 || ^6.4 || ^7.0
• symfony/dependency-injection: ^5.4 || ^6.4 || ^7.0
• symfony/filesystem: ^5.4 || ^6.4 || ^7.4
• symfony/http-foundation: ^5.4 || ^6.4 || ^7.4
• symfony/http-kernel: ^5.4 || ^6.4 || ^7.4
• symfony/routing: ^5.4 || ^6.4 || ^7.4
• symfony/translation-contracts: ^2.3 || ^3.0

Requires (Dev)

• contao/manager-plugin: ^2.0
• shipmonk/composer-dependency-analyser: ^1.4

Conflicts

• contao/core: *
• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• numero2 - Agentur für digitales Marketing GbR

README

About

Sanitizes the filenames of files uploaded via the Contao file manager or Contao form. Read more

System requirements

• Contao 4.13 or newer

Installation & Configuration

• Install via Contao Manager or Composer (composer require numero2/contao-proper-filenames)
• In the Backend go to System Settings and click Check filenames under Upload settings
• Configure how the filenames should be renamed by choosing an option from Valid filename characters

Commands

Recursively sanitize all files and folders in a given directory.

contao-console contao:proper-filenames:sanitize myfolder -r

The extension only analyzes files that are stored in Contao's DBAFS (tl_files). The DBAFS should be synchronized before the call - either via the File manager in the Backend or with the following console call:

contao-console contao:filesync

To get a preview of how everything will be renamed there is also a --dry-run flag. For all available flags and options see the help using contao-console contao:proper-filenames:sanitize --help.