Aktualisierung per Klick im Administrationsbereich, ohne Zugang zum
Server. Der bisherige Updater lud ein ZIP und entpackte es ungeprüft über
die Produktion; das ist vollständig ersetzt.
Neu in updater/:
- Version: Release-Version als Konstante, installierter Commit-SHA in
storage/.version (Datei, nicht Datenbank - der Updater muss den Stand
auch bei hängender Datenbank lesen können)
- Progress: Fortschrittsdatei mit eigenem Fehlerzustand (pct = -1) und
Verfallszeit, damit ein abgestürzter Lauf den nächsten nicht blockiert
- Maintenance: Wartungsmarkierung mit Ablauf, die sich beim Prüfen selbst
aufräumt
- ProxyClient: nur HTTPS, Zertifikatsprüfung an, begrenzte
Weiterleitungen, 503 mirror_pending/not_released als Bitte um Geduld
- Updater: Prüfsumme gegen X-Content-Sha256, zweistufiger ZIP-Slip-Schutz,
geschützte Pfade, atomares Schreiben je Datei, nie löschen
- AutoMigrate: zieht Migrationen beim ersten Seitenaufruf nach, nur bei
geändertem Fingerabdruck und mit Sperre gegen Parallellauf
- guard.php: Wartungs-Wächter für die Einstiegsseiten, JSON für die
Schnittstellen; ausgenommen bleiben Update-Seite, Anmeldung und
Health-Check
- Changelog: zerlegt CHANGELOG.md und rendert Markdown ohne unsichere Links
Oberfläche: Seite "Aktualisierung" mit Stand, Kanal, Suche, Fortschritt,
Migrationsliste und Versionsgeschichte. Der Datenschutzhinweis steht
dauerhaft neben der Schaltfläche, nicht in einem Dialog.
Fehlt changelog_preview in der Antwort, bleibt es bei "neue Fassung
verfügbar" - kein leerer Kasten, kein erfundener Ersatztext. Commit-Texte
werden nirgends angezeigt.
Außerdem (Punkt 2 der Liste):
- cron_test.php entfernt: ohne jede Anmeldung erreichbar, meldete
Datenbankfehler samt Meldung und die Spalten der vouchers-Tabelle
- test.php verweigert ohne config.php die Auskunft; bisher lief die
Diagnose auf einer frisch entpackten Installation ohne Anmeldung
PHPStan prüft jetzt den gesamten updater/-Ordner. 18 neue Tests
(93 Tests, 243 Assertions), Ablauf gegen den echten Update-Dienst
durchgespielt.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Der Lauf auf 1f0875a scheiterte mit curl-Exitcode 3 (URL kaputt). Im Log
stand "Release 1\n1\n1\n2 vorhanden": die API antwortet einzeilig, und
"grep -m1 -o" begrenzt auf die erste ZEILE, gibt darin aber jeden
Treffer aus - also Release-ID, Autor-ID und die IDs der Anhänge
zusammen.
Die IDs werden jetzt über eine kleine Funktion gelesen, die vorher mit
tr an den Kommas umbricht, und zusätzlich auf Ziffern geprüft.
Geprüft mit einem curl-Double: beide Zweige (Release vorhanden bzw. neu)
erzeugen die richtigen Aufrufe in der richtigen Reihenfolge, die
Anhänge tragen das kodierte "+", und ein fehlgeschlagener Upload lässt
den Schritt mit Exitcode 1 enden.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Der Lauf auf cde259c ist am Anlegen gescheitert: "Release is has no
Tag". So antwortet die API auf ein POST für einen Tag, zu dem es bereits
ein Release gibt - das Löschen davor war also stillschweigend
fehlgeschlagen (die Aufrufe standen unter "|| true").
Statt zu löschen und neu anzulegen, wird ein vorhandenes Release jetzt
per PATCH aufgefrischt und seine alten Anhänge werden entfernt. Damit
braucht der Schritt keine Löschrechte auf Releases mehr. Der Tag wird
vorher per "git push -f" auf den aktuellen Stand gesetzt; scheitert das,
bleibt der Tag stehen und der Rest läuft trotzdem durch.
Außerdem wertet jeder Aufruf jetzt den HTTP-Status aus und schreibt die
Antwort der API ins Log, statt Fehler zu verschlucken.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Der Dateiname geht als Query-Parameter an die Release-API, dort steht
"+" für ein Leerzeichen. Das Paket hing deshalb als
"unifi-voucher-tool-2.9.0 2026-09-24.12f831e.zip" am Release, während
die beigelegte .sha256-Datei den Namen mit "+" nennt - "sha256sum -c"
lief damit ins Leere.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Der erste Lauf auf dem neuen Runner scheiterte an der eigenen Prüfung:
"Fehlt im Paket: assets/global.css", obwohl die Datei im ZIP liegt.
Ursache ist "unzip -l | grep -q" je Datei. grep beendet sich beim ersten
Treffer, unzip stirbt an SIGPIPE, und weil der Runner die Schritte mit
pipefail ausführt, gilt die Prüfung als fehlgeschlagen – aber nur für
Dateien, die früh in der Liste stehen. index.php und install.php liegen
am Ende und kamen deshalb durch.
Jetzt wird die Dateiliste einmal erzeugt und danach nur noch in der
Datei gesucht. Zusätzlich wird geprüft, dass LICENSE und
THIRD-PARTY-NOTICES.md enthalten sind und tests/, tools/, docs/ sowie
.github/ eben nicht.
Dieselbe Falle steckte in der Release-Anlage ("curl | grep | head -1"):
umgestellt auf Antwort in eine Datei und "grep -m1". Schlägt das Anlegen
fehl, steht die Antwort der API jetzt im Log.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Die Lizenzhinweise standen bisher nur in den Dateien. Unter Integration &
Wartung gibt es jetzt eine Karte "Über diese Installation" mit Version,
PHP-Version, Lizenz, Entwickler und Quellcode sowie einer Tabelle der
mitgelieferten Komponenten Dritter, die direkt auf die ausgelieferten
Lizenztexte verlinkt.
Die Liste kommt aus Ui::thirdParty(), damit Oberfläche und
THIRD-PARTY-NOTICES.md nicht auseinanderlaufen; drei Tests prüfen, dass
jede gelistete Komponente ihren Lizenztext wirklich mitliefert, in den
Notices auftaucht und LICENSE vorhanden ist.
Außerdem:
- docker-publish.yml entfernt – der Workflow veröffentlichte nach
ghcr.io und stammte noch aus der GitHub-Zeit
- Readme: der Actions-Runner läuft jetzt, entsprechende Hinweise
angepasst; Test-Badge durch das echte CI-Badge der Forgejo-Instanz
ersetzt
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Bisher deckten die Tests nur Hilfsklassen ab. Neu sind die beiden
Stellen, an denen ein Fehler richtig weh tut:
- AuthTest (12 Fälle): richtige und falsche Anmeldung, Rate-Limit greift
vor der Passwortprüfung, 2FA-Nutzer gilt vor dem Code ausdrücklich
nicht als angemeldet, CSRF-Prüfung, und die Client-IP hinter einem
Proxy – inklusive der Fälle, in denen X-Forwarded-For ignoriert werden
muss
- UniFiControllerTest (8 Fälle): die Auswahl des eigenen Vouchers. Der
Controller liefert Voucher unsortiert; wer den ersten nimmt, gibt bei
parallelen Anfragen den Code eines anderen Gastes aus. Dazu QoS-Payload
und die Fehlerfälle.
Dafür nötig: Auth nimmt die Datenbank optional über den Konstruktor
entgegen (ohne Argument unverändert), und UniFiController::apiRequest()
ist protected statt private, damit Tests aufgezeichnete Antworten
einspielen können. Beide Tests brauchen weder Datenbank noch Netz.
PHP-Anforderung von 7.4 auf 8.1 gehoben: Composer, CI-Matrix (8.1/8.3),
Docker-Image (8.3) und README. Die 7.4-Angabe war ohnehin ungeprüft.
I18n: fehlt ein Schlüssel in der gewählten Sprache, erscheint jetzt der
deutsche Text statt des technischen Schlüssels.
PHPStan deckt zusätzlich VoucherService und I18n ab.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
.github/workflows/release.yml baut bei jedem Push auf main (also auch
nach jedem gemergten Pull Request) ein installierbares Paket und hängt es
an das rollende Vorab-Release "latest-main". Der Download-Link bleibt
damit stabil und zeigt immer auf den aktuellen Stand. Ein Tag v* erzeugt
mit derselben Mechanik ein reguläres Release.
Details:
- das ZIP entsteht per `git archive`, die Auswahl steuert .gitattributes
(export-ignore) – docs/, tests/, tools/ und CI bleiben draußen, das
Paket ist rund 1,4 MB groß
- eine Prüfschritt kontrolliert, dass Kerndateien wirklich enthalten sind,
dazu gibt es eine .sha256-Datei
- zusätzlich als Build-Artefakt abgelegt (optional, bricht nicht ab, wenn
der Artefakt-Speicher fehlt)
- Release-API wird über den automatisch bereitgestellten Token
angesprochen, FORGEJO_TOKEN dient als Ausweichweg; ohne Token wird der
Schritt übersprungen statt fehlzuschlagen
Neu ist die Datei VERSION als einzige Quelle der Versionsnummer: sie
benennt das Paket und erscheint über Ui::version() unten in der
Admin-Seitenleiste ("v2.6.0 · Entwickelt von Loheide.eu").
Geprüft: Paket lokal gebaut, entpackt und die Anwendung daraus gestartet –
alle Seiten antworten mit 200, keine fehlenden Dateien.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
- tests/UploadTest.php prüft den SVG-Filter (Skripte, Event-Handler,
javascript:-Verweise) und Upload::isLocal gegen Pfad-Tricks
- tests/UiTest.php prüft Versionsstempel, Media-Pfade und die
Branding-Overrides inklusive Abweisung ungültiger Farbwerte
- PHPStan analysiert jetzt auch includes/Ui.php und includes/Upload.php
- CI vergleicht die Sprachdateien (gleiche Schlüsselmenge) und prüft,
dass jeder im Code verwendete Schlüssel existiert
Dabei aufgefallen und behoben: Upload.php rief __() direkt auf und wäre
außerhalb einer Seite mit geladener I18n mit einem Fatal Error
abgebrochen; jetzt gibt es einen Fallback auf die deutsche Meldung.
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>