Unifi-Voucher-Tool/updater/Progress.php
Friederich Loheide 25b8c51362
Some checks failed
CI / PHP Lint-1 (push) Successful in 43s
CI / PHP Lint (push) Successful in 45s
CI / PHP Lint (pull_request) Successful in 38s
CI / Unit Tests & Static Analysis (push) Failing after 43s
CI / PHP Lint-1 (pull_request) Successful in 40s
CI / Unit Tests & Static Analysis (pull_request) Failing after 41s
Selbst-Updater neu gebaut, Diagnoseseiten abgesichert
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>
2026-09-25 19:49:59 +00:00

90 lines
2.5 KiB
PHP

<?php
namespace Updater;
/**
* Fortschritt eines laufenden Updates.
*
* Der Ablauf laeuft serverseitig weiter, auch wenn der Browser die Verbindung
* abbricht. Die Oberflaeche fragt deshalb nur diese Datei ab, statt auf die
* Antwort des Installations-Aufrufs zu warten.
*/
final class Progress
{
/** Ohne Lebenszeichen in dieser Zeit gilt ein Lauf als abgestuerzt. */
public const STALE_AFTER = 600;
private static function file(): string
{
return Version::storageDir() . '/.update-progress';
}
/**
* @return array{pct:int, step:string, text:string, ts:int}
*/
public static function get(): array
{
$file = self::file();
if (!is_file($file)) {
return ['pct' => 0, 'step' => 'idle', 'text' => '', 'ts' => 0];
}
$data = json_decode((string)@file_get_contents($file), true);
if (!is_array($data)) {
return ['pct' => 0, 'step' => 'idle', 'text' => '', 'ts' => 0];
}
return [
'pct' => (int)($data['pct'] ?? 0),
'step' => (string)($data['step'] ?? 'idle'),
'text' => (string)($data['text'] ?? ''),
'ts' => (int)($data['ts'] ?? 0),
];
}
public static function set(int $pct, string $step, string $text): void
{
$dir = Version::storageDir();
if (!is_dir($dir)) {
@mkdir($dir, 0775, true);
}
@file_put_contents(self::file(), json_encode([
'pct' => $pct,
'step' => $step,
'text' => $text,
'ts' => time(),
], JSON_UNESCAPED_UNICODE));
}
/**
* Fehlerzustand. pct = -1 statt 0, damit sich "fehlgeschlagen" nicht als
* "0 % erledigt" liest - die Oberflaeche kann beides sonst nicht trennen.
*/
public static function error(string $text): void
{
self::set(-1, 'error', $text);
}
/**
* Laeuft gerade ein Update? Ein abgestuerzter Lauf wuerde den naechsten
* sonst dauerhaft blockieren, deshalb zaehlt nur ein frisches
* Lebenszeichen.
*/
public static function isRunning(): bool
{
$state = self::get();
if (in_array($state['step'], ['idle', 'done', 'error'], true)) {
return false;
}
return (time() - $state['ts']) < self::STALE_AFTER;
}
public static function clear(): void
{
$file = self::file();
if (is_file($file)) {
@unlink($file);
}
}
}