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
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>
105 lines
3 KiB
PHP
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 . ')';
|
|
}
|
|
}
|