Workflow/tasks/zip_entpacken.md

zip_entpacken — ZIP entpacken

Zweck: Entpackt ein ZIP in ein Verzeichnis und liefert die Liste der entpackten Dateien (mit Serverpfad) — nutzbar als Eingang für excel_lesen, word_lesen, geo_import. Zip-Slip-sicher (Einträge mit ../ / absoluten Pfaden werden entschärft, nichts landet außerhalb des Zielordners).

Parameter

Name	Pflicht?	Default	Beschreibung
datei	ja	—	Quell-ZIP (Serverpfad, {{…}} erlaubt).
ziel	nein	tmp/zip/entpackt_<uniq>	Zielverzeichnis.
output_var	nein	unzip	Ergebnis-Präfix.

Ausgangswerte

{{<prefix>_verzeichnis}} (Zielordner), {{<prefix>_dateien}} (Array [{name, pfad}]), {{<prefix>_pfade}} (Array nur Pfade), {{<prefix>_anzahl}}.

Beispiel

<task type="zip_entpacken" id="entpacken">
  <config><datei>{{upload_pfad}}</datei><output_var>up</output_var></config>
</task>

Danach steht {{up_dateien}} = [{name, pfad}] bereit (z.B. per loop_foreach über jede Datei iterieren und pfad an excel_lesen/word_lesen/geo_import geben) sowie {{up_verzeichnis}} und {{up_anzahl}}.

Hinweise

• Verzeichnisstruktur im ZIP bleibt erhalten (unterhalb ziel).
• Leere/unsichere Eintragsnamen werden übersprungen.
• Gegenstück: zip_erstellen.