Zum Inhalt springen

Auto Sync Files - externe Dateien per Scheduler lokal aktuell halten

Erstellt am 23. Oktober 2026 · Noch keine Antworten

Tags: TYPO3 13, TYPO3 14, Info

Sebastian Schmal ·

Hallo zusammen,

wir möchten euch unsere Extension Auto Sync Files vorstellen. Sie ist bei Version 14.0.2 angekommen und läuft auf TYPO3 13.4 LTS und TYPO3 14.3 LTS – aus einer gemeinsamen Codebasis, mit PHP 8.2+.

Die Extension lädt externe Dateien regelmäßig über den TYPO3-Scheduler herunter und legt sie in eurem Webspace ab. So liegt immer die aktuelle Version lokal bereit – z. B. für besseres Caching oder um externe Skripte selbst auszuliefern.

Zwei Scheduler-Tasks

  • Nur herunterladen: eine einzelne Datei laden und lokal speichern (z. B. gtag.js von Google Analytics oder eine CSS-Datei eines Anbieters). Die lokale Datei wird nur ersetzt, wenn sich der Inhalt geändert hat.
  • Herunterladen & entpacken: ein Archiv (ZIP, TAR, TAR.GZ) laden, entpacken und in einen Zielordner übernehmen – wahlweise zusätzlich zu den vorhandenen Dateien (Standard) oder als vollständiger Ersatz des Ordnerinhalts.

Was die Extension mitbringt

  • Nur bei echten Änderungen: SHA-256-Vergleich – unveränderte Dateien und Archive werden übersprungen, die Frontend-Caches werden nur dann geleert (abschaltbar)
  • Sicheres Entpacken: erst in einen temporären Ordner, jede Datei wird geprüft (bei ZIP Größe und CRC32). Ein kaputtes oder unvollständiges Archiv lässt den Zielordner unverändert, der nächste Lauf versucht es erneut
  • Schutzmechanismen: nur http/https-Downloads, der Zielpfad muss im Webroot liegen, Schutz gegen „Zip Slip“, der Ersetzen-Modus ist für den Webroot selbst und typo3temp/ gesperrt
  • Speicherschonend: Downloads werden direkt in eine Datei gestreamt, auch große Archive brauchen kaum Arbeitsspeicher
  • Formulare im Stil des TYPO3-13/14-Backends, Oberfläche auf Deutsch und Englisch

Installation

composer require id/auto-sync-files

oder über das TER. Danach unter System > Scheduler einen neuen Task „Auto Sync Files: Nur herunterladen“ bzw. „Auto Sync Files: Herunterladen & entpacken“ anlegen, URL und Zielpfad eintragen – fertig. Ein Beispiel zum lokalen Hosten von Google Analytics (gtag.js) steht in der README.

Tipps

  • Für den Ersetzen-Modus immer einen eigenen Unterordner verwenden – dessen Inhalt wird bei jedem neuen Archiv komplett ausgetauscht.
  • Beim Core-Upgrade von 13.4 auf 14.3 zuerst die Extension aktualisieren und danach den Upgrade-Assistenten für die Scheduler-Tasks ausführen. Die Schritte stehen in der README.
  • Hinweis zu TYPO3 14: Die Tasks nutzen noch die klassische Scheduler-Registrierung. Das funktioniert, TYPO3 14 schreibt dafür aber Deprecation-Hinweise ins Log. Die Umstellung auf die neuen Task-Typen folgt vor TYPO3 v15.

Links

Über Feedback, Fehlermeldungen und Wünsche freuen wir uns – gerne hier im Thread oder direkt als Issue auf GitHub.

Viele Grüße
Sebastian