Unifi-Voucher-Tool/updater/guard.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

45 lines
1.6 KiB
PHP

<?php
/**
* Wartungs-Waechter.
*
* Dieses Projekt hat kein Framework und damit keine Middleware-Schicht; die
* Auslieferung ist datei-basiert. Der Waechter wird deshalb als erste Zeile
* der Einstiegsseiten eingebunden und uebernimmt dort dieselbe Aufgabe.
*
* Waehrend eines Updates antwortet er mit 503 und einer verstaendlichen
* Wartungsseite. Ausgenommen bleiben die Update-Endpunkte selbst, die
* Anmeldeseite und der Health-Check - sonst koennte niemand mehr sehen, wie
* weit das laufende Update ist.
*/
require_once __DIR__ . '/bootstrap.php';
if (PHP_SAPI !== 'cli' && \Updater\Maintenance::isActive()) {
$retry = \Updater\Maintenance::retryAfter();
$progress = \Updater\Progress::get();
http_response_code(503);
header('Retry-After: ' . $retry);
header('Cache-Control: no-store');
// Schnittstellen bekommen JSON - eine HTML-Wartungsseite kann ein
// aufrufendes Programm nicht auswerten.
$isApi = strpos((string)($_SERVER['SCRIPT_NAME'] ?? ''), '/api/') !== false
|| strpos((string)($_SERVER['HTTP_ACCEPT'] ?? ''), 'application/json') !== false;
if ($isApi) {
header('Content-Type: application/json; charset=utf-8');
echo json_encode([
'error' => 'maintenance',
'message' => 'Es wird gerade ein Update eingespielt.',
'retry_after' => $retry,
], JSON_UNESCAPED_UNICODE);
exit;
}
header('Content-Type: text/html; charset=utf-8');
$percent = max(0, (int)$progress['pct']);
$status = (string)$progress['text'];
require __DIR__ . "/templates/maintenance.php";
exit;
}