Findet die Dateien in Ihrem Contao-Upload-Verzeichnis, auf die nichts mehr verweist — und belegt zu jeder Datei, warum sie als verwendet oder unbenutzt gilt. Mit ZIP-Export vor dem Löschen und Papierkorb danach.

 

Dateiaufräumen für Contao — mit Nachweis, nicht auf Verdacht.

Dieses Bundle bringt einen vollständigen Aufräum-Workflow ins Contao-Backend: scannen → belegen → sichern → löschen → wiederherstellen. Ein einziger Menüpunkt „File Inspector" mit Tab-Navigation bündelt alles. Der Scan läuft vollständig auf Ihrem Server, ohne externe Dienste.

Scannen

• Normaler Scan: rein datenbankbasiert — DCA-Dateiauswahlfelder in jeder tl_*-Tabelle (auch in Erweiterungen von Drittanbietern), Insert-Tags wie und , src/href-Attribute, CSS-url()-Aufrufe und einfache Upload-Pfade in Text-, Rich-Text- und Code-Feldern. Zeilenweise gestreamt, dadurch konstant niedriger Speicherbedarf auch bei sehr großen Inhaltstabellen.
• Deep Scan: zusätzlich der Quellcode Ihres Projekts — PHP, Twig, HTML, JS, TS, CSS, SCSS, Less, JSON, YAML, XML und SVG unter src/, templates/, config/, vendor/ und public/. Findet damit die Referenzen, die ein Datenbank-Scan strukturell nicht sehen kann: ein fest im Template hinterlegtes Hintergrundbild, ein Logo-Pfad im Controller, eine aus einem Stylesheet eingebundene Schriftdatei. (Pro)
• Transitive CSS-Ketten: @import, @use, @forward und url() werden über beliebig viele Stufen aufgelöst. Ein Partial, das nur von einem anderen Stylesheet eingebunden wird, gilt korrekt als verwendet statt als Löschkandidat. (Pro)
• Skalierbar: der Scan läuft in Stapeln von 500 Upload-Dateien bzw. 25 Quelldateien pro AJAX-Runde — mit echter Fortschrittsanzeige, ohne PHP-Timeouts, und das Backend bleibt währenddessen benutzbar. Eine Sperrdatei verhindert parallele Scans; nach einem Seiten-Neuladen wird der laufende Auftrag weiterverfolgt statt neu gestartet. (Pro)

Belegen

• Drei klare Status: Referenziert (mindestens eine bestätigte Referenz — nicht löschen), Unsicher (manuell prüfen) und Keine Referenzen gefunden (primärer Löschkandidat). Sortiert wird nach Handlungsbedarf, nicht alphabetisch.
• Nachweis-Ansicht: zu jeder einzelnen Referenz Typ, Ort und Beschreibung in Klartext — Datenbank, Template, CSS, PHP, Twig — statt interner Kennungen. Das macht aus „das Tool sagt, sie sei unbenutzt" eine begründbare Entscheidung.
• Verwendungs-Explorer: für jede Datei alle Fundstellen auf einen Blick — mit lesbarem Tabellennamen, dem Titel des verweisenden Datensatzes, dem Pfad durch die übergeordneten Datensätze (Seite → Artikel → Inhaltselement) und einer Bearbeiten-Schaltfläche, die genau diesen Datensatz öffnet. Template- und Quellcode-Referenzen werden nach Sprache gruppiert. Arbeitet auf einem gespeicherten Scan, ohne erneut zu scannen.
• Unsicher-Erkennung: vier benannte Gründe — bloßer Dateiname, Teilpfad ohne Verzeichnispräfix, Zusammensetzung zur Laufzeit, mehrdeutiger Treffer bei gleichnamigen Dateien. Jeweils mit Quelldatei, Zeilennummer, Code-Auszug und einer Erklärung in Klartext. Wird geraten? Nein — deshalb existiert dieser Status. (Pro)

Aufräumen

• Export & Löschen: in drei bewusst getrennten Schritten — ZIP erzeugen, herunterladen, erst danach das Löschen bestätigen. Ein Download kann so nie eine Löschung auslösen. Der Bestätigungsdialog nennt Anzahl und Gesamtgröße und hebt unsichere Dateien in der Auswahl eigens hervor. (Pro)
• Papierkorb statt Vernichtung: gelöschte Dateien werden verschoben und bleiben, bis Sie den Papierkorb selbst leeren — kein automatischer Verfall. Beim Wiederherstellen wird die Datei unter ihrer ursprünglichen Identität zurückgelegt, sodass jedes Inhaltselement, jede Galerie und jeder Download unverändert weiter funktionieren. Ist der Pfad inzwischen belegt: Ersetzen / Überspringen pro Datei, mit „für alle übernehmen".
• Sicherheitsnetz: jeder übermittelte Pfad wird auf Lage im Upload-Verzeichnis, Verzeichniswechsel und symbolische Links geprüft — und zwar erneut unmittelbar vor jedem einzelnen Dateivorgang, nicht nur einmal pro Stapel. Maximal 500 Dateien pro Vorgang, alle Schreibvorgänge atomar, jede Löschung mit Zeitstempel, Bearbeiter und Pfad protokolliert.
• Ignorierregeln: Ordner und Dateiendungen vollständig aus allen Scans ausnehmen, exakt oder per Glob-Muster. Voreingestellt sind die Ordner archive, backup, import, old, legacy und die Endungen php, phar, phtml. (Pro)

Optimieren

• CSS/JS minifizieren: direkt am ursprünglichen Pfad, ohne .min.css-Geschwisterdateien, die anschließend neu eingebunden werden müssten. Entfernt werden ausschließlich Leerraum und Kommentare — keine Umbenennung von Variablen, keine verhaltensändernden Umformungen. Vor jedem Überschreiben wird das Original gesichert; nicht weiter verkleinerbare Dateien bleiben unangetastet und werden als übersprungen ausgewiesen. (Pro)
• Bilder konvertieren: nach WebP, AVIF oder ICO — aus JPEG, PNG, GIF, WebP, BMP oder SVG. Das Original wird nie verändert, eine bereits vorhandene Zieldatei nie überschrieben. Verwendet werden ausschließlich die Bild-Erweiterungen Ihres eigenen PHP, kein externer Prozess. Kombinationen, die Ihr Server nicht erzeugen kann, erscheinen deaktiviert mit Begründung, statt mitten im Stapel zu scheitern. (Pro)

Nachvollziehen

• Scan-Verlauf: jeder Scan wird automatisch mit Modus, Datum, Dauer und Ergebnisübersicht gespeichert und lässt sich später vollständig erneut öffnen — ohne neu zu scannen. Ideal für den Vergleich vor und nach einer Aufräumaktion. Die letzten 50 Scans bleiben erhalten; zusätzlich ist eine altersbasierte automatische Bereinigung einstellbar. (Pro: Bereinigung und Aufbewahrungsregel)
• Eigene Protokolle für Löschungen, Minifizierungen und Bildkonvertierungen — jeweils mit Vorgang, Ergebnis, Zeitpunkt und betroffenen Pfaden.

Free und Pro

Die kostenlose Version scannt Ihre Datenbank, zeigt zu jeder Datei den vollständigen Verwendungsnachweis, führt den Scan-Verlauf und stellt aus dem Papierkorb wieder her. Die Pro-Version ergänzt Deep Scan, Unsicher-Erkennung, Export & Löschen, Hintergrund-Scan, Ignorierregeln, Verlaufsbereinigung, Minifizieren und Bildoptimierung. Kurz: mit Free verstehen Sie Ihr Upload-Verzeichnis, mit Pro handeln Sie.

Voraussetzungen und Installation

Contao 5.3+, PHP 8.2+, Symfony 6.4 oder 7.0. PHP-Erweiterungen curl, pdo und sodium (in aktuellen Installationen Standard), zusätzlich zip für Export & Löschen und gd für die Bildoptimierung. Reines Backend-Modul: keine Frontend-Module, keine Inhaltselemente, keine Eingriffe in Ihre Templates. Oberfläche in Deutsch und Englisch.

Installation über composer require vtinnovations/file-inspector und anschließend php bin/console contao:migrate. Die Erweiterung registriert sich über den Contao Manager selbst; weisen Sie das Modul danach wie gewohnt Ihren Backend-Benutzergruppen zu. Sie finden es unter System › File Inspector.

Lizenz

Eine aktivierte Lizenz ist für jede Version erforderlich, auch für Free — die Aktivierung der kostenlosen Version ist kostenfrei. Eine Lizenz ist an die exakten Domains gebunden, die auf den Startseiten Ihrer Installation eingetragen sind: example.com und www.example.com gelten als zwei verschiedene Domains, und eine Installation ohne eingetragene Domain kann nicht aktiviert werden. Die Verwaltung erfolgt unter Contao › Einstellungen.

Ehrliche Abgrenzung

„Keine Referenzen gefunden" heißt: in den durchsuchten Quellen wurde keine Referenz gefunden — nicht, dass eine Datei garantiert nirgends verwendet wird. Zur Laufzeit zusammengesetzte Pfade und Referenzen in externen Systemen entziehen sich jeder statischen Analyse. Genau dafür existiert der Status Unsicher, und genau darum ist „Export vor dem Löschen" der Standardweg. Ein normaler Scan liest keine Quelldateien; der Deep Scan überspringt einzelne Quelldateien über 5 MiB und weist sie im Bericht aus. Legen Sie immer ein Backup an.