Disable automatic workflow triggers; manual runs only

.github/workflows/lint.yml

@@ -1,8 +1,7 @@
 name: Syntax Check
 
 on:
-  push:
+  workflow_dispatch:
-  pull_request:
 
 jobs:
   php-syntax:

CURRENT_STATUS.md

@@ -2,13 +2,11 @@
 
 ## Version
 
-**Bratonien Tools 9.7.1.0**
+**Bratonien Tools 0.9.6.2**
-
-Zielplattform der produktiven NC-Connector-Synchronisierung ist derzeit **Piwigo 16.4.0**.
 
 ## NC Connector
 
-Der NC Connector besitzt einen produktiven Verbindungsweg: **Nextcloud per WebDAV**.
+Der NC Connector besitzt nur noch einen produktiven Verbindungsweg: **Nextcloud per WebDAV**.
 
 ### Verbindungsmodell
 
@@ -16,92 +14,30 @@ Der NC Connector besitzt einen produktiven Verbindungsweg: **Nextcloud per WebDA
 - `source_mode=webdav-placeholder`
 - Nextcloud-Adresse, Benutzer und Passwort/App-Passwort werden pro Verbindung verschlüsselt gespeichert.
 - Piwigo-API und Benutzername/Passwort-Fallback werden ebenfalls pro Verbindung gespeichert.
-- Der Assistent zeigt ausschließlich Verzeichnisse, auf die der angemeldete Nextcloud-Benutzer per WebDAV zugreifen kann.
+- Der Assistent zeigt ausschließlich die Verzeichnisse, auf die der angemeldete Nextcloud-Benutzer per WebDAV zugreifen kann.
-- Ein leerer `webdav_path` ist ein gültiger Root und bedeutet den Dateibereich des authentifizierten Nextcloud-Benutzers.
+- Mehrere Verzeichnisse können pro Verbindung ausgewählt werden.
-
-### Root-Verhalten
-
-Bei `webdav_path=""` wird die technische Nextcloud-Benutzerebene nicht als Piwigo-Album angelegt.
-
-Direkte Unterordner des Nextcloud-Benutzerroots werden als Top-Level-Piwigo-Alben gespiegelt. Direkt im Root liegende Einzelbilder verbleiben auf Root-Ebene des verbindungseigenen Shadow Trees und werden durch die bestehende Orphan-Logik behandelt.
-
-Es gibt keine fest verdrahteten Album-Namen.
 
 ### Laufzeit
 
-Der gemeinsame Runner verarbeitet WebDAV-Verbindungen in dieser Reihenfolge:
+Der gemeinsame Runner verarbeitet ausschließlich WebDAV-Verbindungen:
 
 1. `runtime/reconcile-webdav.php`
-2. `runtime/repair-webdav-orphans.php`
+2. `runtime/cleanup-webdav-piwigo.php`
-3. `runtime/cleanup-webdav-piwigo.php`
+3. `runtime/sync-webdav.sh` für jede vorhandene WebDAV-Konfiguration
-4. `runtime/sync-webdav.sh` für jede vorhandene WebDAV-Konfiguration
 
 Die verbindungsspezifischen Runtime-Konfigurationen liegen unter `/etc/bratonien-tools/nc-connector/`. Zustandsdaten liegen unter `/var/lib/bratonien-tools/nc-connector/connection-ID`.
 
-Der Reconcile- und Shell-Pfad unterstützt den leeren WebDAV-Root ausdrücklich und gibt ihn als `--root ""` an den Platzhalter-Builder weiter.
+### Shadow Tree und Piwigo
 
-### Platzhalterquelle, Metadaten und Shadow Tree
+`runtime/lib/build_webdav_placeholder_source.py` bildet die ausgewählten Nextcloud-Inhalte als lokale Platzhalterquelle ab. `runtime/lib/shadow_tree.py` erzeugt daraus die Dateisystemstruktur, die Piwigo als physische Site sieht.
 
-`runtime/lib/build_webdav_placeholder_source.py` bildet die Nextcloud-Inhalte als lokale Platzhalterquelle ab. Für Bilder existieren physische 1×1-Platzhalterdateien; die Originale werden dabei nicht dauerhaft heruntergeladen.
+Jede WebDAV-Verbindung besitzt ihre eigene Piwigo-Site. `runtime/lib/piwigo-sync.php` übergibt genau diese Site an `bratonien.nc.syncProductive` und `bratonien.nc.syncOrphans`. Es gibt keinen zusätzlichen Sync auf Site 1.
 
-Der WebDAV-Scan übernimmt zusätzlich die von Nextcloud gelieferten Bildmaße aus `nc:metadata-photos-size`. `width`, `height` und `fileid` werden im `webdav-map.json` geführt. Nach dem normalen Piwigo-Dateisync überträgt `runtime/lib/sync-webdav-metadata.php` die Originalmaße in `piwigo_images`, damit Piwigo seine Derivatgrößen und Lazy-Loading-Geometrie auf Basis der echten Bildabmessungen berechnet.
+Der Shadow Tree dient ausschließlich dazu, Piwigo die Alben und Bilder als Dateisystemstruktur bereitzustellen. Albumlogik, Dateisynchronisierung und die daraus folgenden Piwigo-Datensätze bleiben Aufgabe von Piwigo.
-
-`runtime/lib/shadow_tree.py` erzeugt atomar die Dateisystemstruktur, die Piwigo als physische Site sieht. Shadow-Verzeichnisse werden so angelegt, dass der Webserver die für die On-Demand-Materialisierung nötigen Dateisystemoperationen ausführen kann.
-
-Jede WebDAV-Verbindung besitzt ihre eigene Piwigo-Site. Es gibt keinen zusätzlichen Sync auf Site 1.
-
-### Piwigo-Synchronisierung
-
-`runtime/lib/piwigo-sync.php` bevorzugt `bratonien.nc.syncProductive` für Piwigo 16.4.0. Wenn für die Verbindung keine Piwigo-API eingerichtet ist, wird der gespeicherte Administrator-/Webmaster-Benutzername/Passwort-Fallback verwendet und Piwigos nativer `site_update` ausgeführt.
-
-Danach wird `bratonien.nc.syncOrphans` für die konkrete WebDAV-Site ausgeführt.
-
-Der Shadow Tree stellt Piwigo ausschließlich die physische Album-/Bildstruktur bereit. Albumdatensätze, Bilddatensätze, Bild-Kategorie-Verknüpfungen und Piwigo-Derivate bleiben Aufgabe von Piwigo.
-
-### On-Demand-Materialisierung und Derivaterzeugung
-
-`include/webdav_materialize_runtime.inc.php` löst aus dem Piwigo-Bildpfad die konkrete Verbindung, den ausgewählten Nextcloud-Root, den relativen WebDAV-Pfad sowie die Mapping-Metadaten `fileid`, `width`, `height`, MIME-Typ, Größe und ETag auf.
-
-Für ein noch nicht vorhandenes Derivat läuft `webdav-derivative.php`:
-
-1. Zugriffsprüfung für das Piwigo-Bild;
-2. Auswahl einer temporären Nextcloud-Quelle;
-3. temporäres Bereitstellen dieser Quelle am exakten von Piwigo erwarteten Quellpfad;
-4. Erzeugung des normalen Piwigo-Derivats mit Piwigos eigener `pwg_image`-/Derivative-Logik im selben PHP-Prozess;
-5. Wiederherstellung des Shadow-/Platzhalterzustands;
-6. Auslieferung des Piwigo-Derivats.
-
-Ein interner HTTP-Self-Request auf `i.php` wird nicht mehr verwendet. Damit wird kein zusätzlicher PHP-FPM-Worker pro Derivaterzeugung benötigt.
-
-Für die erste Preview-Stufe verwenden ausschließlich `custom:s9999x250` und `standard:square` den authentifizierten Nextcloud-Endpunkt `/core/preview` anhand der Nextcloud-`fileid`. Die Preview wird mit etwa doppelter benötigter Piwigo-Auflösung und erhaltenem Seitenverhältnis angefordert. Die Berechnung berücksichtigt das Original-Seitenverhältnis, damit auch Crop-Derivate genügend Pixel erhalten. Varianten mit Bildrotation werden in dieser Stufe nicht über Preview erzeugt.
-
-Ist keine geeignete Preview planbar oder schlägt der Preview-Abruf fehl, fällt der Gate automatisch auf den vollständigen WebDAV-Originaldownload zurück. Große/originale Anforderungen verwenden weiterhin die Originalquelle.
-
-Die temporäre Preview bzw. das temporäre Original wird nach der Derivaterzeugung entfernt. Das fertige Derivat verbleibt ausschließlich in Piwigos normalem `_data/i`-Cache. Der Connector führt keinen parallelen permanenten Derivat-Cache.
-
-### Orphan-Logik
-
-Direkt im WebDAV-Site-Root liegende Bilder werden nicht künstlich in ein Album gezwungen. Sie werden durch `bratonien.nc.syncOrphans` als Piwigo-Orphans synchronisiert.
-
-`runtime/repair-webdav-orphans.php` läuft vor den verbindungsspezifischen Syncs und repariert historische WebDAV-Orphan-Zustände.
-
-### Private Top-Level-Alben
-
-Da die technische Nextcloud-Benutzerebene nicht mehr als Elternalbum existiert, können WebDAV-Unterordner echte private Top-Level-Piwigo-Alben sein. Beim Connector-Fallback-Sync sorgt `bratonien_tools_preserve_connector_top_level_access()` dafür, dass der verwendete Piwigo-Administrator auf diese privaten Top-Level-Alben zugreifen kann. Nach Änderungen wird der Benutzer-Cache invalidiert.
-
-Die allgemeine bestehende Funktion `bratonien_tools_preserve_private_album_access()` in `include/album_shares.inc.php` bleibt davon getrennt.
-
-### Administrations-Dashboard
-
-Piwigo 16.4.0 zeigt die Album-Kachel im Standardtemplate nur bei `NB_ALBUMS > 1` an. Dadurch verschwand die Kachel nach dem korrekten Entfernen der künstlichen Nextcloud-Benutzerebene, sobald nur noch ein echtes Album vorhanden war.
-
-Bratonien Tools setzt für die Verwaltungsübersicht einen Template-Prefilter und ändert ausschließlich diese Anzeigebedingung auf `NB_ALBUMS > 0`. Die Albumzahl selbst stammt weiterhin unverändert aus Piwigos `get_pwg_general_statitics()`.
 
 ### Bildauslieferung
 
-Fehlende Piwigo-Derivate werden durch den On-Demand-Gate erzeugt. Bereits vorhandene Derivate werden direkt aus Piwigos eigenem Derivat-Cache ausgeliefert.
+Die Dateien im Shadow Tree sind Platzhalter. `include/webdav_image_runtime.inc.php` erkennt die WebDAV-Zuordnung und ersetzt die Bildquelle bei der Auslieferung durch den zugehörigen Nextcloud-Inhalt. `webdav-image.php` streamt die Bilddaten serverseitig, ohne Nextcloud-Zugangsdaten an den Browser weiterzugeben.
-
-Für direkte Originalanforderungen existiert weiterhin die serverseitige WebDAV-Originalauslieferung. Nextcloud-Zugangsdaten werden dem Browser nicht offengelegt.
 
 ### Löschen
 
@@ -109,38 +45,18 @@ Eine WebDAV-Verbindung kann unabhängig von ihrer Reihenfolge gelöscht werden.
 
 ### Diagnose
 
-Der WebDAV-Derivative-Gate schreibt Request-bezogene `[BRAT-WD ...]`-Diagnoseeinträge. Für neue Derivate zeigen `preview_start`, `preview_failed`, `download_done mode=preview|original`, `generate_start` und `generate_done` den verwendeten Quellpfad und die Laufzeiten. Der Verbindungsstatus wird pro Verbindung geführt. Runtime-Probleme lassen sich zusätzlich über `bratonien-nc-connector.service` nachvollziehen.
+Der Status wird pro Verbindung geführt. Fehler enthalten Zeitpunkt, betroffene Verbindung, Prozesszustand und technische Details. Die Administration zeigt keine lokalen Datenbank-, Storage- oder Mount-Einstellungen mehr an.
 
-## Aktuell relevante Dateien
+## Entfernte Connector-Komponenten
 
-- `main.inc.php` – Plugin-Hooks, Connector-Sync-Hilfen, Dashboard-Prefilter
+Nicht mehr Bestandteil des Plugins sind lokale Nextcloud-Datenbankanbindungen, PostgreSQL-Reader, Source-/Activity-Views, Storage-Mappings, Host-Mounts, lokale Reconcile-/Sync-Skripte, Cutover-/Migrationswerkzeuge und der frühere Simulations-Webservice `bratonien.nc.sync`.
-- `include/webdav_materialize_runtime.inc.php` – WebDAV-Quellauflösung einschließlich `fileid` und Originalmaßen
-- `webdav-derivative.php` – On-Demand-Gate, Nextcloud-Preview/Original-Fallback und Piwigo-Derivaterzeugung
-- `webdav-image.php` – direkte WebDAV-Originalauslieferung
-- `include/nc_productive_ws.inc.php` – direkter Piwigo-Core-Sync für 16.4.0
-- `include/nc_orphan_ws.inc.php` – Root-Orphan-Synchronisierung
-- `runtime/reconcile-webdav.php` – Runtime-Reconcile einschließlich leerem WebDAV-Root
-- `runtime/repair-webdav-orphans.php` – Orphan-Reparatur
-- `runtime/cleanup-webdav-piwigo.php` – Bereinigung verwaister Piwigo-Sites
-- `runtime/sync-webdav.sh` – verbindungsspezifischer Sync
-- `runtime/run-all.sh` – gemeinsamer Runner
-- `runtime/lib/build_webdav_placeholder_source.py` – WebDAV-Scan, Bildmetadaten und Platzhalterquelle
-- `runtime/lib/sync-webdav-metadata.php` – Übernahme der Originalmaße nach Piwigo
-- `runtime/lib/shadow_tree.py` – atomarer Shadow Tree
-- `runtime/lib/piwigo-sync.php` – Piwigo-API/Fallback-Sync
-
-## Nicht mehr das produktive WebDAV-Modell
-
-Nicht mehr maßgeblich sind das frühere Modell eines separaten WebDAV-Bildstreams als Derivatquelle, ein paralleler vollständiger Connector-Derivatbestand oder ein interner HTTP-Aufruf von `webdav-derivative.php` zurück auf Piwigos `i.php`.
-
-Maßgeblich ist: **physischer Platzhalter + passende temporäre Nextcloud-Preview bzw. Original-Fallback + Piwigos Bildverarbeitung im selben PHP-Prozess + normales Piwigo-Derivat + Wiederherstellung des Platzhalters**.
 
 ## Prüfpflicht vor Merge
 
-Die GitHub-Actions-Konfiguration prüft mindestens:
+Jede Änderung wird vor dem Merge mindestens mit folgenden GitHub-Actions-Prüfungen validiert:
 
 - PHP-Syntax für 8.2, 8.3, 8.4 und 8.5
-- doppelte globale `bratonien_tools_*`-Funktionen
+- Prüfung auf doppelte globale `bratonien_tools_*`-Funktionen
 - JavaScript-Syntax
 - Python-Syntax/Compile
 - Shell-Syntax mit `bash -n`

README.md

@@ -2,7 +2,7 @@
 
 Modulares Piwigo-Plugin für Administration, Bildverarbeitung, geschützte Freigaben, Fotoauswahl und die Anbindung von Nextcloud an Piwigo.
 
-Aktuelle Plugin-Version: **9.7.1.0**
+Aktuelle Plugin-Version: **0.9.6.2**
 
 ## Grundprinzip
 
@@ -12,43 +12,18 @@ Für die Administration gilt: Der normale Nutzer sieht Aufgaben, Entscheidungen
 
 ## NC Connector
 
-Der NC Connector bindet ausdrücklich ausgewählte Nextcloud-Inhalte per WebDAV an Piwigo an. Nextcloud bleibt dabei die Quelle der Originaldateien; Piwigo verwaltet Alben, Bilder und seine eigenen Derivate.
+Der NC Connector bindet ausdrücklich ausgewählte Nextcloud-Inhalte ausschließlich per WebDAV an Piwigo an.
 
 ### Datenmodell
 
-- Nextcloud bleibt die verbindliche Quelle der Originaldateien.
+- Nextcloud bleibt die Quelle der Originaldateien.
-- Originalbilder werden nicht dauerhaft als zweite vollständige Bibliothek unter Piwigo gespeichert.
+- Originalbilder werden nicht dauerhaft in eine zweite Bibliothek unter Piwigo kopiert.
-- Eine lokale Platzhalterquelle enthält physische 1×1-Dateien, damit Piwigo die Bilder regulär als Dateisysteminhalte erkennen kann.
+- Ein Shadow Tree erzeugt die für Piwigo benötigte Ordnerstruktur.
-- Ein Shadow Tree bildet daraus die von Piwigo erwartete Galerie-Ordnerstruktur.
 - Ordner werden als physische Piwigo-Alben synchronisiert.
-- Direkt im ausgewählten Nextcloud-Root liegende Einzelbilder werden über die vorhandene Orphan-Logik behandelt.
+- Root-Dateien können als Piwigo-Orphans registriert werden.
 - Neu importierte physische Connector-Alben werden privat angelegt.
 - Entfernte Quellen verschwinden aus Shadow Tree und Piwigo; die Nextcloud-Originale bleiben erhalten.
 
-### Nextcloud-Root ohne künstliches Benutzeralbum
-
-Ein leerer `webdav_path` ist ein gültiger Root und bedeutet den Dateibereich des authentifizierten Nextcloud-Benutzers.
-
-Dabei wird der Nextcloud-Benutzername nicht als künstliche Album-Ebene angelegt. Beispiel:
-
-```text
-Nextcloud
-/
-├── 400 Auswahl/
-├── Zweites Album/
-├── einzelbild-1.jpg
-└── einzelbild-2.jpg
-```
-
-wird in Piwigo logisch als
-
-```text
-400 Auswahl
-Zweites Album
-```
-
-abgebildet. Die direkt im Root liegenden Einzelbilder werden separat durch die Orphan-Synchronisierung erfasst.
-
 ### Voraussetzungen
 
 Benötigt werden nur:
@@ -60,53 +35,30 @@ Benötigt werden nur:
 
 Nicht benötigt werden Nextcloud-Datenbankzugriff, `occ`-Adminzugriff, Storage-IDs, Backend-Pfade, zusätzliche Host-Mounts, FUSE, davfs oder rclone.
 
-### WebDAV-Scan und Shadow Tree
+### WebDAV-Ablauf
 
 1. Der Assistent prüft Nextcloud und liest die sichtbaren Verzeichnisse per WebDAV.
 2. Ausgewählte Verzeichnisse werden rekursiv per PROPFIND eingelesen.
-3. Ordner, Dateiname, Nextcloud-Datei-ID, MIME-Typ, Größe, ETag, Originalabmessungen und WebDAV-Pfad werden erfasst.
+3. Ordner, Dateiname, Nextcloud-Datei-ID, MIME-Typ, Größe, ETag und WebDAV-Pfad werden erfasst.
 4. `runtime/lib/build_webdav_placeholder_source.py` erzeugt eine lokale Platzhalterquelle ohne dauerhafte Originalkopie.
-5. `runtime/lib/shadow_tree.py` baut atomar den verbindungseigenen Shadow Tree.
+5. `runtime/lib/shadow_tree.py` baut daraus den verbindungseigenen Shadow Tree.
 6. Der WebDAV-Galeriebaum liegt unter `_data/bratonien-tools/nc-webdav-gallery/connection-ID`.
 7. Jede WebDAV-Verbindung wird als eigene physische Piwigo-Site registriert.
 8. Piwigos Dateisynchronisierung erhält ausschließlich diese verbindungseigene Site.
-9. `runtime/lib/sync-webdav-metadata.php` übernimmt die von Nextcloud gelieferten Originalmaße in Piwigos Bilddatensätze.
+9. Die WebDAV-Bildzuordnung ersetzt beim Ausliefern Platzhalter-URLs durch die echte Nextcloud-Bildquelle.
-
+10. `webdav-image.php` streamt benötigte Bilder serverseitig; Zugangsdaten werden dem Browser nicht offengelegt.
-### On-Demand-Bildauslieferung und Piwigo-Derivate
-
-`include/webdav_materialize_runtime.inc.php` erkennt anhand des Piwigo-Bildpfads die zugehörige WebDAV-Verbindung, den Nextcloud-Root und den relativen WebDAV-Pfad. Aus dem Mapping stehen zusätzlich `fileid`, Originalbreite/-höhe, MIME-Typ, Dateigröße und ETag zur Verfügung. Der Hook `get_derivative_url` leitet fehlende WebDAV-Derivate an `webdav-derivative.php` um.
-
-Wenn ein benötigtes Piwigo-Derivat noch nicht existiert:
-
-1. `webdav-derivative.php` prüft den Piwigo-Zugriff auf das Bild.
-2. Für `custom:s9999x250` und `standard:square` wird bevorzugt eine passende authentifizierte Nextcloud-Preview anhand der `fileid` geladen. Die Preview wird mit ungefähr doppelter benötigter Piwigo-Auflösung und erhaltenem Seitenverhältnis angefordert.
-3. Ist keine passende Preview planbar oder schlägt der Preview-Abruf fehl, wird automatisch das vollständige Original per WebDAV geladen. Große bzw. originale Anforderungen verwenden weiterhin die Originalquelle.
-4. Die temporäre Bildquelle ersetzt für die Dauer der Erzeugung die physische 1×1-Platzhalterdatei bzw. den Shadow-Link am von Piwigo erwarteten Quellpfad.
-5. Piwigos eigene `pwg_image`-/Derivative-Logik erzeugt das normale Piwigo-Derivat direkt im selben PHP-Prozess. Ein interner HTTP-Self-Request auf `i.php` wird nicht verwendet.
-6. Danach wird die temporäre Bildquelle entfernt und der Platzhalter-/Shadow-Zustand wiederhergestellt.
-7. Das fertige Derivat wird ausgeliefert und künftig normal aus Piwigos `_data/i`-Derivat-Cache verwendet.
-
-Damit bleibt Piwigo für Größen, Derivate und Lazy-Loading verantwortlich. Der Connector hält keinen parallelen eigenen vollständigen Derivat-Cache vor.
-
-Für Fälle, in denen Piwigo direkt die Originalquelle benötigt, steht weiterhin die serverseitige WebDAV-Auslieferung zur Verfügung. Nextcloud-Zugangsdaten werden nicht an den Browser weitergegeben.
 
 ### Piwigo-Synchronisierung
 
-Der Connector verwendet die vorhandene Piwigo-Dateisynchronisierung für die verbindungseigene WebDAV-Site. Der Shadow Tree ist ausschließlich die Dateisystemdarstellung, die Piwigo für Alben und Bilder benötigt.
+Der Connector verwendet die vorhandene Piwigo-Dateisynchronisierung für die verbindungseigene WebDAV-Site. Der Shadow Tree ist die Dateisystemdarstellung, die Piwigo für Alben und Bilder benötigt.
 
-`runtime/lib/piwigo-sync.php` bevorzugt die Webservice-Methode `bratonien.nc.syncProductive`. Ist keine Piwigo-API für die Verbindung eingerichtet, wird der vorhandene Administrator-/Webmaster-Benutzername/Passwort-Fallback verwendet und Piwigos nativer `site_update` ausgeführt.
+`runtime/lib/piwigo-sync.php` ruft dafür `bratonien.nc.syncProductive` auf. Die Methode führt den Piwigo-Core-Sync für die konkrete Site aus. `bratonien.nc.syncOrphans` arbeitet ebenfalls nur auf der übergebenen WebDAV-Site.
-
-Nach der regulären Dateisynchronisierung läuft `bratonien.nc.syncOrphans` für direkt im Site-Root liegende Einzelbilder.
 
 Die produktive Synchronisierung ist aktuell auf **Piwigo 16.4.0** abgestimmt.
 
-### Private Top-Level-Alben
+### Piwigo-Zugang
 
-Durch das Überspringen der technischen Nextcloud-Benutzerebene können WebDAV-Unterordner zu echten Top-Level-Piwigo-Alben werden. Für den Connector-Sync wird deshalb der Zugriff des verwendeten Piwigo-Administrators auf neu erzeugte private Top-Level-Alben erhalten und der Benutzer-Cache anschließend invalidiert.
+Der Zugang wird pro Verbindung gespeichert. Bevorzugt wird eine Piwigo-API. Wird keine API eingerichtet, kann ein Administrator-/Webmaster-Benutzer mit Passwort als Fallback verwendet werden.
-
-### Administrations-Dashboard
-
-Piwigo 16.4.0 blendet seine Album-Statistik standardmäßig bei exakt einem Album aus (`NB_ALBUMS > 1`). Bratonien Tools passt ausschließlich diese Dashboard-Anzeige auf `NB_ALBUMS > 0` an. Dadurch wird auch ein einzelnes korrekt angelegtes Album in der Verwaltungsübersicht angezeigt.
 
 ### Statusanzeige
 
@@ -126,14 +78,11 @@ Aktive WebDAV-Verbindungen werden über den gemeinsamen Runner verarbeitet:
 
 Verbindungsspezifische Konfigurationen liegen unter `/etc/bratonien-tools/nc-connector/`, State-Daten unter `/var/lib/bratonien-tools/nc-connector/connection-ID`.
 
-Der gemeinsame Lauf besteht aktuell aus:
+Der Lauf besteht aus:
 
-1. `runtime/reconcile-webdav.php` – gespeicherte Verbindungen in Runtime-Konfigurationen überführen;
+1. WebDAV-Verbindungen reconciliieren;
-2. `runtime/repair-webdav-orphans.php` – vorhandene WebDAV-Orphan-Zustände reparieren;
+2. verwaiste WebDAV-Piwigo-Inhalte bereinigen;
-3. `runtime/cleanup-webdav-piwigo.php` – verwaiste WebDAV-Piwigo-Daten bereinigen;
+3. jede vorhandene WebDAV-Verbindung synchronisieren.
-4. `runtime/sync-webdav.sh` – jede vorhandene WebDAV-Verbindung synchronisieren.
-
-Der verbindungsspezifische Lauf erzeugt Platzhalterquelle und Shadow Tree, führt Piwigos Sync und Orphan-Sync aus und überträgt anschließend die Originalabmessungen aus dem WebDAV-Mapping in Piwigo. Eine vollständige Vorab-Erzeugung von Connector-Derivaten findet nicht statt; fehlende Derivate werden On-Demand erzeugt.
 
 ## Bildcache
 
@@ -184,30 +133,26 @@ Der integrierte Updater liest den Zielstand aus GitHub, bindet ein Update an ein
 
 ## Wichtige Dateien und Verzeichnisse
 
-- `main.inc.php` – Plugin-Einstieg, Hooks, Connector-Sync-Hilfen und Dashboard-Prefilter
+- `main.inc.php` – Plugin-Einstieg und Runtime-Hooks
 - `admin.php` – zentraler Admin-Controller
 - `include/nc_connector.inc.php` – WebDAV-Verbindungsmodell
 - `include/nc_connector_wizard.inc.php` – Verbindungsassistent
 - `include/nc_connector_wizard_webdav_flow.inc.php` – WebDAV-Wizardablauf
 - `include/nc_connector_delete_safe.inc.php` – Löschen einschließlich WebDAV-Piwigo-Inhalten
-- `include/nc_productive_ws.inc.php` – direkter Piwigo-Core-Dateisync für Piwigo 16.4.0
+- `include/nc_productive_ws.inc.php` – Piwigo-Core-Dateisync
 - `include/nc_orphan_ws.inc.php` – Orphan-Synchronisierung der konkreten WebDAV-Site
-- `include/webdav_materialize_runtime.inc.php` – WebDAV-Quellauflösung und On-Demand-Materialisierung einschließlich `fileid` und Originalmaßen
+- `include/webdav_image_runtime.inc.php` – WebDAV-Bildzuordnung und URL-Filter
-- `include/webdav_image_runtime.inc.php` – vorhandene WebDAV-Bildzuordnung/Originalauslieferung
+- `webdav-image.php` – berechtigungsgeprüfter WebDAV-Bildstream
-- `webdav-derivative.php` – On-Demand-Gate, Nextcloud-Preview/Original-Fallback und Piwigo-Derivaterzeugung
+- `runtime/reconcile-webdav.php` – WebDAV-Runtime-Reconcile
-- `webdav-image.php` – serverseitige WebDAV-Originalauslieferung
-- `runtime/reconcile-webdav.php` – WebDAV-Runtime-Reconcile, einschließlich gültigem leerem Root
-- `runtime/repair-webdav-orphans.php` – Reparatur vorhandener Orphan-Zustände
 - `runtime/cleanup-webdav-piwigo.php` – Bereinigung verwaister WebDAV-Piwigo-Sites
 - `runtime/sync-webdav.sh` – Ablauf einer WebDAV-Verbindung
 - `runtime/run-all.sh` – gemeinsamer WebDAV-Runner
-- `runtime/lib/build_webdav_placeholder_source.py` – rekursiver WebDAV-Scan, Bildmetadaten und physische Platzhalterquelle
+- `runtime/lib/build_webdav_placeholder_source.py` – rekursiver WebDAV-Scan und Platzhalterquelle
-- `runtime/lib/sync-webdav-metadata.php` – Übernahme der Originalabmessungen in Piwigo
+- `runtime/lib/shadow_tree.py` – atomarer Shadow Tree
-- `runtime/lib/shadow_tree.py` – atomarer, Piwigo-kompatibler Shadow Tree
 - `runtime/lib/piwigo-sync.php` – Piwigo-Sync mit API/Fallback
 - `main-cache-build.php` – allgemeiner Piwigo-Derivat-/Cache-Builder
 - `include/self_update.inc.php` – Self-Updater
-- `include/album_shares.inc.php` – geschützte Albumfreigaben und private Albumzugriffe
+- `include/album_shares.inc.php` – geschützte Albumfreigaben
 - `include/public_selection.inc.php` – Fotoauswahl
 - `include/batch_titles.inc.php` – fortlaufende Titel
 - `include/watermark_*.inc.php` – Wasserzeichen-Engine
@@ -222,7 +167,5 @@ Der integrierte Updater liest den Zielstand aus GitHub, bindet ein Update an ein
 - Wizard-Geheimnisse werden nicht im Browser-Web-Storage persistiert;
 - produktive Piwigo-API ist versionsgebunden;
 - Originalbilder werden vom Connector nicht gelöscht;
-- WebDAV-Originalbilder werden nur bei Bedarf temporär lokal materialisiert;
+- WebDAV-Originalbilder werden nicht dauerhaft lokal gespeichert;
-- kleine Derivate können stattdessen eine temporäre authentifizierte Nextcloud-Preview verwenden;
-- temporäre Preview-/Originalquellen werden nach der Piwigo-Derivaterzeugung wieder entfernt;
 - Update-Pakete werden an Commit und Hash gebunden.

include/nc_connector_system.inc.php

@@ -4,14 +4,9 @@ if (!defined('PHPWG_ROOT_PATH'))
   die('Hacking attempt!');
 }
 
-function bratonien_tools_nc_connector_systemctl_run(array $args)
+function bratonien_tools_nc_connector_systemctl_value(array $args)
 {
-  $result = array('exit'=>-1, 'stdout'=>'', 'stderr'=>'');
+  if (!function_exists('proc_open')) return '';
-  if (!function_exists('proc_open'))
-  {
-    $result['stderr'] = 'proc_open ist in PHP nicht verfügbar.';
-    return $result;
-  }
 
   $command = array_merge(array('/usr/bin/systemctl'), $args);
   $spec = array(
@@ -21,71 +16,13 @@ function bratonien_tools_nc_connector_systemctl_run(array $args)
   );
   $environment = array_merge($_ENV, array('LC_ALL'=>'C','LANG'=>'C'));
   $process = @proc_open($command, $spec, $pipes, null, $environment);
-  if (!is_resource($process))
+  if (!is_resource($process)) return '';
-  {
+  $stdout = stream_get_contents($pipes[1]);
-    $result['stderr'] = 'systemctl konnte nicht gestartet werden.';
+  stream_get_contents($pipes[2]);
-    return $result;
-  }
-
-  $result['stdout'] = trim((string)stream_get_contents($pipes[1]));
-  $result['stderr'] = trim((string)stream_get_contents($pipes[2]));
   fclose($pipes[1]);
   fclose($pipes[2]);
-  $result['exit'] = (int)proc_close($process);
+  $exit = proc_close($process);
-  return $result;
+  return $exit === 0 ? trim((string)$stdout) : '';
-}
-
-function bratonien_tools_nc_connector_systemctl_value(array $args)
-{
-  $result = bratonien_tools_nc_connector_systemctl_run($args);
-  return $result['exit'] === 0 ? $result['stdout'] : '';
-}
-
-function bratonien_tools_nc_connector_run_now()
-{
-  if (!function_exists('proc_open'))
-  {
-    throw new RuntimeException('WebDAV-Abgleich konnte nicht gestartet werden: proc_open ist in PHP nicht verfügbar.');
-  }
-
-  $runtime_dir = realpath(dirname(__DIR__).'/runtime');
-  if ($runtime_dir === false || !is_dir($runtime_dir))
-  {
-    throw new RuntimeException('WebDAV-Abgleich konnte nicht gestartet werden: Runtime-Verzeichnis wurde nicht gefunden.');
-  }
-
-  $script = $runtime_dir.'/run-all.sh';
-  if (!is_file($script) || !is_readable($script))
-  {
-    throw new RuntimeException('WebDAV-Abgleich konnte nicht gestartet werden: runtime/run-all.sh ist nicht lesbar.');
-  }
-
-  $spec = array(
-    0=>array('file','/dev/null','r'),
-    1=>array('pipe','w'),
-    2=>array('pipe','w'),
-  );
-  $environment = array_merge($_ENV, array('LC_ALL'=>'C','LANG'=>'C'));
-  $process = @proc_open(array('/usr/bin/env','bash',$script), $spec, $pipes, $runtime_dir, $environment);
-  if (!is_resource($process))
-  {
-    throw new RuntimeException('WebDAV-Abgleich konnte nicht gestartet werden: Connector-Prozess konnte nicht geöffnet werden.');
-  }
-
-  $stdout = trim((string)stream_get_contents($pipes[1]));
-  $stderr = trim((string)stream_get_contents($pipes[2]));
-  fclose($pipes[1]);
-  fclose($pipes[2]);
-  $exit = (int)proc_close($process);
-
-  if ($exit !== 0)
-  {
-    $detail = $stderr !== '' ? $stderr : $stdout;
-    if ($detail === '') $detail = 'Exit-Code '.$exit;
-    throw new RuntimeException('WebDAV-Abgleich fehlgeschlagen: '.$detail);
-  }
-
-  return array('message'=>'WebDAV-Abgleich wurde ausgeführt.');
 }
 
 function bratonien_tools_nc_connector_parse_systemd_time($value)
@@ -175,15 +112,6 @@ function bratonien_tools_nc_connector_last_status(array $connections)
   return $latest;
 }
 
-function bratonien_tools_nc_connector_status_message(array $last)
-{
-  if ((string)($last['state'] ?? '') === 'ok')
-  {
-    return 'WebDAV eingelesen und Piwigo synchronisiert';
-  }
-  return (string)($last['message'] ?? '');
-}
-
 function bratonien_tools_nc_connector_system_status(array $connections = array())
 {
   $timer = 'bratonien-nc-connector.timer';
@@ -215,7 +143,7 @@ function bratonien_tools_nc_connector_system_status(array $connections = array()
     'last_run_timestamp'=>(int)$last['timestamp'],
     'last_run_label'=>$last['timestamp'] > 0 ? date('d.m.Y H:i:s', (int)$last['timestamp']) : 'Nicht verfügbar',
     'last_run_state'=>(string)$last['state'],
-    'last_run_message'=>bratonien_tools_nc_connector_status_message($last),
+    'last_run_message'=>(string)$last['message'],
     'last_run_auth_mode'=>(string)$last['auth_mode'],
     'last_run_api_state'=>(string)$last['api_state'],
     'last_run_api_message'=>(string)$last['api_message'],

include/tool_registry.inc.php

@@ -50,7 +50,6 @@ function bratonien_tools_get_tools()
     'nc_connector_create_webdav_parallel' => array('handler' => 'bratonien_tools_nc_connector_create_webdav_placeholder_from_wizard'),
     'nc_connector_delete' => array('handler' => 'bratonien_tools_nc_connector_delete_safe'),
     'nc_connector_update_name' => array('handler' => 'bratonien_tools_nc_connector_update_name'),
-    'nc_connector_run_now' => array('handler' => 'bratonien_tools_nc_connector_run_now'),
     'nc_connector_wizard_scan' => array('handler' => 'bratonien_tools_nc_wizard_scan_webdav_first'),
     'nc_connector_wizard_directory_browse' => array('handler' => 'bratonien_tools_nc_wizard_directory_browse'),
     'nc_connector_wizard_directory_add' => array('handler' => 'bratonien_tools_nc_wizard_directory_add'),

include/webdav_materialize_runtime.inc.php

@@ -1,294 +0,0 @@
-<?php
-if (!defined('PHPWG_ROOT_PATH'))
-{
-  die('Hacking attempt!');
-}
-
-function bratonien_tools_webdav_materialize_source_info($image_id)
-{
-  static $cache = array();
-
-  $image_id = (int)$image_id;
-  if ($image_id < 1) return null;
-  if (array_key_exists($image_id, $cache)) return $cache[$image_id];
-
-  $result = pwg_query('SELECT path, coi FROM '.IMAGES_TABLE.' WHERE id='.$image_id.' LIMIT 1');
-  if (!pwg_db_num_rows($result)) return $cache[$image_id] = null;
-
-  $row = pwg_db_fetch_assoc($result);
-  $path = (string)($row['path'] ?? '');
-  if ($path === '') return $cache[$image_id] = null;
-
-  $absolute = $path;
-  if (strpos($absolute, '/') !== 0)
-  {
-    $absolute = PHPWG_ROOT_PATH.ltrim(preg_replace('#^\./#', '', $absolute), '/');
-  }
-
-  $resolved = realpath($absolute);
-  if ($resolved === false) return $cache[$image_id] = null;
-
-  $normalized = str_replace('\\', '/', $resolved);
-  if (!preg_match('#/nc-webdav-source/connection-([0-9]+)/root-([0-9]+)/(.*)$#', $normalized, $match))
-  {
-    return $cache[$image_id] = null;
-  }
-
-  $connection_id = (int)$match[1];
-  $root_fileid = (int)$match[2];
-  $relative_path = trim((string)$match[3], '/');
-  if ($connection_id < 1 || $root_fileid < 1 || $relative_path === '')
-  {
-    return $cache[$image_id] = null;
-  }
-
-  $table = defined('BRATONIEN_TOOLS_NC_CONNECTIONS_TABLE')
-    ? BRATONIEN_TOOLS_NC_CONNECTIONS_TABLE
-    : $GLOBALS['prefixeTable'].'bratonien_tools_nc_connections';
-  $connection_result = pwg_query('SELECT config_json FROM `'.$table.'` WHERE id='.$connection_id.' LIMIT 1');
-  if (!pwg_db_num_rows($connection_result)) return $cache[$image_id] = null;
-
-  $connection_row = pwg_db_fetch_assoc($connection_result);
-  $config = json_decode((string)$connection_row['config_json'], true);
-  if (!is_array($config) || (string)($config['source_mode'] ?? '') !== 'webdav-placeholder')
-  {
-    return $cache[$image_id] = null;
-  }
-
-  $root_found = false;
-  $root_path = '';
-  $roots = isset($config['roots']) && is_array($config['roots']) ? $config['roots'] : array();
-  foreach ($roots as $root)
-  {
-    if ((int)($root['fileid'] ?? 0) === $root_fileid)
-    {
-      $root_found = true;
-      $root_path = trim((string)($root['webdav_path'] ?? ''), '/');
-      break;
-    }
-  }
-  if (!$root_found) return $cache[$image_id] = null;
-
-  $webdav_path = trim($root_path === '' ? $relative_path : $root_path.'/'.$relative_path, '/');
-  if ($webdav_path === '') return $cache[$image_id] = null;
-
-  $content_type = '';
-  $size = 0;
-  $etag = '';
-  $fileid = 0;
-  $width = 0;
-  $height = 0;
-  $state_dir = rtrim((string)($config['state_dir'] ?? ''), '/');
-  if ($state_dir !== '')
-  {
-    $mapping_file = $state_dir.'/webdav-map.json';
-    if (is_readable($mapping_file))
-    {
-      $mapping = json_decode((string)file_get_contents($mapping_file), true);
-      if (is_array($mapping) && isset($mapping['files']) && is_array($mapping['files']))
-      {
-        $files = $mapping['files'];
-        $entry = $files[$resolved] ?? $files[$normalized] ?? null;
-        if (!is_array($entry))
-        {
-          foreach ($files as $candidate)
-          {
-            if (!is_array($candidate) || (string)($candidate['kind'] ?? '') !== 'file') continue;
-            if (trim((string)($candidate['webdav_path'] ?? ''), '/') !== $webdav_path) continue;
-            $entry = $candidate;
-            break;
-          }
-        }
-        if (is_array($entry) && (string)($entry['kind'] ?? '') === 'file')
-        {
-          $mapped_path = trim((string)($entry['webdav_path'] ?? ''), '/');
-          if ($mapped_path !== '') $webdav_path = $mapped_path;
-          $content_type = (string)($entry['content_type'] ?? '');
-          $size = (int)($entry['size'] ?? 0);
-          $etag = (string)($entry['etag'] ?? '');
-          $fileid = (int)($entry['fileid'] ?? 0);
-          $width = (int)($entry['width'] ?? 0);
-          $height = (int)($entry['height'] ?? 0);
-        }
-      }
-    }
-  }
-
-  return $cache[$image_id] = array(
-    'image_id'=>$image_id,
-    'connection_id'=>$connection_id,
-    'root_fileid'=>$root_fileid,
-    'relative_path'=>$relative_path,
-    'webdav_path'=>$webdav_path,
-    'content_type'=>$content_type,
-    'size'=>$size,
-    'etag'=>$etag,
-    'fileid'=>$fileid,
-    'width'=>$width,
-    'height'=>$height,
-    'coi'=>$row['coi'] ?? null,
-  );
-}
-
-function bratonien_tools_webdav_materialize_image_url($image_id)
-{
-  $info = bratonien_tools_webdav_materialize_source_info($image_id);
-  if (!$info) return null;
-
-  $url = get_root_url().'plugins/'.BRATONIEN_TOOLS_ID.'/webdav-image.php?id='.(int)$image_id;
-  if ($info['etag'] !== '') $url .= '&v='.rawurlencode(substr(sha1($info['etag']), 0, 12));
-  return $url;
-}
-
-function bratonien_tools_webdav_materialize_custom_params($key)
-{
-  if (!class_exists('DerivativeParams') || !class_exists('SizingParams')) return null;
-
-  $tokens = explode('_', trim((string)$key));
-  if (!$tokens || $tokens[0] === '') return null;
-
-  $parse_size = function($value)
-  {
-    if (!preg_match('/^[0-9]+(?:x[0-9]+)?$/', (string)$value)) return null;
-    $parts = explode('x', (string)$value, 2);
-    $width = (int)$parts[0];
-    $height = count($parts) === 1 ? $width : (int)$parts[1];
-    if ($width < 1 || $height < 1 || $width > 20000 || $height > 20000) return null;
-    return array($width, $height);
-  };
-
-  $token = array_shift($tokens);
-  $crop = 0;
-  $min_size = null;
-
-  if (isset($token[0]) && $token[0] === 's')
-  {
-    $size = $parse_size(substr($token, 1));
-  }
-  elseif (isset($token[0]) && $token[0] === 'e')
-  {
-    $crop = 1;
-    $size = $min_size = $parse_size(substr($token, 1));
-  }
-  else
-  {
-    if (count($tokens) < 2) return null;
-    $size = $parse_size($token);
-    $crop_token = (string)array_shift($tokens);
-    $min_size = $parse_size(array_shift($tokens));
-    if (!preg_match('/^[a-z]$/', $crop_token) || $min_size === null) return null;
-    $crop = function_exists('char_to_fraction') ? char_to_fraction($crop_token) : 0;
-  }
-
-  if ($size === null) return null;
-
-  $params = new DerivativeParams(new SizingParams($size, $crop, $min_size));
-  if (class_exists('ImageStdParams')) ImageStdParams::apply_global($params);
-  return $params;
-}
-
-function bratonien_tools_webdav_materialize_variant_from_params($params)
-{
-  if (!is_object($params) || !class_exists('ImageStdParams')) return null;
-
-  $type = (string)($params->type ?? '');
-  $defined = ImageStdParams::get_defined_type_map();
-  if ($type !== '' && defined('IMG_CUSTOM') && $type !== IMG_CUSTOM && isset($defined[$type]))
-  {
-    return 'standard:'.$type;
-  }
-
-  if (!method_exists($params, 'add_url_tokens')) return null;
-  $tokens = array();
-  $params->add_url_tokens($tokens);
-  if (!$tokens) return null;
-
-  $key = implode('_', $tokens);
-  if (!preg_match('/^[A-Za-z0-9_x-]+$/', $key)) return null;
-  return 'custom:'.$key;
-}
-
-function bratonien_tools_webdav_materialize_params_from_variant($variant)
-{
-  $variant = trim((string)$variant);
-  if ($variant === '' || !class_exists('ImageStdParams')) return null;
-
-  if (strpos($variant, 'standard:') === 0)
-  {
-    $type = substr($variant, strlen('standard:'));
-    $defined = ImageStdParams::get_defined_type_map();
-    return isset($defined[$type]) ? $defined[$type] : null;
-  }
-
-  if (strpos($variant, 'custom:') === 0)
-  {
-    $key = substr($variant, strlen('custom:'));
-    if (!preg_match('/^[A-Za-z0-9_x-]+$/', $key)) return null;
-    return bratonien_tools_webdav_materialize_custom_params($key);
-  }
-
-  return null;
-}
-
-function bratonien_tools_webdav_materialize_b64url_encode($value)
-{
-  return rtrim(strtr(base64_encode((string)$value), '+/', '-_'), '=');
-}
-
-function bratonien_tools_webdav_materialize_after_signature($image_id, $variant, $after_url)
-{
-  global $conf;
-  $key = !empty($conf['secret_key']) ? $conf['secret_key'] : ($conf['db_password'] ?? 'bratonien-tools');
-  return hash_hmac('sha256', (int)$image_id.'|'.(string)$variant.'|'.(string)$after_url, $key);
-}
-
-function bratonien_tools_webdav_materialize_derivative_url($image_id, $variant, array $info, $after_url='')
-{
-  $url = get_root_url().'plugins/'.BRATONIEN_TOOLS_ID.'/webdav-derivative.php?id='.(int)$image_id.'&variant='.rawurlencode($variant);
-  if ($after_url !== '')
-  {
-    $url .= '&after='.rawurlencode(bratonien_tools_webdav_materialize_b64url_encode($after_url));
-    $url .= '&sig='.rawurlencode(bratonien_tools_webdav_materialize_after_signature($image_id, $variant, $after_url));
-  }
-  if (!empty($info['etag'])) $url .= '&v='.rawurlencode(substr(sha1((string)$info['etag']), 0, 12));
-  return $url;
-}
-
-function bratonien_tools_filter_webdav_materialize_src_url($url, $src_image)
-{
-  if (!is_object($src_image) || empty($src_image->id)) return $url;
-  $webdav_url = bratonien_tools_webdav_materialize_image_url((int)$src_image->id);
-  return $webdav_url ?: $url;
-}
-
-function bratonien_tools_filter_webdav_materialize_derivative_url($url, $params, $src_image, $rel_url)
-{
-  if (!is_object($src_image) || empty($src_image->id)) return $url;
-
-  $image_id = (int)$src_image->id;
-  $info = bratonien_tools_webdav_materialize_source_info($image_id);
-  if (!$info) return $url;
-
-  try
-  {
-    $derivative = new DerivativeImage($params, $src_image);
-    if ($derivative->same_as_source())
-    {
-      $source_url = bratonien_tools_webdav_materialize_image_url($image_id);
-      return $source_url ?: $url;
-    }
-
-    $path = $derivative->get_path();
-    if ($path !== '' && is_file($path) && is_readable($path)) return $url;
-
-    $variant = bratonien_tools_webdav_materialize_variant_from_params($params);
-    if ($variant === null) return $url;
-
-    return bratonien_tools_webdav_materialize_derivative_url($image_id, $variant, $info, (string)$url);
-  }
-  catch (Throwable $e)
-  {
-    error_log('Bratonien WebDAV materialize derivative #'.$image_id.': '.$e->getMessage());
-    return $url;
-  }
-}

js/admin_tabs.js

@@ -1,40 +1,6 @@
 (function () {
   'use strict';
 
-  function initNcConnectorRunNow() {
-    var section = document.getElementById('nc-connector');
-    if (!section || section.querySelector('[data-nc-run-now]')) return;
-
-    var statusCard = section.querySelector('.bratonien-card');
-    var token = section.querySelector('input[name="pwg_token"]');
-    if (!statusCard || !token) return;
-
-    var actions = document.createElement('div');
-    actions.className = 'bratonien-actions';
-    actions.style.marginTop = '1rem';
-    actions.setAttribute('data-nc-run-now', '1');
-
-    var form = document.createElement('form');
-    form.method = 'post';
-
-    var tokenInput = document.createElement('input');
-    tokenInput.type = 'hidden';
-    tokenInput.name = 'pwg_token';
-    tokenInput.value = token.value;
-
-    var button = document.createElement('button');
-    button.className = 'buttonLike';
-    button.type = 'submit';
-    button.name = 'bratonien_tool';
-    button.value = 'nc_connector_run_now';
-    button.textContent = 'Jetzt abrufen';
-
-    form.appendChild(tokenInput);
-    form.appendChild(button);
-    actions.appendChild(form);
-    statusCard.appendChild(actions);
-  }
-
   function initBratonienTabs() {
     var admin = document.querySelector('.bratonien-admin');
     if (!admin) return;
@@ -147,14 +113,9 @@
     activate(initial, false);
   }
 
-  function init() {
-    initBratonienTabs();
-    initNcConnectorRunNow();
-  }
-
   if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', init);
+    document.addEventListener('DOMContentLoaded', initBratonienTabs);
   } else {
-    init();
+    initBratonienTabs();
   }
 })();

main.inc.php

@@ -1,7 +1,7 @@
 <?php
 /*
 Plugin Name: Bratonien Tools
-Version: 9.7.1.2
+Version: 0.9.6.2
 Description: Erweiterbare Administrationswerkzeuge fuer die Bratonien-Piwigo-Installation.
 Plugin URI: https://github.com/Terranom674/Piwigo_Bratonien_Tools
 Author: Bratonien
@@ -17,7 +17,6 @@ define('BRATONIEN_TOOLS_PATH', PHPWG_PLUGINS_PATH . BRATONIEN_TOOLS_ID . '/');
 
 require_once(BRATONIEN_TOOLS_PATH . 'include/watermark_runtime.inc.php');
 require_once(BRATONIEN_TOOLS_PATH . 'include/webdav_image_runtime.inc.php');
-require_once(BRATONIEN_TOOLS_PATH . 'include/webdav_materialize_runtime.inc.php');
 require_once(BRATONIEN_TOOLS_PATH . 'include/public_selection.inc.php');
 require_once(BRATONIEN_TOOLS_PATH . 'include/picture_navigation.inc.php');
 require_once(BRATONIEN_TOOLS_PATH . 'include/batch_titles.inc.php');
@@ -27,16 +26,14 @@ require_once(BRATONIEN_TOOLS_PATH . 'include/nc_productive_ws.inc.php');
 
 add_event_handler('get_admin_plugin_menu_links', 'bratonien_tools_admin_menu');
 add_event_handler('get_derivative_url', 'bratonien_tools_filter_derivative_url', EVENT_HANDLER_PRIORITY_NEUTRAL, 4);
-add_event_handler('get_src_image_url', 'bratonien_tools_filter_webdav_materialize_src_url', EVENT_HANDLER_PRIORITY_NEUTRAL + 50, 2);
+add_event_handler('get_src_image_url', 'bratonien_tools_filter_webdav_src_url', EVENT_HANDLER_PRIORITY_NEUTRAL + 50, 2);
-add_event_handler('get_derivative_url', 'bratonien_tools_filter_webdav_materialize_derivative_url', EVENT_HANDLER_PRIORITY_NEUTRAL + 50, 4);
+add_event_handler('get_derivative_url', 'bratonien_tools_filter_webdav_derivative_url', EVENT_HANDLER_PRIORITY_NEUTRAL + 50, 4);
 add_event_handler('loc_end_element_set_global', 'bratonien_tools_batch_titles_register_action');
 add_event_handler('element_set_global_action', 'bratonien_tools_batch_titles_apply', EVENT_HANDLER_PRIORITY_NEUTRAL, 2);
 add_event_handler('init', 'bratonien_tools_prepare_connector_private_import', EVENT_HANDLER_PRIORITY_NEUTRAL - 30);
 add_event_handler('init', 'bratonien_tools_prepare_private_album_permissions', EVENT_HANDLER_PRIORITY_NEUTRAL - 20);
 add_event_handler('init', 'bratonien_tools_preserve_private_album_access', EVENT_HANDLER_PRIORITY_NEUTRAL - 10);
-add_event_handler('init', 'bratonien_tools_preserve_connector_top_level_access', EVENT_HANDLER_PRIORITY_NEUTRAL - 9);
 add_event_handler('init', 'bratonien_tools_album_shares_init');
-add_event_handler('loc_end_intro', 'bratonien_tools_fix_admin_album_stat_tile');
 add_event_handler('delete_categories', 'bratonien_tools_album_shares_on_delete_categories');
 add_event_handler('ws_add_methods', 'bratonien_tools_register_nc_orphan_ws_methods');
 add_event_handler('ws_add_methods', 'bratonien_tools_register_nc_productive_ws_methods');
@@ -84,108 +81,36 @@ function bratonien_tools_prepare_private_album_permissions()
     return;
   }
 
-  bratonien_tools_grant_private_album_access($category_id, (int)$user['id']);
+  $result = pwg_query('SELECT status FROM '.CATEGORIES_TABLE.' WHERE id = '.$category_id.' LIMIT 1');
-}
+  if (!pwg_db_num_rows($result))
-
-function bratonien_tools_preserve_connector_top_level_access()
-{
-  global $user;
-
-  if (
-    !defined('IN_ADMIN')
-    || ($_SERVER['REQUEST_METHOD'] ?? '') !== 'POST'
-    || (string)($_GET['page'] ?? '') !== 'site_update'
-    || (string)($_POST['bratonien_connector'] ?? '') !== '1'
-    || empty($user['id'])
-  )
   {
     return;
   }
 
-  $site_id = (int)($_GET['site'] ?? 0);
+  $category = pwg_db_fetch_assoc($result);
-  $user_id = (int)$user['id'];
+  if ($category['status'] !== 'public')
-  if ($site_id < 1 || $user_id < 1)
   {
     return;
   }
 
-  register_shutdown_function(function () use ($site_id, $user_id) {
+  $users = isset($_POST['users']) && is_array($_POST['users']) ? $_POST['users'] : array();
-    $query = '\nSELECT id\n  FROM '.CATEGORIES_TABLE.'\n  WHERE site_id = '.$site_id.'\n    AND dir IS NOT NULL\n    AND id_uppercat IS NULL\n    AND status = \'private\'\n;';
+  $current_user_id = (int)$user['id'];
-    $result = pwg_query($query);
+  $normalized_user_ids = array_map('intval', $users);
-    $changed = false;
-    while ($row = pwg_db_fetch_assoc($result))
-    {
-      $category_id = (int)$row['id'];
-      if ($category_id < 1)
-      {
-        continue;
-      }
 
-      $access_query = '\nSELECT 1\n  FROM '.USER_ACCESS_TABLE.'\n  WHERE user_id = '.$user_id.'\n    AND cat_id = '.$category_id.'\n  LIMIT 1\n;';
+  if (!in_array($current_user_id, $normalized_user_ids, true))
-      if (pwg_db_num_rows(pwg_query($access_query)) > 0)
-      {
-        continue;
-      }
-
-      bratonien_tools_grant_private_album_access($category_id, $user_id);
-      $changed = true;
-    }
-
-    if ($changed && function_exists('invalidate_user_cache'))
-    {
-      invalidate_user_cache(true);
-    }
-  });
-}
-
-function bratonien_tools_grant_private_album_access($category_id, $user_id)
-{
-  $category_id = (int)$category_id;
-  $user_id = (int)$user_id;
-  if ($category_id < 1 || $user_id < 1)
   {
-    return;
+    $users[] = $current_user_id;
   }
 
-  $query = '\nSELECT 1\n  FROM '.USER_ACCESS_TABLE.'\n  WHERE user_id = '.$user_id.'\n    AND cat_id = '.$category_id.'\n  LIMIT 1\n;';
+  $_POST['users'] = $users;
-  $result = pwg_query($query);
-  if (pwg_db_num_rows($result) > 0)
-  {
-    return;
-  }
-
-  single_insert(
-    USER_ACCESS_TABLE,
-    array(
-      'user_id' => $user_id,
-      'cat_id' => $category_id,
-    )
-  );
-}
-
-function bratonien_tools_fix_admin_album_stat_tile()
-{
-  global $template;
-
-  if (!defined('IN_ADMIN'))
-  {
-    return;
-  }
-
-  $template->set_prefilter('intro', 'bratonien_tools_prefilter_admin_album_stat_tile');
-}
-
-function bratonien_tools_prefilter_admin_album_stat_tile($source)
-{
-  return str_replace('{if $NB_ALBUMS > 1}', '{if $NB_ALBUMS > 0}', $source);
 }
 
 function bratonien_tools_admin_menu($menu)
 {
   $menu[] = array(
     'NAME' => 'Bratonien Tools',
-    'URL'  => get_root_url() . 'admin.php?page=plugin-' . BRATONIEN_TOOLS_ID,
+    'URL' => get_root_url() . 'admin.php?page=plugin-' . BRATONIEN_TOOLS_ID,
   );
+
   return $menu;
 }
-?>

runtime/lib/build_webdav_placeholder_source.py

@@ -25,7 +25,6 @@ from pathlib import Path, PurePosixPath
 
 DAV = "DAV:"
 OC = "http://owncloud.org/ns"
-NC = "http://nextcloud.org/ns"
 SUPPORTED_IMAGE_EXTENSIONS = {".jpg", ".jpeg", ".png", ".gif", ".webp"}
 # 1x1 transparent GIF, 34 bytes. The filename keeps the remote extension;
 # the placeholder exists only so Piwigo can discover the logical image entry.
@@ -55,49 +54,6 @@ def safe_local_name(name: str) -> str:
     return name
 
 
-def parse_image_dimensions(prop: ET.Element) -> tuple[int, int]:
-    for property_name in ("metadata-photos-size", "file-metadata-size"):
-        element = prop.find(f"{{{NC}}}{property_name}")
-        if element is None:
-            continue
-
-        width = 0
-        height = 0
-        for child in list(element):
-            local_name = child.tag.rsplit("}", 1)[-1]
-            text = (child.text or "").strip()
-            if not text:
-                continue
-            try:
-                value = int(text)
-            except ValueError:
-                continue
-            if local_name == "width":
-                width = value
-            elif local_name == "height":
-                height = value
-        if width > 0 and height > 0:
-            return width, height
-
-        raw = (element.text or "").strip()
-        if not raw:
-            continue
-        try:
-            value = json.loads(raw)
-        except (TypeError, ValueError, json.JSONDecodeError):
-            continue
-        if not isinstance(value, dict):
-            continue
-        try:
-            width = int(value.get("width", 0) or 0)
-            height = int(value.get("height", 0) or 0)
-        except (TypeError, ValueError):
-            continue
-        if width > 0 and height > 0:
-            return width, height
-    return 0, 0
-
-
 class WebDavClient:
     def __init__(self, base_url: str, user: str, password: str, timeout: int = 30) -> None:
         self.base_url = base_url.rstrip("/")
@@ -121,11 +77,9 @@ class WebDavClient:
         url = self.collection_url(relative)
         body = (
             '<?xml version="1.0"?>'
-            '<d:propfind xmlns:d="DAV:" xmlns:oc="http://owncloud.org/ns" xmlns:nc="http://nextcloud.org/ns">'
+            '<d:propfind xmlns:d="DAV:" xmlns:oc="http://owncloud.org/ns">'
             '<d:prop><d:displayname/><d:resourcetype/><d:getcontenttype/>'
-            '<d:getcontentlength/><d:getetag/><oc:fileid/>'
+            '<d:getcontentlength/><d:getetag/><oc:fileid/></d:prop></d:propfind>'
-            '<nc:file-metadata-size/><nc:metadata-photos-size/>'
-            '</d:prop></d:propfind>'
         ).encode("utf-8")
         request = urllib.request.Request(url, data=body, method="PROPFIND")
         request.add_header("Authorization", self.auth_header)
@@ -168,7 +122,6 @@ class WebDavClient:
             fileid_text = prop.findtext(f"{{{OC}}}fileid", default="").strip()
             resource_type = prop.find(f"{{{DAV}}}resourcetype")
             is_dir = resource_type is not None and resource_type.find(f"{{{DAV}}}collection") is not None
-            width, height = parse_image_dimensions(prop)
             item = {
                 "display_name": display,
                 "fileid": int(fileid_text) if fileid_text.isdigit() else 0,
@@ -176,8 +129,6 @@ class WebDavClient:
                 "content_type": prop.findtext(f"{{{DAV}}}getcontenttype", default=""),
                 "size": int(prop.findtext(f"{{{DAV}}}getcontentlength", default="0") or 0),
                 "etag": prop.findtext(f"{{{DAV}}}getetag", default="").strip('"'),
-                "width": width,
-                "height": height,
             }
             if href_path == base_path:
                 current = item
@@ -246,8 +197,6 @@ def build_root(
                 "content_type": str(child.get("content_type", "")),
                 "size": int(child.get("size", 0)),
                 "etag": str(child.get("etag", "")),
-                "width": int(child.get("width", 0) or 0),
-                "height": int(child.get("height", 0) or 0),
             }
     return files, folders, skipped
 
@@ -320,20 +269,7 @@ def main() -> int:
             total_files += files
             total_folders += folders
             total_skipped += skipped
-
+            manifest.append(f"webdav:{fileid}\tfolder\t{display}\t{source_dir / local_name}")
-            if remote_root == "":
-                for child in sorted(local_root.iterdir(), key=lambda item: (item.name.casefold(), item.name)):
-                    child_data = mapping.get(str(child))
-                    if not child_data:
-                        continue
-                    child_fileid = int(child_data.get("fileid", 0))
-                    child_display = str(child_data.get("display_name", "")).strip() or child.name
-                    child_type = "folder" if child.is_dir() else "file"
-                    manifest.append(
-                        f"webdav:{child_fileid}\t{child_type}\t{child_display}\t{source_dir / local_name / child.name}"
-                    )
-            else:
-                manifest.append(f"webdav:{fileid}\tfolder\t{display}\t{source_dir / local_name}")
 
         if previous.exists():
             shutil.rmtree(previous)

runtime/lib/precache-webdav-previews.php

@@ -32,7 +32,7 @@ function fetch_remote_blob($url, $user, $password)
     CURLOPT_HTTPAUTH => CURLAUTH_BASIC,
     CURLOPT_USERPWD => $user.':'.$password,
     CURLOPT_FAILONERROR => false,
-    CURLOPT_USERAGENT => 'Bratonien-Tools-WebDAV-Precache/0.9.6.8.21',
+    CURLOPT_USERAGENT => 'Bratonien-Tools-WebDAV-Precache/0.9.6.1',
   ));
   $body = curl_exec($ch);
   $errno = curl_errno($ch);

runtime/lib/shadow_tree.py

@@ -12,7 +12,6 @@ from pathlib import Path
 
 ALLOWED = frozenset("abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789-_.")
 GERMAN = str.maketrans({"ä": "ae", "ö": "oe", "ü": "ue", "Ä": "Ae", "Ö": "Oe", "Ü": "Ue", "ß": "ss", "ẞ": "SS"})
-SHADOW_DIR_MODE = 0o777
 
 
 def safe_name(name: str) -> str:
@@ -80,13 +79,8 @@ def preferred_target(source_key: str, raw_name: str, parent_target: Path, old_ma
     return safe_name(raw_name)
 
 
-def ensure_shadow_directory(path: Path) -> None:
-    path.mkdir(parents=True, exist_ok=True)
-    path.chmod(SHADOW_DIR_MODE)
-
-
 def mirror_directory(source: Path, target: Path, source_key: str, target_key: Path, old_map: dict[str, str], new_map: dict[str, str]) -> None:
-    ensure_shadow_directory(target)
+    target.mkdir(parents=True, exist_ok=True)
     used: set[str] = set()
     for child in sorted(source.iterdir(), key=lambda item: (item.name.casefold(), item.name)):
         if child.is_symlink():
@@ -122,7 +116,7 @@ def build(manifest: Path, destination: Path, state_file: Path) -> None:
     remove_tree(previous)
     if state_staging.exists():
         state_staging.unlink()
-    ensure_shadow_directory(staging)
+    staging.mkdir(parents=True)
 
     try:
         used_roots: set[str] = set()

runtime/lib/sync-webdav-metadata.php

@@ -1,106 +0,0 @@
-#!/usr/bin/env php
-<?php
-if (PHP_SAPI !== 'cli')
-{
-  fwrite(STDERR, "CLI only\n");
-  exit(1);
-}
-
-$options = getopt('', array('piwigo-root:', 'connection-id:', 'mapping:'));
-$piwigo_root = rtrim((string)($options['piwigo-root'] ?? ''), '/');
-$connection_id = (int)($options['connection-id'] ?? 0);
-$mapping_file = (string)($options['mapping'] ?? '');
-
-if ($piwigo_root === '' || $connection_id < 1 || $mapping_file === '' || !is_readable($mapping_file))
-{
-  fwrite(STDERR, "Parameter --piwigo-root, --connection-id und --mapping werden benoetigt.\n");
-  exit(1);
-}
-
-$mapping = json_decode((string)file_get_contents($mapping_file), true);
-if (!is_array($mapping) || !isset($mapping['files']) || !is_array($mapping['files']))
-{
-  fwrite(STDERR, "WebDAV-Mapping ist ungueltig.\n");
-  exit(1);
-}
-
-$dimensions = array();
-foreach ($mapping['files'] as $path => $entry)
-{
-  if (!is_array($entry) || (string)($entry['kind'] ?? '') !== 'file') continue;
-  $width = (int)($entry['width'] ?? 0);
-  $height = (int)($entry['height'] ?? 0);
-  if ($width < 1 || $height < 1) continue;
-  $dimensions[str_replace('\\', '/', (string)$path)] = array($width, $height);
-}
-
-if (!$dimensions)
-{
-  fwrite(STDERR, "WebDAV-Mapping enthaelt keine Originalabmessungen.\n");
-  exit(1);
-}
-
-define('PHPWG_ROOT_PATH', $piwigo_root.'/');
-$_SERVER['REMOTE_ADDR'] = '127.0.0.1';
-$_SERVER['SERVER_ADDR'] = '127.0.0.1';
-$_SERVER['SERVER_NAME'] = 'localhost';
-$_SERVER['HTTP_HOST'] = 'localhost';
-$_SERVER['SERVER_PORT'] = '80';
-$_SERVER['REQUEST_METHOD'] = 'GET';
-$_SERVER['REQUEST_URI'] = '/';
-$_SERVER['SCRIPT_NAME'] = '/plugins/bratonien_tools/runtime/lib/sync-webdav-metadata.php';
-$_SERVER['PHP_SELF'] = $_SERVER['SCRIPT_NAME'];
-$_SERVER['QUERY_STRING'] = '';
-$_SERVER['HTTP_USER_AGENT'] = 'Bratonien-WebDAV-Metadata/0.9.6.8.20';
-$_SERVER['HTTPS'] = 'off';
-
-require_once(PHPWG_ROOT_PATH.'include/common.inc.php');
-
-$checked = 0;
-$updated = 0;
-$missing = 0;
-$result = pwg_query('SELECT id, path, width, height FROM '.IMAGES_TABLE.' ORDER BY id');
-while ($row = pwg_db_fetch_assoc($result))
-{
-  $path = (string)($row['path'] ?? '');
-  if ($path === '') continue;
-
-  $absolute = $path;
-  if (strpos($absolute, '/') !== 0)
-  {
-    $absolute = PHPWG_ROOT_PATH.ltrim(preg_replace('#^\./#', '', $absolute), '/');
-  }
-
-  $normalized_shadow = str_replace('\\', '/', $absolute);
-  if (strpos($normalized_shadow, '/nc-webdav-gallery/connection-'.$connection_id.'/') === false) continue;
-
-  $checked++;
-  $resolved = realpath($absolute);
-  if ($resolved === false)
-  {
-    $missing++;
-    continue;
-  }
-
-  $key = str_replace('\\', '/', $resolved);
-  if (!isset($dimensions[$key]))
-  {
-    $missing++;
-    continue;
-  }
-
-  list($width, $height) = $dimensions[$key];
-  if ((int)$row['width'] === $width && (int)$row['height'] === $height) continue;
-
-  pwg_query('UPDATE '.IMAGES_TABLE.' SET width='.$width.', height='.$height.' WHERE id='.(int)$row['id']);
-  $updated++;
-}
-
-if ($updated > 0)
-{
-  if (function_exists('update_category')) update_category('all');
-  if (function_exists('invalidate_user_cache')) invalidate_user_cache(true);
-}
-
-echo 'WebDAV-Metadaten: bilder='.$checked.' aktualisiert='.$updated.' ohne_masse='.$missing."\n";
-exit($missing > 0 ? 1 : 0);

runtime/reconcile-webdav.php

@@ -20,7 +20,6 @@ function decrypt_webdav_credentials($blob, $hexKey)
   $iv = base64_decode((string)($payload['iv'] ?? ''), true);
   $tag = base64_decode((string)($payload['tag'] ?? ''), true);
   $cipher = base64_decode((string)($payload['data'] ?? ''), true);
-  if (!is_string($iv) || !is_string($tag) || !is_string($cipher)) fail_webdav_reconcile('Connector-Zugangsdaten sind unvollstaendig.');
   $plain = openssl_decrypt($cipher, 'aes-256-gcm', hex2bin($hexKey), OPENSSL_RAW_DATA, $iv, $tag);
   if ($plain === false || $plain === '') fail_webdav_reconcile('Connector-Zugangsdaten konnten nicht entschluesselt werden.');
   $decoded = json_decode($plain, true);
@@ -76,19 +75,11 @@ function webdav_source_fingerprint($baseUrl, $user, array $roots)
   return hash('sha256', strtolower(rtrim((string)$baseUrl, '/'))."\n".strtolower(trim((string)$user))."\n".json_encode($normalized));
 }
 
-function webdav_set_runtime_dir_permissions($dir)
-{
-  if (!is_dir($dir)) return false;
-  if (!@chgrp($dir, 'www-data')) return false;
-  return @chmod($dir, 0750);
-}
-
 $pluginRoot = dirname(__DIR__);
 $piwigoRoot = dirname($pluginRoot, 2);
 $dbConfig = $piwigoRoot.'/local/config/database.inc.php';
 $configDir = '/etc/bratonien-tools/nc-connector';
-$stateBase = '/var/lib/bratonien-tools';
+$stateRoot = '/var/lib/bratonien-tools/nc-connector';
-$stateRoot = $stateBase.'/nc-connector';
 $publicSourceRoot = rtrim($piwigoRoot, '/').'/_data/bratonien-tools/nc-webdav-source';
 $publicGalleryRoot = rtrim($piwigoRoot, '/').'/_data/bratonien-tools/nc-webdav-gallery';
 
@@ -120,8 +111,7 @@ try
     if (!is_dir($dir) && !mkdir($dir, $dir === $configDir ? 0700 : 0750, true)) fail_webdav_reconcile('Runtime-Verzeichnis konnte nicht angelegt werden: '.$dir);
   }
   @chmod($configDir, 0700);
-  if (!webdav_set_runtime_dir_permissions($stateBase)) fail_webdav_reconcile('Runtime-State-Basis konnte nicht fuer den Webserver freigegeben werden.');
+  @chmod($stateRoot, 0750);
-  if (!webdav_set_runtime_dir_permissions($stateRoot)) fail_webdav_reconcile('Runtime-State-Verzeichnis konnte nicht fuer den Webserver freigegeben werden.');
   @chmod($publicSourceRoot, 0755);
   @chmod($publicGalleryRoot, 0755);
 
@@ -161,7 +151,7 @@ try
       $stateDir = rtrim((string)($config['state_dir'] ?? ''), '/');
       if ($stateDir === '') $stateDir = $stateRoot.'/connection-'.$id;
       if (!is_dir($stateDir) && !mkdir($stateDir, 0750, true)) fail_webdav_reconcile('State-Verzeichnis konnte nicht angelegt werden.');
-      if (!webdav_set_runtime_dir_permissions($stateDir)) fail_webdav_reconcile('State-Verzeichnis konnte nicht fuer den Webserver freigegeben werden.');
+      @chmod($stateDir, 0750);
 
       $galleryRoot = rtrim((string)($config['parallel_gallery_root'] ?? ''), '/');
       $expectedGalleryRoot = $publicGalleryRoot.'/connection-'.$id;
@@ -190,7 +180,7 @@ try
       {
         $path = trim((string)($root['webdav_path'] ?? ''), '/');
         $display = trim((string)($root['display_name'] ?? ''));
-        if ($display === '' || preg_match('/[\t\r\n]/', $path.$display)) fail_webdav_reconcile('Eine gespeicherte WebDAV-Wurzel ist ungueltig.');
+        if ($path === '' || $display === '' || preg_match('/[\t\r\n]/', $path.$display)) fail_webdav_reconcile('Eine gespeicherte WebDAV-Wurzel ist ungueltig.');
         $rootLines[] = $path."\t".$display;
       }
       file_put_contents($rootsPath, implode("\n", $rootLines)."\n", LOCK_EX);

runtime/repair-webdav-orphans.php

@@ -1,101 +0,0 @@
-#!/usr/bin/env php
-<?php
-if (PHP_SAPI !== 'cli')
-{
-  fwrite(STDERR, "CLI only\n");
-  exit(1);
-}
-
-$pluginRoot = dirname(__DIR__);
-$piwigoRoot = dirname($pluginRoot, 2);
-define('PHPWG_ROOT_PATH', rtrim($piwigoRoot, '/').'/');
-
-$_SERVER['REMOTE_ADDR'] = '127.0.0.1';
-$_SERVER['SERVER_ADDR'] = '127.0.0.1';
-$_SERVER['SERVER_NAME'] = 'localhost';
-$_SERVER['HTTP_HOST'] = 'localhost';
-$_SERVER['SERVER_PORT'] = '80';
-$_SERVER['REQUEST_METHOD'] = 'GET';
-$_SERVER['REQUEST_URI'] = '/';
-$_SERVER['SCRIPT_NAME'] = '/plugins/bratonien_tools/runtime/repair-webdav-orphans.php';
-$_SERVER['PHP_SELF'] = $_SERVER['SCRIPT_NAME'];
-$_SERVER['QUERY_STRING'] = '';
-$_SERVER['HTTPS'] = 'off';
-
-require_once(PHPWG_ROOT_PATH.'include/common.inc.php');
-require_once(PHPWG_ROOT_PATH.'admin/include/functions.php');
-
-$stateRoot = '/var/lib/bratonien-tools/nc-connector';
-$marker = $stateRoot.'/.webdav-orphan-repair-0963.done';
-
-try
-{
-  if (is_file($marker))
-  {
-    echo "NC WebDAV Altlasten-Reparatur: bereits abgeschlossen.\n";
-    exit(0);
-  }
-
-  if (!is_dir($stateRoot) && !mkdir($stateRoot, 0750, true))
-  {
-    throw new RuntimeException('State-Verzeichnis konnte nicht angelegt werden: '.$stateRoot);
-  }
-
-  $relativePrefix = './_data/bratonien-tools/nc-webdav-gallery/connection-';
-  $absolutePrefix = rtrim(PHPWG_ROOT_PATH, '/').'/_data/bratonien-tools/nc-webdav-gallery/connection-';
-  $relativeLength = strlen($relativePrefix);
-  $absoluteLength = strlen($absolutePrefix);
-
-  $query = "SELECT id,path FROM ".IMAGES_TABLE.
-    " WHERE LEFT(path,".$relativeLength.")='".pwg_db_real_escape_string($relativePrefix)."'".
-    " OR LEFT(path,".$absoluteLength.")='".pwg_db_real_escape_string($absolutePrefix)."'";
-  $result = pwg_query($query);
-
-  $staleIds = array();
-  while ($row = pwg_db_fetch_assoc($result))
-  {
-    $id = (int)$row['id'];
-    $storedPath = (string)$row['path'];
-    if ($id < 1 || $storedPath === '') continue;
-
-    if (strpos($storedPath, $relativePrefix) === 0)
-    {
-      $filesystemPath = rtrim(PHPWG_ROOT_PATH, '/').'/'.ltrim(substr($storedPath, 2), '/');
-    }
-    elseif (strpos($storedPath, $absolutePrefix) === 0)
-    {
-      $filesystemPath = $storedPath;
-    }
-    else
-    {
-      continue;
-    }
-
-    if (!is_file($filesystemPath))
-    {
-      $staleIds[] = $id;
-    }
-  }
-
-  $staleIds = array_values(array_unique(array_map('intval', $staleIds)));
-  if ($staleIds)
-  {
-    delete_elements($staleIds, false);
-    invalidate_user_cache(true);
-  }
-
-  $payload = date('c').' removed='.count($staleIds)."\n";
-  if (file_put_contents($marker, $payload, LOCK_EX) === false)
-  {
-    throw new RuntimeException('Abschlussmarker konnte nicht geschrieben werden: '.$marker);
-  }
-  @chmod($marker, 0640);
-
-  echo 'NC WebDAV Altlasten-Reparatur: entfernte verwaiste Bilder='.count($staleIds)."\n";
-  exit(0);
-}
-catch (Throwable $e)
-{
-  fwrite(STDERR, 'NC WebDAV Altlasten-Reparatur: '.$e->getMessage()."\n");
-  exit(1);
-}

runtime/run-all.sh

@@ -10,11 +10,6 @@ if ! php "$SCRIPT_DIR/reconcile-webdav.php"; then
     exit 1
 fi
 
-if ! php "$SCRIPT_DIR/repair-webdav-orphans.php"; then
-    echo "NC Connector: verwaiste WebDAV-Bilddatensaetze konnten nicht repariert werden." >&2
-    exit 1
-fi
-
 if ! php "$SCRIPT_DIR/cleanup-webdav-piwigo.php"; then
     echo "NC Connector: Piwigo-Inhalte geloeschter WebDAV-Verbindungen konnten nicht bereinigt werden." >&2
     exit 1

runtime/sync-webdav.sh

@@ -28,8 +28,6 @@ source "$CONFIG_FILE"
 SCRIPT_DIR="$(cd -- "$(dirname -- "${BASH_SOURCE[0]}")" && pwd)"
 LOCK_FILE="$STATE_DIR/webdav-sync.lock"
 mkdir -p -- "$STATE_DIR"
-chgrp www-data -- "$STATE_DIR"
-chmod 0750 -- "$STATE_DIR"
 exec 9>"$LOCK_FILE"
 flock -n 9 || exit 0
 
@@ -68,18 +66,14 @@ compact_output() {
 failure() {
     local code="$1" command="$2" line="$3"
     trap - ERR
-    write_status error "WebDAV-Synchronisierung fehlgeschlagen" "Exit-Code: $code; Zeile: $line; Befehl: $command"
+    write_status error "WebDAV-Shadow-Tree fehlgeschlagen" "Exit-Code: $code; Zeile: $line; Befehl: $command"
     exit "$code"
 }
 trap 'failure $? "$BASH_COMMAND" "$LINENO"' ERR
 
-write_status running "WebDAV-Synchronisierung läuft"
-
 ROOT_ARGS=()
-while IFS= read -r line; do
+while IFS=$'\t' read -r path display_name; do
-    [[ -z "$line" || "$line" == \#* ]] && continue
+    [[ -z "$path" || "$path" == \#* ]] && continue
-    [[ "$line" == *$'\t'* ]] || continue
-    path="${line%%$'\t'*}"
     ROOT_ARGS+=(--root "$path")
 done < "$WEBDAV_ROOTS_FILE"
 
@@ -94,15 +88,34 @@ python3 "$SCRIPT_DIR/lib/build_webdav_placeholder_source.py" \
     --manifest "$MANIFEST" \
     --mapping "$WEBDAV_MAPPING_FILE"
 
-chgrp www-data -- "$WEBDAV_MAPPING_FILE"
-chmod 0640 -- "$WEBDAV_MAPPING_FILE"
-
 python3 "$SCRIPT_DIR/lib/shadow_tree.py" \
     --manifest "$MANIFEST" \
     --destination "$GALLERY_ROOT" \
     --state "$SHADOW_MAP_FILE"
 
 trap - ERR
+PREVIEW_CACHE="$PIWIGO_ROOT/_data/bratonien-tools/nc-webdav-preview/connection-$CONNECTION_ID"
+PREVIEW_OUTPUT=""
+PREVIEW_EXIT=0
+if PREVIEW_OUTPUT="$(php "$SCRIPT_DIR/lib/precache-webdav-previews.php" \
+    --mapping="$WEBDAV_MAPPING_FILE" \
+    --base-url="$WEBDAV_BASE_URL" \
+    --user="$WEBDAV_USER" \
+    --password-file="$WEBDAV_PASSWORD_FILE" \
+    --cache-dir="$PREVIEW_CACHE" 2>&1)"; then
+    PREVIEW_EXIT=0
+else
+    PREVIEW_EXIT=$?
+fi
+[[ -z "$PREVIEW_OUTPUT" ]] || printf '%s\n' "$PREVIEW_OUTPUT"
+if [[ "$PREVIEW_EXIT" -ne 0 ]]; then
+    DETAIL="Exit-Code: $PREVIEW_EXIT"
+    if [[ -n "$PREVIEW_OUTPUT" ]]; then
+        DETAIL+="; Ausgabe: $(printf '%s\n' "$PREVIEW_OUTPUT" | compact_output)"
+    fi
+    write_status error "WebDAV-Vorschaubilder konnten beim Einlesen nicht erzeugt werden" "$DETAIL"
+    exit "$PREVIEW_EXIT"
+fi
 
 if [[ "${PIWIGO_SYNC_ENABLED:-0}" == "1" ]]; then
     PIWIGO_OUTPUT=""
@@ -147,29 +160,28 @@ if [[ "${PIWIGO_SYNC_ENABLED:-0}" == "1" ]]; then
         exit "$PIWIGO_EXIT"
     fi
 
-    METADATA_OUTPUT=""
+    DERIVATIVE_OUTPUT=""
-    METADATA_EXIT=0
+    DERIVATIVE_EXIT=0
-    if METADATA_OUTPUT="$(php "$SCRIPT_DIR/lib/sync-webdav-metadata.php" \
+    if DERIVATIVE_OUTPUT="$(php "$SCRIPT_DIR/lib/build-webdav-derivatives.php" \
         --piwigo-root="$PIWIGO_ROOT" \
-        --connection-id="$CONNECTION_ID" \
+        --connection-id="$CONNECTION_ID" 2>&1)"; then
-        --mapping="$WEBDAV_MAPPING_FILE" 2>&1)"; then
+        DERIVATIVE_EXIT=0
-        METADATA_EXIT=0
     else
-        METADATA_EXIT=$?
+        DERIVATIVE_EXIT=$?
     fi
-    [[ -z "$METADATA_OUTPUT" ]] || printf '%s\n' "$METADATA_OUTPUT"
+    [[ -z "$DERIVATIVE_OUTPUT" ]] || printf '%s\n' "$DERIVATIVE_OUTPUT"
-    if [[ "$METADATA_EXIT" -ne 0 ]]; then
+    if [[ "$DERIVATIVE_EXIT" -ne 0 ]]; then
-        DETAIL="Exit-Code: $METADATA_EXIT"
+        DETAIL="Exit-Code: $DERIVATIVE_EXIT"
-        if [[ -n "$METADATA_OUTPUT" ]]; then
+        if [[ -n "$DERIVATIVE_OUTPUT" ]]; then
-            DETAIL+="; Ausgabe: $(printf '%s\n' "$METADATA_OUTPUT" | compact_output)"
+            DETAIL+="; Ausgabe: $(printf '%s\n' "$DERIVATIVE_OUTPUT" | compact_output)"
         fi
-        write_status error "Piwigo-Bildabmessungen konnten nicht mit den WebDAV-Metadaten abgeglichen werden" "$DETAIL"
+        write_status error "Piwigo-Derivate für WebDAV-Bilder konnten nicht erzeugt werden" "$DETAIL"
-        exit "$METADATA_EXIT"
+        exit "$DERIVATIVE_EXIT"
     fi
 
     if grep -q 'Piwigo-Synchronisierung per API erfolgreich' <<<"$PIWIGO_OUTPUT"; then
         write_status ok \
-            "WebDAV eingelesen und Piwigo synchronisiert" \
+            "WebDAV eingelesen, Piwigo synchronisiert und Derivate erzeugt" \
             "" \
             "api" \
             "ok" \
@@ -178,7 +190,7 @@ if [[ "${PIWIGO_SYNC_ENABLED:-0}" == "1" ]]; then
             "Fallback wurde nicht benötigt"
     elif grep -q 'Piwigo-Datenbanksynchronisierung per Benutzername/Passwort-Fallback erfolgreich' <<<"$PIWIGO_OUTPUT"; then
         write_status ok \
-            "WebDAV eingelesen und Piwigo über Fallback synchronisiert" \
+            "WebDAV eingelesen, Piwigo über Fallback synchronisiert und Derivate erzeugt" \
             "" \
             "fallback" \
             "not_used" \
@@ -186,8 +198,8 @@ if [[ "${PIWIGO_SYNC_ENABLED:-0}" == "1" ]]; then
             "ok" \
             "Benutzername/Passwort-Fallback erfolgreich"
     else
-        write_status ok "WebDAV eingelesen und Piwigo synchronisiert"
+        write_status ok "WebDAV eingelesen, Piwigo synchronisiert und Derivate erzeugt"
     fi
 else
-    write_status ok "WebDAV eingelesen; Registrierung erfolgt über den bestehenden produktiven Piwigo-Sync"
+    write_status ok "WebDAV eingelesen und Vorschaubilder erzeugt; Registrierung erfolgt über den bestehenden produktiven Piwigo-Sync"
 fi

template/nc_connector_admin.tpl

@@ -14,10 +14,6 @@
         <span class="bratonien-label">Nächster Lauf</span><strong data-nc-next-run>{if $nc_system_available}{$NC_CONNECTOR.system.next_run_label|escape:html}{else}Nicht verfügbar{/if}</strong>
       </div>
       {if $nc_system_available && $NC_CONNECTOR.system.last_run_message}<p class="bratonien-base-note">Letztes Ergebnis: <strong>{$NC_CONNECTOR.system.last_run_message|escape:html}</strong></p>{/if}
-      <form method="post" class="bratonien-actions" style="margin-top:.75rem">
-        <input type="hidden" name="pwg_token" value="{$PWG_TOKEN|escape:html}">
-        <button class="buttonLike" type="submit" name="bratonien_tool" value="nc_connector_run_now"{if $NC_CONNECTOR.connection_count < 1} disabled{/if}>Jetzt abrufen</button>
-      </form>
       {if $nc_system_available && $NC_CONNECTOR.system.last_run_api_state == 'error'}<p class="bratonien-main-cache__warning"><strong>API:</strong> {$NC_CONNECTOR.system.last_run_api_message|escape:html}</p>{/if}
       {if $nc_system_available && $NC_CONNECTOR.system.last_run_fallback_state == 'error'}<p class="bratonien-main-cache__warning"><strong>Fallback:</strong> {$NC_CONNECTOR.system.last_run_fallback_message|escape:html}</p>{/if}
       {if $nc_system_available && $NC_CONNECTOR.system.last_run_error_detail}<details><summary>Technische Fehlerdetails</summary><p class="bratonien-main-cache__warning">{$NC_CONNECTOR.system.last_run_error_detail|escape:html}</p></details>{/if}

webdav-derivative-debug.php

@@ -1,183 +0,0 @@
-<?php
-define('PHPWG_ROOT_PATH', '../../');
-include_once(PHPWG_ROOT_PATH.'include/common.inc.php');
-
-if (!defined('BRATONIEN_TOOLS_PATH'))
-{
-  define('BRATONIEN_TOOLS_ID', basename(__DIR__));
-  define('BRATONIEN_TOOLS_PATH', PHPWG_ROOT_PATH.'plugins/'.BRATONIEN_TOOLS_ID.'/');
-}
-require_once(BRATONIEN_TOOLS_PATH.'include/webdav_image_runtime.inc.php');
-
-function bratonien_tools_webdav_debug_out($status, array $data)
-{
-  http_response_code((int)$status);
-  header('Content-Type: application/json; charset=utf-8');
-  header('Cache-Control: no-store');
-  echo json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
-  exit;
-}
-
-global $user;
-if (!isset($user['status']) || !in_array($user['status'], array('admin', 'webmaster'), true))
-{
-  bratonien_tools_webdav_debug_out(403, array('ok'=>false, 'stage'=>'auth', 'error'=>'Nur fuer Administratoren/Webmaster.'));
-}
-
-$image_id = (int)($_GET['id'] ?? 0);
-if ($image_id < 1)
-{
-  bratonien_tools_webdav_debug_out(400, array('ok'=>false, 'stage'=>'input', 'error'=>'Bild-ID fehlt.'));
-}
-
-$debug = array(
-  'ok'=>false,
-  'image_id'=>$image_id,
-  'stage'=>'start',
-);
-
-$result = pwg_query('SELECT id, path, coi FROM '.IMAGES_TABLE.' WHERE id='.$image_id.' LIMIT 1');
-if (!pwg_db_num_rows($result))
-{
-  $debug['stage'] = 'image-row';
-  $debug['error'] = 'Bild nicht gefunden.';
-  bratonien_tools_webdav_debug_out(404, $debug);
-}
-$row = pwg_db_fetch_assoc($result);
-$image_path = (string)($row['path'] ?? '');
-$debug['images_path'] = $image_path;
-
-$absolute = $image_path;
-if (strpos($absolute, '/') !== 0)
-{
-  $absolute = PHPWG_ROOT_PATH.ltrim(preg_replace('#^\./#', '', $absolute), '/');
-}
-$debug['absolute_path'] = $absolute;
-$debug['absolute_exists'] = file_exists($absolute);
-$debug['absolute_is_file'] = is_file($absolute);
-$debug['absolute_is_link'] = is_link($absolute);
-if (is_link($absolute))
-{
-  $debug['link_target'] = readlink($absolute);
-}
-
-$resolved = realpath($absolute);
-$debug['realpath'] = $resolved === false ? null : $resolved;
-if ($resolved === false)
-{
-  $debug['stage'] = 'realpath';
-  $debug['error'] = 'realpath() konnte images.path nicht aufloesen.';
-  bratonien_tools_webdav_debug_out(200, $debug);
-}
-
-$normalized = str_replace('\\', '/', $resolved);
-$debug['normalized_realpath'] = $normalized;
-
-$match = array();
-if (!preg_match('#/nc-webdav-source/connection-([0-9]+)/root-([0-9]+)/(.*)$#', $normalized, $match))
-{
-  $debug['stage'] = 'source-regex';
-  $debug['error'] = 'realpath passt nicht zum erwarteten nc-webdav-source-Schema.';
-  bratonien_tools_webdav_debug_out(200, $debug);
-}
-
-$connection_id = (int)$match[1];
-$root_fileid = (int)$match[2];
-$relative_path = trim((string)$match[3], '/');
-$debug['connection_id'] = $connection_id;
-$debug['root_fileid'] = $root_fileid;
-$debug['relative_path'] = $relative_path;
-
-$table = defined('BRATONIEN_TOOLS_NC_CONNECTIONS_TABLE')
-  ? BRATONIEN_TOOLS_NC_CONNECTIONS_TABLE
-  : $GLOBALS['prefixeTable'].'bratonien_tools_nc_connections';
-$debug['connections_table'] = $table;
-
-$connection_result = pwg_query('SELECT id, enabled, adapter, config_json FROM `'.$table.'` WHERE id='.$connection_id.' LIMIT 1');
-if (!pwg_db_num_rows($connection_result))
-{
-  $debug['stage'] = 'connection-row';
-  $debug['error'] = 'Erkannte WebDAV-Verbindung existiert nicht in der Connector-Tabelle.';
-  bratonien_tools_webdav_debug_out(200, $debug);
-}
-$connection_row = pwg_db_fetch_assoc($connection_result);
-$debug['connection_enabled'] = (int)($connection_row['enabled'] ?? 0);
-$debug['connection_adapter'] = (string)($connection_row['adapter'] ?? '');
-
-$config = json_decode((string)($connection_row['config_json'] ?? ''), true);
-if (!is_array($config))
-{
-  $debug['stage'] = 'config-json';
-  $debug['error'] = 'config_json ist kein gueltiges JSON-Objekt.';
-  bratonien_tools_webdav_debug_out(200, $debug);
-}
-
-$debug['source_mode'] = (string)($config['source_mode'] ?? '');
-$debug['state_dir'] = (string)($config['state_dir'] ?? '');
-$debug['parallel_gallery_root'] = (string)($config['parallel_gallery_root'] ?? '');
-
-$roots = isset($config['roots']) && is_array($config['roots']) ? $config['roots'] : array();
-$debug['roots'] = array();
-$root_path = '';
-foreach ($roots as $root)
-{
-  $entry = array(
-    'fileid'=>(int)($root['fileid'] ?? 0),
-    'webdav_path'=>(string)($root['webdav_path'] ?? ''),
-    'display_name'=>(string)($root['display_name'] ?? ''),
-  );
-  $debug['roots'][] = $entry;
-  if ($entry['fileid'] === $root_fileid)
-  {
-    $root_path = trim($entry['webdav_path'], '/');
-  }
-}
-$debug['matched_root_path'] = $root_path;
-if ($debug['source_mode'] !== 'webdav-placeholder')
-{
-  $debug['stage'] = 'source-mode';
-  $debug['error'] = 'source_mode ist nicht webdav-placeholder.';
-  bratonien_tools_webdav_debug_out(200, $debug);
-}
-if ($root_path === '')
-{
-  $debug['stage'] = 'root-match';
-  $debug['error'] = 'root_fileid aus dem Dateipfad kommt in config.roots nicht vor.';
-  bratonien_tools_webdav_debug_out(200, $debug);
-}
-
-$mapping_file = rtrim((string)($config['state_dir'] ?? ''), '/').'/webdav-map.json';
-$debug['mapping_file'] = $mapping_file;
-$debug['mapping_readable'] = is_readable($mapping_file);
-$debug['mapping_has_resolved_key'] = false;
-$debug['mapping_has_normalized_key'] = false;
-$debug['mapping_entry'] = null;
-
-if (is_readable($mapping_file))
-{
-  $mapping = json_decode((string)file_get_contents($mapping_file), true);
-  if (is_array($mapping) && isset($mapping['files']) && is_array($mapping['files']))
-  {
-    $debug['mapping_has_resolved_key'] = array_key_exists($resolved, $mapping['files']);
-    $debug['mapping_has_normalized_key'] = array_key_exists($normalized, $mapping['files']);
-    $entry = $mapping['files'][$resolved] ?? $mapping['files'][$normalized] ?? null;
-    if (is_array($entry))
-    {
-      $debug['mapping_entry'] = $entry;
-    }
-  }
-  else
-  {
-    $debug['mapping_error'] = 'Mapping-Datei ist ungueltig oder enthaelt kein files-Objekt.';
-  }
-}
-
-$debug['runtime_source_info'] = bratonien_tools_webdav_image_source_info($image_id);
-$debug['stage'] = $debug['runtime_source_info'] ? 'ok' : 'runtime-source-info-null';
-$debug['ok'] = (bool)$debug['runtime_source_info'];
-if (!$debug['ok'])
-{
-  $debug['error'] = 'Die produktive Zuordnungsfunktion liefert trotz der obigen Zwischenergebnisse null.';
-}
-
-bratonien_tools_webdav_debug_out(200, $debug);

webdav-derivative-test.php

@@ -1,494 +0,0 @@
-<?php
-define('PHPWG_ROOT_PATH', '../../');
-include_once(PHPWG_ROOT_PATH.'include/common.inc.php');
-require_once(PHPWG_ROOT_PATH.'include/derivative.inc.php');
-
-function bratonien_tools_webdav_derivative_test_abort($status, $message)
-{
-  http_response_code((int)$status);
-  header('Content-Type: text/plain; charset=utf-8');
-  header('Cache-Control: no-store');
-  echo $message;
-  exit;
-}
-
-function bratonien_tools_webdav_derivative_test_decrypt_secret($blob, $hex_key)
-{
-  $hex_key = trim((string)$hex_key);
-  if (!preg_match('/^[a-f0-9]{64}$/', $hex_key)) return null;
-
-  $outer = base64_decode(trim((string)$blob), true);
-  $payload = is_string($outer) ? json_decode($outer, true) : null;
-  if (!is_array($payload) || (int)($payload['v'] ?? 0) !== 1) return null;
-
-  $iv = base64_decode((string)($payload['iv'] ?? ''), true);
-  $tag = base64_decode((string)($payload['tag'] ?? ''), true);
-  $cipher = base64_decode((string)($payload['data'] ?? ''), true);
-  if (!is_string($iv) || !is_string($tag) || !is_string($cipher)) return null;
-
-  $plain = openssl_decrypt($cipher, 'aes-256-gcm', hex2bin($hex_key), OPENSSL_RAW_DATA, $iv, $tag);
-  if ($plain === false) return null;
-
-  $decoded = json_decode((string)$plain, true);
-  return is_array($decoded) ? $decoded : null;
-}
-
-function bratonien_tools_webdav_derivative_test_quote_path($path)
-{
-  $parts = array_values(array_filter(explode('/', trim((string)$path, '/')), 'strlen'));
-  return implode('/', array_map('rawurlencode', $parts));
-}
-
-function bratonien_tools_webdav_derivative_test_source_info($image_id, array $image_row)
-{
-  $image_id = (int)$image_id;
-  $path = (string)($image_row['path'] ?? '');
-  if ($image_id < 1 || $path === '') return null;
-
-  $absolute = $path;
-  if (strpos($absolute, '/') !== 0)
-  {
-    $absolute = PHPWG_ROOT_PATH.ltrim(preg_replace('#^\\./#', '', $absolute), '/');
-  }
-
-  $resolved = realpath($absolute);
-  if ($resolved === false) return null;
-
-  $normalized = str_replace('\\', '/', $resolved);
-  if (!preg_match('#/nc-webdav-source/connection-([0-9]+)/root-([0-9]+)/(.*)$#', $normalized, $match))
-  {
-    return null;
-  }
-
-  $connection_id = (int)$match[1];
-  $root_fileid = (int)$match[2];
-  $relative_path = trim((string)$match[3], '/');
-  if ($connection_id < 1 || $root_fileid < 1 || $relative_path === '') return null;
-
-  $table = $GLOBALS['prefixeTable'].'bratonien_tools_nc_connections';
-  $connection_result = pwg_query('SELECT config_json FROM `'.$table.'` WHERE id='.$connection_id.' LIMIT 1');
-  if (!pwg_db_num_rows($connection_result)) return null;
-
-  $connection_row = pwg_db_fetch_assoc($connection_result);
-  $config = json_decode((string)$connection_row['config_json'], true);
-  if (!is_array($config) || (string)($config['source_mode'] ?? '') !== 'webdav-placeholder') return null;
-
-  $root_found = false;
-  $root_path = '';
-  $roots = isset($config['roots']) && is_array($config['roots']) ? $config['roots'] : array();
-  foreach ($roots as $root)
-  {
-    if ((int)($root['fileid'] ?? 0) === $root_fileid)
-    {
-      $root_found = true;
-      $root_path = trim((string)($root['webdav_path'] ?? ''), '/');
-      break;
-    }
-  }
-  if (!$root_found) return null;
-
-  $webdav_path = trim($root_path === '' ? $relative_path : $root_path.'/'.$relative_path, '/');
-  if ($webdav_path === '') return null;
-
-  $content_type = '';
-  $size = 0;
-  $etag = '';
-  $state_dir = rtrim((string)($config['state_dir'] ?? ''), '/');
-  if ($state_dir !== '')
-  {
-    $mapping_file = $state_dir.'/webdav-map.json';
-    if (is_readable($mapping_file))
-    {
-      $mapping = json_decode((string)file_get_contents($mapping_file), true);
-      if (is_array($mapping) && isset($mapping['files']) && is_array($mapping['files']))
-      {
-        $entry = $mapping['files'][$resolved] ?? $mapping['files'][$normalized] ?? null;
-        if (is_array($entry) && (string)($entry['kind'] ?? '') === 'file')
-        {
-          $webdav_path = trim((string)($entry['webdav_path'] ?? $webdav_path), '/');
-          $content_type = (string)($entry['content_type'] ?? '');
-          $size = (int)($entry['size'] ?? 0);
-          $etag = (string)($entry['etag'] ?? '');
-        }
-      }
-    }
-  }
-
-  return array(
-    'image_id'=>$image_id,
-    'connection_id'=>$connection_id,
-    'webdav_path'=>$webdav_path,
-    'content_type'=>$content_type,
-    'size'=>$size,
-    'etag'=>$etag,
-    'coi'=>$image_row['coi'] ?? null,
-  );
-}
-
-function bratonien_tools_webdav_derivative_test_download(array $source, $destination, &$detail=null)
-{
-  $detail = '';
-  $table = $GLOBALS['prefixeTable'].'bratonien_tools_nc_connections';
-  $result = pwg_query('SELECT config_json, secret_blob FROM `'.$table.'` WHERE id='.(int)$source['connection_id'].' LIMIT 1');
-  if (!pwg_db_num_rows($result))
-  {
-    $detail = 'WebDAV-Verbindung nicht gefunden.';
-    return false;
-  }
-
-  $row = pwg_db_fetch_assoc($result);
-  $config = json_decode((string)$row['config_json'], true);
-  if (!is_array($config))
-  {
-    $detail = 'WebDAV-Konfiguration ist ungueltig.';
-    return false;
-  }
-
-  $key_result = pwg_query("SELECT value FROM ".$GLOBALS['prefixeTable']."config WHERE param='bratonien_nc_connector_secret' LIMIT 1");
-  if (!pwg_db_num_rows($key_result))
-  {
-    $detail = 'Connector-Schluessel fehlt.';
-    return false;
-  }
-
-  $key_row = pwg_db_fetch_assoc($key_result);
-  $credentials = bratonien_tools_webdav_derivative_test_decrypt_secret((string)$row['secret_blob'], (string)$key_row['value']);
-  if (!is_array($credentials))
-  {
-    $detail = 'WebDAV-Zugangsdaten konnten nicht gelesen werden.';
-    return false;
-  }
-
-  $base_url = rtrim((string)($config['nextcloud_url'] ?? ''), '/');
-  $user = trim((string)($credentials['nextcloud_user'] ?? ''));
-  $password = (string)($credentials['nextcloud_password'] ?? '');
-  $webdav_path = trim((string)($source['webdav_path'] ?? ''), '/');
-  if ($base_url === '' || $user === '' || $password === '' || $webdav_path === '')
-  {
-    $detail = 'WebDAV-Bildquelle ist unvollstaendig.';
-    return false;
-  }
-
-  $fp = @fopen($destination, 'xb');
-  if (!$fp)
-  {
-    $detail = 'Temporaere Quelldatei konnte nicht angelegt werden.';
-    return false;
-  }
-
-  $url = $base_url.'/remote.php/dav/files/'.rawurlencode($user).'/'.bratonien_tools_webdav_derivative_test_quote_path($webdav_path);
-  $ch = curl_init($url);
-  curl_setopt_array($ch, array(
-    CURLOPT_FOLLOWLOCATION => false,
-    CURLOPT_CONNECTTIMEOUT => 10,
-    CURLOPT_TIMEOUT => 180,
-    CURLOPT_HTTPAUTH => CURLAUTH_BASIC,
-    CURLOPT_USERPWD => $user.':'.$password,
-    CURLOPT_RETURNTRANSFER => false,
-    CURLOPT_FAILONERROR => false,
-    CURLOPT_FILE => $fp,
-    CURLOPT_USERAGENT => 'Bratonien-Tools-WebDAV-Derivative-Parallel-Test',
-  ));
-
-  $ok = curl_exec($ch);
-  $errno = curl_errno($ch);
-  $error = curl_error($ch);
-  $http = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
-  curl_close($ch);
-  fclose($fp);
-
-  if ($ok === false || $errno !== 0 || $http < 200 || $http >= 300)
-  {
-    @unlink($destination);
-    $detail = 'Nextcloud-Download fehlgeschlagen (HTTP '.$http.', cURL '.$errno.($error !== '' ? ': '.$error : '').').';
-    return false;
-  }
-
-  if (!is_file($destination) || filesize($destination) < 1 || @getimagesize($destination) === false)
-  {
-    @unlink($destination);
-    $detail = 'Nextcloud-Datei ist kein lesbares Bild.';
-    return false;
-  }
-
-  return true;
-}
-
-function bratonien_tools_webdav_derivative_test_inner_url($derivative_path)
-{
-  $derivative_root = PHPWG_ROOT_PATH.PWG_DERIVATIVE_DIR;
-  if (strpos($derivative_path, $derivative_root) !== 0) return null;
-
-  $location = ltrim(substr($derivative_path, strlen($derivative_root)), '/');
-  if ($location === '') return null;
-
-  $segments = array_map('rawurlencode', explode('/', $location));
-  return rtrim(get_absolute_root_url(), '/').'/i.php?/'.implode('/', $segments);
-}
-
-function bratonien_tools_webdav_derivative_test_call_i($url, &$response_body, &$response_type, &$response_status, &$detail=null)
-{
-  $detail = '';
-  $response_body = '';
-  $response_type = 'application/octet-stream';
-  $response_status = 500;
-
-  $ch = curl_init($url);
-  curl_setopt_array($ch, array(
-    CURLOPT_FOLLOWLOCATION => false,
-    CURLOPT_CONNECTTIMEOUT => 10,
-    CURLOPT_TIMEOUT => 180,
-    CURLOPT_RETURNTRANSFER => true,
-    CURLOPT_FAILONERROR => false,
-    CURLOPT_USERAGENT => 'Bratonien-Tools-Derivative-Parallel-Gate',
-  ));
-
-  $body = curl_exec($ch);
-  $errno = curl_errno($ch);
-  $error = curl_error($ch);
-  $status = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
-  $content_type = (string)curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
-  curl_close($ch);
-
-  $response_status = $status;
-  if ($content_type !== '') $response_type = $content_type;
-  if (is_string($body)) $response_body = $body;
-
-  if ($body === false || $errno !== 0)
-  {
-    $detail = 'Interner i.php-Aufruf fehlgeschlagen (cURL '.$errno.($error !== '' ? ': '.$error : '').').';
-    return false;
-  }
-  if ($status < 200 || $status >= 400)
-  {
-    $detail = 'i.php antwortete mit HTTP '.$status.'.';
-    return false;
-  }
-
-  return true;
-}
-
-global $user;
-if (!isset($user['status']) || !in_array($user['status'], array('admin', 'webmaster'), true))
-{
-  bratonien_tools_webdav_derivative_test_abort(403, 'Dieser Test-Endpunkt ist nur fuer Administratoren verfuegbar.');
-}
-
-$metrics_requested = isset($_GET['metrics']) && (string)$_GET['metrics'] === '1';
-$metrics_started_at = microtime(true);
-$memory_start = memory_get_usage(true);
-if (function_exists('memory_reset_peak_usage'))
-{
-  memory_reset_peak_usage();
-}
-
-$image_id = (int)($_GET['id'] ?? 0);
-if ($image_id < 1)
-{
-  bratonien_tools_webdav_derivative_test_abort(400, 'Bild-ID fehlt.');
-}
-
-$type = trim((string)($_GET['type'] ?? IMG_THUMB));
-$defined = ImageStdParams::get_defined_type_map();
-if (!isset($defined[$type]))
-{
-  bratonien_tools_webdav_derivative_test_abort(400, 'Unbekannter oder deaktivierter Derivat-Typ: '.$type);
-}
-
-$result = pwg_query('SELECT * FROM '.IMAGES_TABLE.' WHERE id='.$image_id.' LIMIT 1');
-if (!pwg_db_num_rows($result))
-{
-  bratonien_tools_webdav_derivative_test_abort(404, 'Bild nicht gefunden.');
-}
-$image_row = pwg_db_fetch_assoc($result);
-
-$source = bratonien_tools_webdav_derivative_test_source_info($image_id, $image_row);
-if (!$source)
-{
-  bratonien_tools_webdav_derivative_test_abort(404, 'Keine WebDAV-Quelle fuer dieses Bild gefunden.');
-}
-
-$upload_dir = rtrim((string)($GLOBALS['conf']['upload_dir'] ?? './upload'), '/');
-$test_rel_dir = $upload_dir.'/bratonien-webdav-test';
-$test_root = PHPWG_ROOT_PATH.$test_rel_dir;
-if (!is_dir($test_root) && !@mkdir($test_root, 0755, true))
-{
-  bratonien_tools_webdav_derivative_test_abort(500, 'Paralleler Testbereich konnte nicht angelegt werden: '.$test_root);
-}
-if (!is_writable($test_root))
-{
-  bratonien_tools_webdav_derivative_test_abort(500, 'Paralleler Testbereich ist fuer PHP nicht beschreibbar: '.$test_root);
-}
-
-$lock_path = $test_root.'/image-'.$image_id.'.lock';
-$lock = @fopen($lock_path, 'c');
-if (!$lock || !flock($lock, LOCK_EX))
-{
-  if ($lock) fclose($lock);
-  bratonien_tools_webdav_derivative_test_abort(503, 'Paralleler Test-Lock konnte nicht gesetzt werden.');
-}
-
-$extension = strtolower(pathinfo((string)($image_row['path'] ?? ''), PATHINFO_EXTENSION));
-if (!in_array($extension, array('jpg', 'jpeg', 'png', 'gif', 'webp'), true))
-{
-  $extension = 'jpg';
-}
-
-$token = getmypid().'-'.bin2hex(random_bytes(6));
-$source_filename = 'source-'.$image_id.'-'.$token.'.'.$extension;
-$source_path = $test_root.'/'.$source_filename;
-$source_rel = $test_rel_dir.'/'.$source_filename;
-$temp_image_id = 0;
-$derivative_path = '';
-$cleaned = false;
-
-$cleanup = function() use (&$cleaned, &$temp_image_id, &$derivative_path, $source_path, $lock)
-{
-  if ($cleaned) return;
-  $cleaned = true;
-
-  if ($temp_image_id > 0)
-  {
-    @pwg_query('DELETE FROM '.IMAGES_TABLE.' WHERE id='.(int)$temp_image_id.' LIMIT 1');
-    $temp_image_id = 0;
-  }
-
-  if ($derivative_path !== '' && is_file($derivative_path))
-  {
-    @unlink($derivative_path);
-  }
-
-  if (is_file($source_path))
-  {
-    @unlink($source_path);
-  }
-
-  @flock($lock, LOCK_UN);
-  @fclose($lock);
-};
-register_shutdown_function($cleanup);
-
-try
-{
-  $detail = '';
-  if (!bratonien_tools_webdav_derivative_test_download($source, $source_path, $detail))
-  {
-    bratonien_tools_webdav_derivative_test_abort(502, $detail);
-  }
-
-  $source_bytes = (int)filesize($source_path);
-
-  $dimensions = @getimagesize($source_path);
-  if (!is_array($dimensions) || empty($dimensions[0]) || empty($dimensions[1]))
-  {
-    bratonien_tools_webdav_derivative_test_abort(500, 'Paralleles Original besitzt keine gueltigen Bildabmessungen.');
-  }
-
-  $test_row = $image_row;
-  unset($test_row['id']);
-  $test_row['path'] = $source_rel;
-  $test_row['file'] = $source_filename;
-  if (array_key_exists('width', $test_row)) $test_row['width'] = (int)$dimensions[0];
-  if (array_key_exists('height', $test_row)) $test_row['height'] = (int)$dimensions[1];
-
-  single_insert(IMAGES_TABLE, $test_row);
-  $temp_image_id = (int)pwg_db_insert_id();
-  if ($temp_image_id < 1)
-  {
-    bratonien_tools_webdav_derivative_test_abort(500, 'Temporaerer Piwigo-Testeintrag konnte nicht angelegt werden.');
-  }
-
-  $test_row['id'] = $temp_image_id;
-  $test_src = new SrcImage($test_row);
-  $derivative = new DerivativeImage($defined[$type], $test_src);
-  if ($derivative->same_as_source())
-  {
-    bratonien_tools_webdav_derivative_test_abort(409, 'Dieser Typ ist fuer das parallele Testbild identisch mit der Quelle.');
-  }
-
-  $derivative_path = $derivative->get_path();
-  if ($derivative_path === '')
-  {
-    bratonien_tools_webdav_derivative_test_abort(500, 'Piwigo konnte keinen Derivat-Zielpfad fuer den parallelen Test bestimmen.');
-  }
-
-  if (is_file($derivative_path))
-  {
-    @unlink($derivative_path);
-    clearstatcache(true, $derivative_path);
-  }
-
-  $inner_url = bratonien_tools_webdav_derivative_test_inner_url($derivative_path);
-  if ($inner_url === null)
-  {
-    bratonien_tools_webdav_derivative_test_abort(500, 'Piwigo-i.php-URL konnte fuer den parallelen Test nicht bestimmt werden.');
-  }
-
-  $body = '';
-  $content_type = 'application/octet-stream';
-  $status = 500;
-  if (!bratonien_tools_webdav_derivative_test_call_i($inner_url, $body, $content_type, $status, $detail))
-  {
-    bratonien_tools_webdav_derivative_test_abort(502, $detail."\n".$body);
-  }
-
-  clearstatcache(true, $derivative_path);
-  if (!is_file($derivative_path) || !is_readable($derivative_path))
-  {
-    bratonien_tools_webdav_derivative_test_abort(
-      500,
-      "i.php antwortete, aber das parallele Piwigo-Derivat wurde nicht erzeugt.\n"
-      .'Testquelle: '.$source_rel."\n"
-      .'i.php: '.$inner_url
-    );
-  }
-
-  $derivative_size = @getimagesize($derivative_path);
-  if (!is_array($derivative_size) || empty($derivative_size[0]) || empty($derivative_size[1]))
-  {
-    bratonien_tools_webdav_derivative_test_abort(500, 'Das von i.php erzeugte parallele Derivat ist keine lesbare Bilddatei.');
-  }
-
-  $generated_width = (int)$derivative_size[0];
-  $generated_height = (int)$derivative_size[1];
-  $derivative_bytes = (int)filesize($derivative_path);
-
-  $cleanup();
-
-  $elapsed_ms = round((microtime(true) - $metrics_started_at) * 1000, 2);
-  $memory_peak = memory_get_peak_usage(true);
-  $memory_delta_peak = max(0, $memory_peak - $memory_start);
-
-  if ($metrics_requested)
-  {
-    header('Content-Type: application/json; charset=utf-8');
-    header('Cache-Control: no-store');
-    echo json_encode(array(
-      'source_bytes'=>$source_bytes,
-      'derivative_bytes'=>$derivative_bytes,
-      'elapsed_ms'=>$elapsed_ms,
-      'memory_start_bytes'=>$memory_start,
-      'memory_peak_bytes'=>$memory_peak,
-      'memory_delta_peak_bytes'=>$memory_delta_peak,
-    ), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
-    exit;
-  }
-
-  header('X-Bratonien-WebDAV-Test: parallel-i.php-success');
-  header('X-Bratonien-Resource-Source-Bytes: '.$source_bytes);
-  header('X-Bratonien-Resource-Derivative-Bytes: '.$derivative_bytes);
-  header('X-Bratonien-Resource-Elapsed-Ms: '.$elapsed_ms);
-  header('X-Bratonien-Resource-Memory-Start-Bytes: '.$memory_start);
-  header('X-Bratonien-Resource-Memory-Peak-Bytes: '.$memory_peak);
-  header('X-Bratonien-Resource-Memory-Delta-Peak-Bytes: '.$memory_delta_peak);
-  header('X-Bratonien-WebDAV-Test-Size: '.$generated_width.'x'.$generated_height);
-  header('Content-Type: '.$content_type);
-  header('Content-Length: '.strlen($body));
-  header('Cache-Control: no-store');
-  http_response_code($status);
-  echo $body;
-}
-finally
-{
-  $cleanup();
-}

webdav-derivative.php

@@ -1,572 +0,0 @@
-<?php
-define('PHPWG_ROOT_PATH', '../../');
-include_once(PHPWG_ROOT_PATH.'include/common.inc.php');
-require_once(PHPWG_ROOT_PATH.'include/derivative.inc.php');
-
-if (!defined('BRATONIEN_TOOLS_PATH'))
-{
-  define('BRATONIEN_TOOLS_ID', basename(__DIR__));
-  define('BRATONIEN_TOOLS_PATH', PHPWG_ROOT_PATH.'plugins/'.BRATONIEN_TOOLS_ID.'/');
-}
-require_once(BRATONIEN_TOOLS_PATH.'include/webdav_materialize_runtime.inc.php');
-
-function bratonien_tools_webdav_derivative_debug($request_id, $event, array $fields=array())
-{
-  $parts = array('[BRAT-WD '.$request_id.']', $event);
-  foreach ($fields as $key => $value)
-  {
-    if (is_bool($value)) $value = $value ? '1' : '0';
-    elseif ($value === null) $value = 'NULL';
-    elseif (is_array($value) || is_object($value)) $value = json_encode($value);
-    $parts[] = $key.'='.str_replace(array("\r", "\n"), array('\\r', '\\n'), (string)$value);
-  }
-  error_log(implode(' ', $parts));
-}
-
-function bratonien_tools_webdav_derivative_abort($status, $message)
-{
-  http_response_code((int)$status);
-  header('Content-Type: text/plain; charset=utf-8');
-  header('Cache-Control: no-store');
-  echo $message;
-  exit;
-}
-
-function bratonien_tools_webdav_derivative_decrypt_secret($blob, $hex_key)
-{
-  $hex_key = trim((string)$hex_key);
-  if (!preg_match('/^[a-f0-9]{64}$/', $hex_key)) return null;
-  $outer = base64_decode(trim((string)$blob), true);
-  $payload = is_string($outer) ? json_decode($outer, true) : null;
-  if (!is_array($payload) || (int)($payload['v'] ?? 0) !== 1) return null;
-  $iv = base64_decode((string)($payload['iv'] ?? ''), true);
-  $tag = base64_decode((string)($payload['tag'] ?? ''), true);
-  $cipher = base64_decode((string)($payload['data'] ?? ''), true);
-  if (!is_string($iv) || !is_string($tag) || !is_string($cipher)) return null;
-  $plain = openssl_decrypt($cipher, 'aes-256-gcm', hex2bin($hex_key), OPENSSL_RAW_DATA, $iv, $tag);
-  if ($plain === false) return null;
-  $decoded = json_decode((string)$plain, true);
-  return is_array($decoded) ? $decoded : null;
-}
-
-function bratonien_tools_webdav_derivative_quote_path($path)
-{
-  $parts = array_values(array_filter(explode('/', trim((string)$path, '/')), 'strlen'));
-  return implode('/', array_map('rawurlencode', $parts));
-}
-
-function bratonien_tools_webdav_derivative_connection(array $source, &$detail=null)
-{
-  $detail = '';
-  $table = $GLOBALS['prefixeTable'].'bratonien_tools_nc_connections';
-  $result = pwg_query('SELECT config_json, secret_blob FROM `'.$table.'` WHERE id='.(int)$source['connection_id'].' LIMIT 1');
-  if (!pwg_db_num_rows($result)) { $detail = 'WebDAV-Verbindung nicht gefunden.'; return null; }
-
-  $row = pwg_db_fetch_assoc($result);
-  $config = json_decode((string)$row['config_json'], true);
-  if (!is_array($config)) { $detail = 'WebDAV-Konfiguration ist ungueltig.'; return null; }
-
-  $key_result = pwg_query("SELECT value FROM ".$GLOBALS['prefixeTable']."config WHERE param='bratonien_nc_connector_secret' LIMIT 1");
-  if (!pwg_db_num_rows($key_result)) { $detail = 'Connector-Schluessel fehlt.'; return null; }
-  $key_row = pwg_db_fetch_assoc($key_result);
-  $credentials = bratonien_tools_webdav_derivative_decrypt_secret((string)$row['secret_blob'], (string)$key_row['value']);
-  if (!is_array($credentials)) { $detail = 'WebDAV-Zugangsdaten konnten nicht gelesen werden.'; return null; }
-
-  $base_url = rtrim((string)($config['nextcloud_url'] ?? ''), '/');
-  $user = trim((string)($credentials['nextcloud_user'] ?? ''));
-  $password = (string)($credentials['nextcloud_password'] ?? '');
-  if ($base_url === '' || $user === '' || $password === '') { $detail = 'WebDAV-Verbindung ist unvollstaendig.'; return null; }
-
-  return array('base_url'=>$base_url, 'user'=>$user, 'password'=>$password);
-}
-
-function bratonien_tools_webdav_derivative_download_url($url, array $connection, $destination, &$detail=null)
-{
-  $detail = '';
-  $fp = @fopen($destination, 'xb');
-  if (!$fp) { $detail = 'Temporaere Quelldatei konnte nicht angelegt werden.'; return false; }
-
-  $ch = curl_init($url);
-  curl_setopt_array($ch, array(
-    CURLOPT_FOLLOWLOCATION => false,
-    CURLOPT_CONNECTTIMEOUT => 10,
-    CURLOPT_TIMEOUT => 180,
-    CURLOPT_HTTPAUTH => CURLAUTH_BASIC,
-    CURLOPT_USERPWD => $connection['user'].':'.$connection['password'],
-    CURLOPT_RETURNTRANSFER => false,
-    CURLOPT_FAILONERROR => false,
-    CURLOPT_FILE => $fp,
-    CURLOPT_USERAGENT => 'Bratonien-Tools-WebDAV-Materialize',
-  ));
-  $ok = curl_exec($ch);
-  $errno = curl_errno($ch);
-  $error = curl_error($ch);
-  $http = (int)curl_getinfo($ch, CURLINFO_HTTP_CODE);
-  curl_close($ch);
-  fclose($fp);
-
-  if ($ok === false || $errno !== 0 || $http < 200 || $http >= 300)
-  {
-    @unlink($destination);
-    $detail = 'Nextcloud-Download fehlgeschlagen (HTTP '.$http.', cURL '.$errno.($error !== '' ? ': '.$error : '').').';
-    return false;
-  }
-  if (!is_file($destination) || filesize($destination) < 1 || @getimagesize($destination) === false)
-  {
-    @unlink($destination);
-    $detail = 'Nextcloud-Datei ist kein lesbares Bild.';
-    return false;
-  }
-  return true;
-}
-
-function bratonien_tools_webdav_derivative_download(array $source, array $connection, $destination, &$detail=null)
-{
-  $webdav_path = trim((string)($source['webdav_path'] ?? ''), '/');
-  if ($webdav_path === '') { $detail = 'WebDAV-Bildquelle ist unvollstaendig.'; return false; }
-
-  $url = $connection['base_url'].'/remote.php/dav/files/'.rawurlencode($connection['user']).'/'.bratonien_tools_webdav_derivative_quote_path($webdav_path);
-  return bratonien_tools_webdav_derivative_download_url($url, $connection, $destination, $detail);
-}
-
-function bratonien_tools_webdav_derivative_preview_plan($variant, array $derivative_size, array $source, array $image_row)
-{
-  if ($variant !== 'custom:s9999x250' && $variant !== 'standard:square') return null;
-  if ((int)($source['fileid'] ?? 0) < 1) return null;
-  if ((int)($source['width'] ?? 0) < 1 || (int)($source['height'] ?? 0) < 1) return null;
-  if ((int)($image_row['rotation'] ?? 0) !== 0) return null;
-
-  $target_width = (int)($derivative_size[0] ?? 0);
-  $target_height = (int)($derivative_size[1] ?? 0);
-  if ($target_width < 1 || $target_height < 1 || max($target_width, $target_height) > 800) return null;
-
-  $source_width = (int)$source['width'];
-  $source_height = (int)$source['height'];
-  $required_width = $target_width * 2;
-  $required_height = $target_height * 2;
-  $scale = max($required_width / $source_width, $required_height / $source_height);
-  $preview_width = max(32, (int)ceil($source_width * $scale));
-  $preview_height = max(32, (int)ceil($source_height * $scale));
-
-  if (max($preview_width, $preview_height) > 1600) return null;
-
-  return array(
-    'fileid'=>(int)$source['fileid'],
-    'width'=>$preview_width,
-    'height'=>$preview_height,
-  );
-}
-
-function bratonien_tools_webdav_derivative_download_preview(array $plan, array $connection, $destination, &$detail=null)
-{
-  $query = http_build_query(array(
-    'fileId'=>(int)$plan['fileid'],
-    'x'=>(int)$plan['width'],
-    'y'=>(int)$plan['height'],
-    'a'=>'true',
-    'forceIcon'=>'false',
-    'mode'=>'fill',
-    'mimeFallback'=>'false',
-  ), '', '&', PHP_QUERY_RFC3986);
-  $url = $connection['base_url'].'/core/preview?'.$query;
-  return bratonien_tools_webdav_derivative_download_url($url, $connection, $destination, $detail);
-}
-
-function bratonien_tools_webdav_derivative_make_dir($dir)
-{
-  global $conf;
-  if (!is_dir($dir))
-  {
-    $mode = isset($conf['chmod_value']) ? (int)$conf['chmod_value'] : 0755;
-    $umask = umask(0);
-    $ok = @mkdir($dir, $mode, true);
-    umask($umask);
-    if (!$ok && !is_dir($dir)) return false;
-  }
-  if (!is_writable($dir)) return false;
-  $index = rtrim($dir, '/').'/index.htm';
-  if (!file_exists($index)) @file_put_contents($index, 'Not allowed!');
-  return true;
-}
-
-function bratonien_tools_webdav_derivative_generate($source_path, $target_path, $params, array $image_row, &$detail=null)
-{
-  global $conf;
-  $detail = '';
-  include_once(PHPWG_ROOT_PATH.'admin/include/image.class.php');
-
-  if (!is_object($params)) { $detail = 'Piwigo-Derivatparameter fehlen.'; return false; }
-  if (!is_file($source_path) || !is_readable($source_path)) { $detail = 'Materialisierte Bildquelle ist nicht lesbar.'; return false; }
-  if (!bratonien_tools_webdav_derivative_make_dir(dirname($target_path))) { $detail = 'Piwigo-Derivatverzeichnis konnte nicht angelegt werden.'; return false; }
-
-  $rotation_angle = isset($image_row['rotation'])
-    ? pwg_image::get_rotation_angle_from_code($image_row['rotation'])
-    : pwg_image::get_rotation_angle($source_path);
-  $coi = $image_row['coi'] ?? null;
-
-  if (($params->type ?? '') === IMG_CUSTOM)
-  {
-    $defined = ImageStdParams::get_defined_type_map();
-    if (count($defined) > 0)
-    {
-      $sharpen = 0;
-      foreach ($defined as $std_params) $sharpen += $std_params->sharpen;
-      $params->sharpen = round($sharpen / count($defined));
-    }
-  }
-
-  $image = null;
-  $wm_image = null;
-  try
-  {
-    $image = new pwg_image($source_path);
-    $changes = 0;
-
-    if (0 != $rotation_angle)
-    {
-      $image->rotate($rotation_angle);
-      $changes++;
-    }
-
-    $o_size = $d_size = array($image->get_width(), $image->get_height());
-    $crop_rect = null;
-    $scaled_size = null;
-    $params->sizing->compute($o_size, $coi, $crop_rect, $scaled_size);
-    if ($crop_rect)
-    {
-      $image->crop($crop_rect->width(), $crop_rect->height(), $crop_rect->l, $crop_rect->t);
-      $changes++;
-    }
-    if ($scaled_size)
-    {
-      $image->resize($scaled_size[0], $scaled_size[1]);
-      $d_size = $scaled_size;
-      $changes++;
-    }
-    if ($params->sharpen)
-    {
-      $changes += $image->sharpen($params->sharpen);
-    }
-
-    if ($params->will_watermark($d_size))
-    {
-      $wm = ImageStdParams::get_watermark();
-      $wm_image = new pwg_image(PHPWG_ROOT_PATH.$wm->file);
-      $wm_size = array($wm_image->get_width(), $wm_image->get_height());
-      if ($d_size[0] < $wm_size[0] || $d_size[1] < $wm_size[1])
-      {
-        $wm_scaling_params = SizingParams::classic($d_size[0], $d_size[1]);
-        $tmp = null;
-        $wm_scaled_size = null;
-        $wm_scaling_params->compute($wm_size, null, $tmp, $wm_scaled_size);
-        $wm_size = $wm_scaled_size;
-        $wm_image->resize($wm_scaled_size[0], $wm_scaled_size[1]);
-      }
-      $x = round(($wm->xpos / 100) * ($d_size[0] - $wm_size[0]));
-      $y = round(($wm->ypos / 100) * ($d_size[1] - $wm_size[1]));
-      if ($image->compose($wm_image, $x, $y, $wm->opacity))
-      {
-        $changes++;
-        if ($wm->xrepeat || $wm->yrepeat)
-        {
-          $xpad = $wm_size[0] + max(30, round($wm_size[0] / 4));
-          $ypad = $wm_size[1] + max(30, round($wm_size[1] / 4));
-          for ($i = -$wm->xrepeat; $i <= $wm->xrepeat; $i++)
-          {
-            for ($j = -$wm->yrepeat; $j <= $wm->yrepeat; $j++)
-            {
-              if (!$i && !$j) continue;
-              $x2 = $x + $i * $xpad;
-              $y2 = $y + $j * $ypad;
-              if ($x2 >= 0 && $x2 + $wm_size[0] < $d_size[0] && $y2 >= 0 && $y2 + $wm_size[1] < $d_size[1])
-              {
-                if (!$image->compose($wm_image, $x2, $y2, $wm->opacity)) break;
-              }
-            }
-          }
-        }
-      }
-      $wm_image->destroy();
-      $wm_image = null;
-    }
-
-    if (!$changes)
-    {
-      $detail = 'Piwigo-Derivat benoetigt keine Bildaenderung.';
-      return false;
-    }
-
-    if ($d_size[0] * $d_size[1] < ($conf['derivatives_strip_metadata_threshold'] ?? PHP_INT_MAX))
-    {
-      $image->strip();
-    }
-
-    $image->write($target_path);
-    @chmod($target_path, 0644);
-    clearstatcache(true, $target_path);
-    if (!is_file($target_path) || !is_readable($target_path) || @getimagesize($target_path) === false)
-    {
-      $detail = 'Piwigo hat kein gueltiges finales Derivat erzeugt.';
-      return false;
-    }
-    return true;
-  }
-  catch (Throwable $e)
-  {
-    $detail = 'Piwigo-Derivaterzeugung fehlgeschlagen: '.$e->getMessage();
-    return false;
-  }
-  finally
-  {
-    if ($wm_image) $wm_image->destroy();
-    if ($image) $image->destroy();
-  }
-}
-
-function bratonien_tools_webdav_derivative_after_url($encoded)
-{
-  $encoded = trim((string)$encoded);
-  if ($encoded === '') return null;
-  $raw = strtr($encoded, '-_', '+/');
-  $padding = strlen($raw) % 4;
-  if ($padding) $raw .= str_repeat('=', 4 - $padding);
-  $url = base64_decode($raw, true);
-  if (!is_string($url) || $url === '' || preg_match('/[\r\n]/', $url)) return null;
-  if (strpos($url, '//') === 0) return null;
-  if (preg_match('#^https?://#i', $url))
-  {
-    $root_parts = parse_url(get_absolute_root_url());
-    $url_parts = parse_url($url);
-    if (!is_array($root_parts) || !is_array($url_parts)) return null;
-    if (strcasecmp((string)($root_parts['scheme'] ?? ''), (string)($url_parts['scheme'] ?? '')) !== 0) return null;
-    if (strcasecmp((string)($root_parts['host'] ?? ''), (string)($url_parts['host'] ?? '')) !== 0) return null;
-    if ((int)($root_parts['port'] ?? 0) !== (int)($url_parts['port'] ?? 0)) return null;
-    return $url;
-  }
-  if (strpos($url, ':') !== false && !preg_match('#^[A-Za-z0-9_./?&=%+-]+$#', $url)) return null;
-  return $url;
-}
-
-function bratonien_tools_webdav_derivative_needs_after_redirect($url)
-{
-  if (!is_string($url) || $url === '') return false;
-  return strpos($url, '/plugins/'.BRATONIEN_TOOLS_ID.'/watermark.php') !== false
-    || strpos($url, 'plugins/'.BRATONIEN_TOOLS_ID.'/watermark.php') === 0;
-}
-
-function bratonien_tools_webdav_derivative_serve($path)
-{
-  clearstatcache(true, $path);
-  if (!is_file($path) || !is_readable($path)) bratonien_tools_webdav_derivative_abort(500, 'Piwigo-Derivat ist nicht lesbar.');
-  $size = @getimagesize($path);
-  $content_type = is_array($size) && !empty($size['mime']) ? (string)$size['mime'] : 'application/octet-stream';
-  header('Content-Type: '.$content_type);
-  header('Content-Length: '.(int)filesize($path));
-  header('Cache-Control: public, max-age=31536000');
-  header('X-Content-Type-Options: nosniff');
-  if (($_SERVER['REQUEST_METHOD'] ?? 'GET') !== 'HEAD') readfile($path);
-  exit;
-}
-
-$image_id = (int)($_GET['id'] ?? 0);
-$variant = trim((string)($_GET['variant'] ?? ''));
-$request_id = bin2hex(random_bytes(4));
-bratonien_tools_webdav_derivative_debug($request_id, 'start', array('image_id'=>$image_id, 'variant'=>$variant));
-
-$after_url = bratonien_tools_webdav_derivative_after_url($_GET['after'] ?? '');
-$after_sig = trim((string)($_GET['sig'] ?? ''));
-if ($image_id < 1) bratonien_tools_webdav_derivative_abort(400, 'Bild-ID fehlt.');
-if ($variant === '') bratonien_tools_webdav_derivative_abort(400, 'Derivat-Variante fehlt.');
-if ($after_url !== null)
-{
-  $expected_sig = bratonien_tools_webdav_materialize_after_signature($image_id, $variant, $after_url);
-  if ($after_sig === '' || !hash_equals($expected_sig, $after_sig)) $after_url = null;
-}
-$redirect_after = bratonien_tools_webdav_derivative_needs_after_redirect($after_url) ? $after_url : null;
-
-$permission_condition = get_sql_condition_FandF(array('forbidden_categories'=>'category_id'), null, true);
-$access_result = pwg_query('SELECT 1 FROM '.IMAGE_CATEGORY_TABLE.' WHERE image_id='.$image_id.' AND '.$permission_condition.' LIMIT 1');
-if (!pwg_db_num_rows($access_result)) bratonien_tools_webdav_derivative_abort(403, 'Kein Zugriff auf dieses Bild.');
-$result = pwg_query('SELECT * FROM '.IMAGES_TABLE.' WHERE id='.$image_id.' LIMIT 1');
-if (!pwg_db_num_rows($result)) bratonien_tools_webdav_derivative_abort(404, 'Bild nicht gefunden.');
-$image_row = pwg_db_fetch_assoc($result);
-
-$raw_source_path = (string)($image_row['path'] ?? '');
-$absolute_source_path = $raw_source_path;
-if ($absolute_source_path !== '' && strpos($absolute_source_path, '/') !== 0)
-{
-  $absolute_source_path = PHPWG_ROOT_PATH.ltrim(preg_replace('#^\./#', '', $absolute_source_path), '/');
-}
-bratonien_tools_webdav_derivative_debug($request_id, 'source_before_resolve', array(
-  'path'=>$raw_source_path,
-  'is_link'=>$absolute_source_path !== '' && is_link($absolute_source_path),
-  'realpath'=>$absolute_source_path !== '' ? (realpath($absolute_source_path) ?: 'FALSE') : 'EMPTY',
-));
-
-$source = bratonien_tools_webdav_materialize_source_info($image_id);
-if (!$source)
-{
-  bratonien_tools_webdav_derivative_debug($request_id, 'source_resolve_failed');
-  bratonien_tools_webdav_derivative_abort(404, 'Keine WebDAV-Quelle fuer dieses Bild gefunden.');
-}
-bratonien_tools_webdav_derivative_debug($request_id, 'source_resolved', array(
-  'connection_id'=>$source['connection_id'] ?? 0,
-  'root_fileid'=>$source['root_fileid'] ?? 0,
-  'fileid'=>$source['fileid'] ?? 0,
-  'webdav_path'=>$source['webdav_path'] ?? '',
-));
-
-$params = bratonien_tools_webdav_materialize_params_from_variant($variant);
-if (!$params) bratonien_tools_webdav_derivative_abort(400, 'Unbekannte Derivat-Variante.');
-$real_src = new SrcImage($image_row);
-$real_derivative = new DerivativeImage($params, $real_src);
-if ($real_derivative->same_as_source())
-{
-  $source_url = bratonien_tools_webdav_materialize_image_url($image_id);
-  if (!$source_url) bratonien_tools_webdav_derivative_abort(404, 'WebDAV-Original konnte nicht bestimmt werden.');
-  header('Location: '.$source_url, true, 302);
-  exit;
-}
-$derivative_size = $real_derivative->get_size();
-
-$target_path = $real_derivative->get_path();
-$derivative_root = PHPWG_ROOT_PATH.PWG_DERIVATIVE_DIR;
-if ($target_path === '' || strpos($target_path, $derivative_root) !== 0) bratonien_tools_webdav_derivative_abort(500, 'Ungueltiger Piwigo-Derivatpfad.');
-if (is_file($target_path) && is_readable($target_path))
-{
-  bratonien_tools_webdav_derivative_debug($request_id, 'target_exists', array('target'=>$target_path));
-  if ($redirect_after !== null) { header('Location: '.$redirect_after, true, 302); exit; }
-  bratonien_tools_webdav_derivative_serve($target_path);
-}
-
-$shadow_path = $raw_source_path;
-if ($shadow_path === '') bratonien_tools_webdav_derivative_abort(500, 'Piwigo-Quellpfad fehlt.');
-if (strpos($shadow_path, '/') !== 0) $shadow_path = PHPWG_ROOT_PATH.ltrim(preg_replace('#^\./#', '', $shadow_path), '/');
-$shadow_normalized = str_replace('\\', '/', $shadow_path);
-if (!preg_match('#/_data/bratonien-tools/nc-webdav-gallery/connection-'.(int)$source['connection_id'].'/#', $shadow_normalized)) bratonien_tools_webdav_derivative_abort(500, 'Piwigo-Quellpfad liegt nicht im WebDAV-Shadow-Baum.');
-if (!is_link($shadow_path)) bratonien_tools_webdav_derivative_abort(500, 'WebDAV-Shadow-Quelle ist kein Placeholder-Symlink.');
-
-$placeholder_target = realpath($shadow_path);
-$placeholder_normalized = $placeholder_target === false ? '' : str_replace('\\', '/', $placeholder_target);
-if ($placeholder_target === false || !preg_match('#/nc-webdav-source/connection-'.(int)$source['connection_id'].'/root-'.(int)$source['root_fileid'].'/#', $placeholder_normalized)) bratonien_tools_webdav_derivative_abort(500, 'WebDAV-Placeholder-Ziel ist ungueltig.');
-
-$shadow_dir = dirname($shadow_path);
-if (!is_dir($shadow_dir) || !is_writable($shadow_dir)) bratonien_tools_webdav_derivative_abort(500, 'WebDAV-Shadow-Verzeichnis ist fuer PHP nicht beschreibbar.');
-$upload_dir = rtrim((string)($GLOBALS['conf']['upload_dir'] ?? './upload'), '/');
-$work_rel_dir = $upload_dir.'/bratonien-webdav-materialize';
-$work_root = PHPWG_ROOT_PATH.$work_rel_dir;
-if (!is_dir($work_root) && !@mkdir($work_root, 0755, true)) bratonien_tools_webdav_derivative_abort(500, 'WebDAV-Materialisierungsbereich konnte nicht angelegt werden.');
-if (!is_writable($work_root)) bratonien_tools_webdav_derivative_abort(500, 'WebDAV-Materialisierungsbereich ist fuer PHP nicht beschreibbar.');
-
-$lock_path = $work_root.'/image-'.$image_id.'.lock';
-bratonien_tools_webdav_derivative_debug($request_id, 'waiting_lock', array('lock'=>$lock_path, 'is_link'=>is_link($shadow_path), 'realpath'=>realpath($shadow_path) ?: 'FALSE'));
-$lock = @fopen($lock_path, 'c');
-if (!$lock || !flock($lock, LOCK_EX))
-{
-  if ($lock) fclose($lock);
-  bratonien_tools_webdav_derivative_abort(503, 'WebDAV-Materialisierungslock konnte nicht gesetzt werden.');
-}
-bratonien_tools_webdav_derivative_debug($request_id, 'lock_acquired', array('is_link'=>is_link($shadow_path), 'realpath'=>realpath($shadow_path) ?: 'FALSE'));
-
-clearstatcache(true, $target_path);
-if (is_file($target_path) && is_readable($target_path))
-{
-  bratonien_tools_webdav_derivative_debug($request_id, 'target_created_while_waiting', array('target'=>$target_path));
-  @flock($lock, LOCK_UN); @fclose($lock);
-  if ($redirect_after !== null) { header('Location: '.$redirect_after, true, 302); exit; }
-  bratonien_tools_webdav_derivative_serve($target_path);
-}
-
-$token = getmypid().'-'.bin2hex(random_bytes(6));
-$download_path = $work_root.'/source-'.$image_id.'-'.$token.'.tmp';
-$staging_path = $shadow_path.'.bratonien-'.$token.'.tmp';
-$placeholder_backup = $shadow_path.'.bratonien-placeholder';
-$swapped = false;
-$cleaned = false;
-
-$cleanup = function() use (&$cleaned, &$swapped, $shadow_path, $staging_path, $placeholder_backup, $download_path, $lock, $request_id)
-{
-  if ($cleaned) return;
-  $cleaned = true;
-  if ($swapped)
-  {
-    if (is_file($shadow_path) && !is_link($shadow_path)) @unlink($shadow_path);
-    if (is_link($placeholder_backup)) @rename($placeholder_backup, $shadow_path);
-    $swapped = false;
-  }
-  if (is_file($staging_path) || is_link($staging_path)) @unlink($staging_path);
-  if (is_file($download_path)) @unlink($download_path);
-  bratonien_tools_webdav_derivative_debug($request_id, 'restored', array('is_link'=>is_link($shadow_path), 'realpath'=>realpath($shadow_path) ?: 'FALSE'));
-  @flock($lock, LOCK_UN);
-  @fclose($lock);
-};
-register_shutdown_function($cleanup);
-
-try
-{
-  if (is_link($placeholder_backup)) bratonien_tools_webdav_derivative_abort(503, 'WebDAV-Placeholder-Backup existiert bereits; vorheriger Materialisierungslauf ist nicht sauber abgeschlossen.');
-  $detail = '';
-  $connection = bratonien_tools_webdav_derivative_connection($source, $detail);
-  if (!$connection) bratonien_tools_webdav_derivative_abort(502, $detail);
-
-  $source_mode = 'original';
-  $preview_plan = bratonien_tools_webdav_derivative_preview_plan($variant, $derivative_size, $source, $image_row);
-  $download_start = microtime(true);
-  if ($preview_plan !== null)
-  {
-    bratonien_tools_webdav_derivative_debug($request_id, 'preview_start', $preview_plan);
-    if (bratonien_tools_webdav_derivative_download_preview($preview_plan, $connection, $download_path, $detail))
-    {
-      $source_mode = 'preview';
-    }
-    else
-    {
-      bratonien_tools_webdav_derivative_debug($request_id, 'preview_failed', array('detail'=>$detail));
-      $detail = '';
-    }
-  }
-  if ($source_mode !== 'preview')
-  {
-    if (!bratonien_tools_webdav_derivative_download($source, $connection, $download_path, $detail)) bratonien_tools_webdav_derivative_abort(502, $detail);
-  }
-  bratonien_tools_webdav_derivative_debug($request_id, 'download_done', array(
-    'mode'=>$source_mode,
-    'ms'=>round((microtime(true)-$download_start)*1000, 1),
-    'bytes'=>@filesize($download_path) ?: 0,
-  ));
-
-  if (!@copy($download_path, $staging_path)) bratonien_tools_webdav_derivative_abort(500, 'Bildquelle konnte nicht in den WebDAV-Shadow-Baum kopiert werden.');
-  @chmod($staging_path, 0644);
-  if (@getimagesize($staging_path) === false) bratonien_tools_webdav_derivative_abort(500, 'Materialisierte Shadow-Quelle ist kein gueltiges Bild.');
-
-  bratonien_tools_webdav_derivative_debug($request_id, 'swap_begin', array('placeholder'=>$placeholder_target, 'mode'=>$source_mode));
-  if (!@rename($shadow_path, $placeholder_backup)) bratonien_tools_webdav_derivative_abort(500, 'WebDAV-Placeholder konnte nicht temporaer gesichert werden.');
-  if (!@rename($staging_path, $shadow_path))
-  {
-    @rename($placeholder_backup, $shadow_path);
-    bratonien_tools_webdav_derivative_abort(500, 'Materialisierte Bildquelle konnte nicht am Piwigo-Quellpfad aktiviert werden.');
-  }
-  $swapped = true;
-  clearstatcache(true, $shadow_path);
-  bratonien_tools_webdav_derivative_debug($request_id, 'swapped', array('is_link'=>is_link($shadow_path), 'realpath'=>realpath($shadow_path) ?: 'FALSE', 'mode'=>$source_mode));
-  if (!is_file($shadow_path) || is_link($shadow_path) || @getimagesize($shadow_path) === false) bratonien_tools_webdav_derivative_abort(500, 'Piwigo-Quellpfad enthaelt nach Materialisierung keine gueltige Bildquelle.');
-
-  $generate_start = microtime(true);
-  bratonien_tools_webdav_derivative_debug($request_id, 'generate_start', array('target'=>$target_path, 'mode'=>$source_mode));
-  $generate_ok = bratonien_tools_webdav_derivative_generate($shadow_path, $target_path, $params, $image_row, $detail);
-  bratonien_tools_webdav_derivative_debug($request_id, 'generate_done', array('ok'=>$generate_ok, 'mode'=>$source_mode, 'ms'=>round((microtime(true)-$generate_start)*1000, 1), 'detail'=>$detail));
-  if (!$generate_ok) bratonien_tools_webdav_derivative_abort(500, $detail);
-
-  clearstatcache(true, $target_path);
-  $final_size = @getimagesize($target_path);
-  if (!is_file($target_path) || !is_readable($target_path) || !is_array($final_size)) bratonien_tools_webdav_derivative_abort(500, 'Piwigo hat kein gueltiges finales Derivat erzeugt.');
-
-  $cleanup();
-  bratonien_tools_webdav_derivative_debug($request_id, 'serve', array('target'=>$target_path, 'width'=>$final_size[0] ?? 0, 'height'=>$final_size[1] ?? 0, 'mode'=>$source_mode));
-  if ($redirect_after !== null) { header('Location: '.$redirect_after, true, 302); exit; }
-  bratonien_tools_webdav_derivative_serve($target_path);
-}
-finally
-{
-  $cleanup();
-}

webdav-download-test.php

@@ -1,296 +0,0 @@
-<?php
-define('PHPWG_ROOT_PATH', '../../');
-include_once(PHPWG_ROOT_PATH.'include/common.inc.php');
-
-function bratonien_tools_webdav_download_test_abort($status, $message)
-{
-  http_response_code((int)$status);
-  header('Content-Type: text/plain; charset=utf-8');
-  header('Cache-Control: no-store');
-  echo $message;
-  exit;
-}
-
-function bratonien_tools_webdav_download_test_decrypt_secret($blob, $hex_key)
-{
-  $hex_key = trim((string)$hex_key);
-  if (!preg_match('/^[a-f0-9]{64}$/', $hex_key)) return null;
-
-  $outer = base64_decode(trim((string)$blob), true);
-  $payload = is_string($outer) ? json_decode($outer, true) : null;
-  if (!is_array($payload) || (int)($payload['v'] ?? 0) !== 1) return null;
-
-  $iv = base64_decode((string)($payload['iv'] ?? ''), true);
-  $tag = base64_decode((string)($payload['tag'] ?? ''), true);
-  $cipher = base64_decode((string)($payload['data'] ?? ''), true);
-  if (!is_string($iv) || !is_string($tag) || !is_string($cipher)) return null;
-
-  $plain = openssl_decrypt($cipher, 'aes-256-gcm', hex2bin($hex_key), OPENSSL_RAW_DATA, $iv, $tag);
-  if ($plain === false) return null;
-
-  $decoded = json_decode((string)$plain, true);
-  return is_array($decoded) ? $decoded : null;
-}
-
-function bratonien_tools_webdav_download_test_quote_path($path)
-{
-  $parts = array_values(array_filter(explode('/', trim((string)$path, '/')), 'strlen'));
-  return implode('/', array_map('rawurlencode', $parts));
-}
-
-function bratonien_tools_webdav_download_test_source_info($image_id, array $image_row)
-{
-  $path = (string)($image_row['path'] ?? '');
-  if ($image_id < 1 || $path === '') return null;
-
-  $absolute = $path;
-  if (strpos($absolute, '/') !== 0)
-  {
-    $absolute = PHPWG_ROOT_PATH.ltrim(preg_replace('#^\\./#', '', $absolute), '/');
-  }
-
-  $resolved = realpath($absolute);
-  if ($resolved === false) return null;
-
-  $normalized = str_replace('\\', '/', $resolved);
-  if (!preg_match('#/nc-webdav-source/connection-([0-9]+)/root-([0-9]+)/(.*)$#', $normalized, $match))
-  {
-    return null;
-  }
-
-  $connection_id = (int)$match[1];
-  $root_fileid = (int)$match[2];
-  $relative_path = trim((string)$match[3], '/');
-  if ($connection_id < 1 || $root_fileid < 1 || $relative_path === '') return null;
-
-  $table = $GLOBALS['prefixeTable'].'bratonien_tools_nc_connections';
-  $result = pwg_query('SELECT config_json FROM `'.$table.'` WHERE id='.$connection_id.' LIMIT 1');
-  if (!pwg_db_num_rows($result)) return null;
-
-  $row = pwg_db_fetch_assoc($result);
-  $config = json_decode((string)$row['config_json'], true);
-  if (!is_array($config) || (string)($config['source_mode'] ?? '') !== 'webdav-placeholder') return null;
-
-  $root_found = false;
-  $root_path = '';
-  foreach ((array)($config['roots'] ?? array()) as $root)
-  {
-    if ((int)($root['fileid'] ?? 0) === $root_fileid)
-    {
-      $root_found = true;
-      $root_path = trim((string)($root['webdav_path'] ?? ''), '/');
-      break;
-    }
-  }
-  if (!$root_found) return null;
-
-  $webdav_path = trim($root_path === '' ? $relative_path : $root_path.'/'.$relative_path, '/');
-  if ($webdav_path === '') return null;
-
-  $size = 0;
-  $state_dir = rtrim((string)($config['state_dir'] ?? ''), '/');
-  if ($state_dir !== '')
-  {
-    $mapping_file = $state_dir.'/webdav-map.json';
-    if (is_readable($mapping_file))
-    {
-      $mapping = json_decode((string)file_get_contents($mapping_file), true);
-      if (is_array($mapping) && isset($mapping['files']) && is_array($mapping['files']))
-      {
-        $entry = $mapping['files'][$resolved] ?? $mapping['files'][$normalized] ?? null;
-        if (is_array($entry) && (string)($entry['kind'] ?? '') === 'file')
-        {
-          $webdav_path = trim((string)($entry['webdav_path'] ?? $webdav_path), '/');
-          $size = (int)($entry['size'] ?? 0);
-        }
-      }
-    }
-  }
-
-  return array(
-    'connection_id'=>$connection_id,
-    'webdav_path'=>$webdav_path,
-    'size'=>$size,
-  );
-}
-
-function bratonien_tools_webdav_download_test_connection(array $source)
-{
-  $table = $GLOBALS['prefixeTable'].'bratonien_tools_nc_connections';
-  $result = pwg_query('SELECT config_json, secret_blob FROM `'.$table.'` WHERE id='.(int)$source['connection_id'].' LIMIT 1');
-  if (!pwg_db_num_rows($result)) return null;
-
-  $row = pwg_db_fetch_assoc($result);
-  $config = json_decode((string)$row['config_json'], true);
-  if (!is_array($config)) return null;
-
-  $key_result = pwg_query("SELECT value FROM ".$GLOBALS['prefixeTable']."config WHERE param='bratonien_nc_connector_secret' LIMIT 1");
-  if (!pwg_db_num_rows($key_result)) return null;
-  $key_row = pwg_db_fetch_assoc($key_result);
-
-  $credentials = bratonien_tools_webdav_download_test_decrypt_secret((string)$row['secret_blob'], (string)$key_row['value']);
-  if (!is_array($credentials)) return null;
-
-  $base_url = rtrim((string)($config['nextcloud_url'] ?? ''), '/');
-  $user = trim((string)($credentials['nextcloud_user'] ?? ''));
-  $password = (string)($credentials['nextcloud_password'] ?? '');
-  if ($base_url === '' || $user === '' || $password === '') return null;
-
-  return array('base_url'=>$base_url, 'user'=>$user, 'password'=>$password);
-}
-
-global $user;
-if (!isset($user['status']) || !in_array($user['status'], array('admin', 'webmaster'), true))
-{
-  bratonien_tools_webdav_download_test_abort(403, 'Dieser Test-Endpunkt ist nur fuer Administratoren verfuegbar.');
-}
-
-$image_id = (int)($_GET['id'] ?? 0);
-$parallel = (int)($_GET['parallel'] ?? 1);
-if ($image_id < 1)
-{
-  bratonien_tools_webdav_download_test_abort(400, 'Bild-ID fehlt.');
-}
-if ($parallel < 1 || $parallel > 20)
-{
-  bratonien_tools_webdav_download_test_abort(400, 'parallel muss zwischen 1 und 20 liegen.');
-}
-
-$result = pwg_query('SELECT * FROM '.IMAGES_TABLE.' WHERE id='.$image_id.' LIMIT 1');
-if (!pwg_db_num_rows($result))
-{
-  bratonien_tools_webdav_download_test_abort(404, 'Bild nicht gefunden.');
-}
-$image_row = pwg_db_fetch_assoc($result);
-
-$source = bratonien_tools_webdav_download_test_source_info($image_id, $image_row);
-if (!$source)
-{
-  bratonien_tools_webdav_download_test_abort(404, 'Keine WebDAV-Quelle fuer dieses Bild gefunden.');
-}
-
-$connection = bratonien_tools_webdav_download_test_connection($source);
-if (!$connection)
-{
-  bratonien_tools_webdav_download_test_abort(500, 'WebDAV-Verbindung konnte nicht geladen werden.');
-}
-
-$upload_dir = rtrim((string)($GLOBALS['conf']['upload_dir'] ?? './upload'), '/');
-$test_rel_dir = $upload_dir.'/bratonien-webdav-download-test';
-$test_root = PHPWG_ROOT_PATH.$test_rel_dir;
-if (!is_dir($test_root) && !@mkdir($test_root, 0755, true))
-{
-  bratonien_tools_webdav_download_test_abort(500, 'Download-Testbereich konnte nicht angelegt werden: '.$test_root);
-}
-if (!is_writable($test_root))
-{
-  bratonien_tools_webdav_download_test_abort(500, 'Download-Testbereich ist fuer PHP nicht beschreibbar: '.$test_root);
-}
-
-$url = $connection['base_url'].'/remote.php/dav/files/'.rawurlencode($connection['user']).'/'.bratonien_tools_webdav_download_test_quote_path($source['webdav_path']);
-$token = getmypid().'-'.bin2hex(random_bytes(6));
-$multi = curl_multi_init();
-$items = array();
-
-for ($i = 0; $i < $parallel; $i++)
-{
-  $path = $test_root.'/download-'.$image_id.'-'.$token.'-'.$i.'.tmp';
-  $fp = @fopen($path, 'xb');
-  if (!$fp)
-  {
-    foreach ($items as $item)
-    {
-      @fclose($item['fp']);
-      @unlink($item['path']);
-      curl_multi_remove_handle($multi, $item['ch']);
-      curl_close($item['ch']);
-    }
-    curl_multi_close($multi);
-    bratonien_tools_webdav_download_test_abort(500, 'Temporaere Download-Datei konnte nicht angelegt werden.');
-  }
-
-  $ch = curl_init($url);
-  curl_setopt_array($ch, array(
-    CURLOPT_FOLLOWLOCATION => false,
-    CURLOPT_CONNECTTIMEOUT => 10,
-    CURLOPT_TIMEOUT => 180,
-    CURLOPT_HTTPAUTH => CURLAUTH_BASIC,
-    CURLOPT_USERPWD => $connection['user'].':'.$connection['password'],
-    CURLOPT_RETURNTRANSFER => false,
-    CURLOPT_FAILONERROR => false,
-    CURLOPT_FILE => $fp,
-    CURLOPT_USERAGENT => 'Bratonien-Tools-WebDAV-Download-Stress-Test',
-  ));
-  curl_multi_add_handle($multi, $ch);
-  $items[] = array('ch'=>$ch, 'fp'=>$fp, 'path'=>$path);
-}
-
-$started_at = microtime(true);
-do
-{
-  $status = curl_multi_exec($multi, $running);
-  if ($status !== CURLM_OK) break;
-  if ($running > 0)
-  {
-    $selected = curl_multi_select($multi, 1.0);
-    if ($selected === -1) usleep(10000);
-  }
-}
-while ($running > 0);
-$elapsed_seconds = microtime(true) - $started_at;
-
-$downloads = array();
-$total_bytes = 0;
-$successful = 0;
-$failed = 0;
-
-foreach ($items as $index => $item)
-{
-  @fflush($item['fp']);
-  @fclose($item['fp']);
-
-  $http = (int)curl_getinfo($item['ch'], CURLINFO_HTTP_CODE);
-  $time_ms = round((float)curl_getinfo($item['ch'], CURLINFO_TOTAL_TIME) * 1000, 2);
-  $errno = curl_errno($item['ch']);
-  $error = curl_error($item['ch']);
-  $bytes = is_file($item['path']) ? (int)filesize($item['path']) : 0;
-  $ok = ($errno === 0 && $http >= 200 && $http < 300 && $bytes > 0);
-
-  if ($ok) $successful++; else $failed++;
-  $total_bytes += $bytes;
-
-  $downloads[] = array(
-    'index'=>$index + 1,
-    'ok'=>$ok,
-    'http'=>$http,
-    'bytes'=>$bytes,
-    'elapsed_ms'=>$time_ms,
-    'mbps'=>$time_ms > 0 ? round(($bytes * 8) / ($time_ms / 1000) / 1000000, 2) : 0,
-    'curl_errno'=>$errno,
-    'curl_error'=>$error,
-  );
-
-  @unlink($item['path']);
-  curl_multi_remove_handle($multi, $item['ch']);
-  curl_close($item['ch']);
-}
-curl_multi_close($multi);
-
-$elapsed_ms = round($elapsed_seconds * 1000, 2);
-$aggregate_mbps = $elapsed_seconds > 0 ? round(($total_bytes * 8) / $elapsed_seconds / 1000000, 2) : 0;
-
-header('Content-Type: application/json; charset=utf-8');
-header('Cache-Control: no-store');
-echo json_encode(array(
-  'image_id'=>$image_id,
-  'parallel'=>$parallel,
-  'same_source_repeated'=>true,
-  'expected_source_bytes'=>(int)$source['size'],
-  'successful'=>$successful,
-  'failed'=>$failed,
-  'total_bytes'=>$total_bytes,
-  'peak_temp_disk_bytes'=>$total_bytes,
-  'elapsed_ms'=>$elapsed_ms,
-  'aggregate_mbps'=>$aggregate_mbps,
-  'downloads'=>$downloads,
-), JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);

webdav-image.php

@@ -8,7 +8,6 @@ if (!defined('BRATONIEN_TOOLS_PATH'))
   define('BRATONIEN_TOOLS_PATH', PHPWG_ROOT_PATH.'plugins/'.BRATONIEN_TOOLS_ID.'/');
 }
 require_once(BRATONIEN_TOOLS_PATH.'include/webdav_image_runtime.inc.php');
-require_once(BRATONIEN_TOOLS_PATH.'include/webdav_materialize_runtime.inc.php');
 
 function bratonien_tools_webdav_image_abort($status, $message)
 {
@@ -49,7 +48,7 @@ $permission_condition = get_sql_condition_FandF(array('forbidden_categories'=>'c
 $access_result = pwg_query('SELECT 1 FROM '.IMAGE_CATEGORY_TABLE.' WHERE image_id='.$image_id.' AND '.$permission_condition.' LIMIT 1');
 if (!pwg_db_num_rows($access_result)) bratonien_tools_webdav_image_abort(403, 'Kein Zugriff auf dieses Bild.');
 
-$source = bratonien_tools_webdav_materialize_source_info($image_id);
+$source = bratonien_tools_webdav_image_source_info($image_id);
 if (!$source) bratonien_tools_webdav_image_abort(404, 'Keine WebDAV-Quelle für dieses Bild gefunden.');
 
 if (!empty($_GET['preview']))
@@ -121,7 +120,7 @@ $options = array(
   CURLOPT_USERPWD => $user.':'.$password,
   CURLOPT_RETURNTRANSFER => false,
   CURLOPT_FAILONERROR => false,
-  CURLOPT_USERAGENT => 'Bratonien-Tools-WebDAV-Image/0.9.6.8.6',
+  CURLOPT_USERAGENT => 'Bratonien-Tools-WebDAV-Image/0.9.6.1',
   CURLOPT_HEADERFUNCTION => function($ch, $line)
   {
     $length = strlen($line);