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.jsvon 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
- TER: https://extensions.typo3.org/extension/auto_sync_files
- Packagist: https://packagist.org/packages/id/auto-sync-files
- GitHub (Doku, Issues): https://github.com/ingeniumdesign/auto_sync_files
Über Feedback, Fehlermeldungen und Wünsche freuen wir uns – gerne hier im Thread oder direkt als Issue auf GitHub.
Viele Grüße
Sebastian