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

105 lines
3 KiB
PHP

<?php
namespace Updater;
/**
* Versions-Auskunft.
*
* Zwei Angaben beschreiben einen Stand:
* - die Release-Version (SemVer) steht als Konstante im Code und wandert
* damit automatisch mit jedem Update mit,
* - der Git-Commit-SHA ist die technische Identitaet und steht in einer
* DATEI unter updater/storage/.version.
*
* Die Datei ist Absicht: der Updater muss den installierten Stand auch dann
* lesen koennen, wenn die Datenbank gerade nicht erreichbar ist. Ausserdem
* liegt storage/ auf der Liste der geschuetzten Pfade - ein Update
* ueberschreibt die Datei also nie mit dem Stand aus dem Archiv.
*/
final class Version
{
/**
* Release-Version dieses Codes (SemVer).
* Bei jeder Aenderung anheben, siehe CHANGELOG.md.
*/
public const RELEASE = '3.0.0';
/** @var string|null Nur fuer Tests: abweichender Ablageort. */
private static $storageOverride = null;
public static function storageDir(): string
{
return self::$storageOverride ?? __DIR__ . '/storage';
}
/**
* Lenkt Version, Fortschritt und Wartungsmarkierung in ein anderes
* Verzeichnis um. Ausschliesslich fuer Tests gedacht - im Betrieb bleibt
* es bei updater/storage/.
*/
public static function useStorageDir(?string $dir): void
{
self::$storageOverride = $dir === null ? null : rtrim($dir, '/');
}
private static function file(): string
{
return self::storageDir() . '/.version';
}
/** Installierter Commit-SHA oder null bei einer frischen Installation. */
public static function current(): ?string
{
$file = self::file();
if (!is_file($file)) {
return null;
}
$sha = trim((string)@file_get_contents($file));
return self::isSha($sha) ? $sha : null;
}
/**
* Schreibt den Stand zurueck. Ungueltige Werte werden abgelehnt, damit
* eine halbe Proxy-Antwort nicht als Version einzementiert wird.
*/
public static function save(string $sha): bool
{
$sha = strtolower(trim($sha));
if (!self::isSha($sha)) {
return false;
}
$dir = self::storageDir();
if (!is_dir($dir) && !@mkdir($dir, 0775, true) && !is_dir($dir)) {
return false;
}
return @file_put_contents(self::file(), $sha . "\n") !== false;
}
public static function isSha(string $value): bool
{
return (bool)preg_match('/^[0-9a-f]{40}$/', strtolower(trim($value)));
}
/** Kurzform fuer die Anzeige. */
public static function short(?string $sha = null): string
{
$sha = $sha ?? self::current();
return $sha === null ? '' : substr($sha, 0, 7);
}
public static function release(): string
{
return self::RELEASE;
}
/** "3.0.0 (a1b2c3d)" bzw. nur "3.0.0", solange kein SHA bekannt ist. */
public static function full(): string
{
$short = self::short();
return $short === '' ? self::RELEASE : self::RELEASE . ' (' . $short . ')';
}
}