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

167 lines
5.2 KiB
PHP

<?php
namespace Updater;
/**
* Liest die mitgelieferte CHANGELOG.md und macht daraus Abschnitte.
*
* Aufbau: je Version eine Ueberschrift "## 1.2.3 - Datum", darunter
* Stichpunkte. Neueste Version oben.
*
* Der Markdown-Renderer ist bewusst klein gehalten - das Projekt bringt
* keine Markdown-Bibliothek mit, und hier wird nur das gebraucht, was in
* einem Aenderungsprotokoll vorkommt. Alles andere wird als Text ausgegeben,
* niemals als HTML.
*/
final class Changelog
{
public static function file(): string
{
return dirname(__DIR__) . '/CHANGELOG.md';
}
/**
* @return array<int, array{version:string, heading:string, text:string}>
*/
public static function sections(?string $markdown = null): array
{
if ($markdown === null) {
$file = self::file();
$markdown = is_file($file) ? (string)file_get_contents($file) : '';
}
if (trim($markdown) === '') {
return [];
}
$sections = [];
$current = null;
foreach (preg_split('/\R/', $markdown) as $line) {
if (preg_match('/^##\s+(.+?)\s*$/', $line, $m)) {
if ($current !== null) {
$sections[] = self::finish($current);
}
$heading = trim($m[1]);
preg_match('/(\d+\.\d+\.\d+)/', $heading, $v);
$current = [
'version' => $v[1] ?? '',
'heading' => $heading,
'lines' => [],
];
continue;
}
if ($current !== null) {
$current['lines'][] = $line;
}
}
if ($current !== null) {
$sections[] = self::finish($current);
}
return $sections;
}
/**
* @param array{version:string, heading:string, lines:array<int,string>} $section
* @return array{version:string, heading:string, text:string}
*/
private static function finish(array $section): array
{
return [
'version' => $section['version'],
'heading' => $section['heading'],
'text' => trim(implode("\n", $section['lines'])),
];
}
/**
* Markdown -> HTML fuer Aenderungsprotokolle: Listen, Absaetze, fetter und
* kursiver Text, Code und Verweise. Verweise nur mit http(s), alles andere
* wird zu reinem Text - ein "javascript:"-Link aus einer fremden Quelle
* hat in der Oberflaeche nichts verloren.
*/
public static function toHtml(string $markdown): string
{
$html = '';
$listOpen = false;
$paragraph = [];
foreach (preg_split('/\R/', $markdown) as $line) {
$trimmed = trim($line);
if ($trimmed === '') {
$html .= self::paragraph($paragraph);
$paragraph = [];
if ($listOpen) {
$html .= '</ul>';
$listOpen = false;
}
continue;
}
if (preg_match('/^[-*+]\s+(.*)$/', $trimmed, $m)) {
$html .= self::paragraph($paragraph);
$paragraph = [];
if (!$listOpen) {
$html .= '<ul>';
$listOpen = true;
}
$html .= '<li>' . self::inline($m[1]) . '</li>';
continue;
}
if (preg_match('/^#{3,6}\s+(.*)$/', $trimmed, $m)) {
$html .= self::paragraph($paragraph);
$paragraph = [];
if ($listOpen) {
$html .= '</ul>';
$listOpen = false;
}
$html .= '<h4>' . self::inline($m[1]) . '</h4>';
continue;
}
$paragraph[] = $trimmed;
}
$html .= self::paragraph($paragraph);
if ($listOpen) {
$html .= '</ul>';
}
return $html;
}
/**
* @param array<int, string> $lines
*/
private static function paragraph(array $lines): string
{
return $lines === [] ? '' : '<p>' . self::inline(implode(' ', $lines)) . '</p>';
}
/** Fetter/kursiver Text, Code und sichere Verweise. */
private static function inline(string $text): string
{
$escaped = htmlspecialchars($text, ENT_QUOTES, 'UTF-8');
$escaped = preg_replace_callback(
'/\[([^\]]+)\]\(([^)\s]+)\)/',
function ($m) {
$label = $m[1];
$url = html_entity_decode($m[2], ENT_QUOTES, 'UTF-8');
if (!preg_match('#^https?://#i', $url)) {
return $label; // unsichere Ziele verlieren den Verweis
}
return '<a href="' . htmlspecialchars($url, ENT_QUOTES, 'UTF-8')
. '" target="_blank" rel="noopener noreferrer">' . $label . '</a>';
},
$escaped
);
$escaped = preg_replace('/`([^`]+)`/', '<code>$1</code>', $escaped);
$escaped = preg_replace('/\*\*([^*]+)\*\*/', '<strong>$1</strong>', $escaped);
$escaped = preg_replace('/(?<![\w*])\*([^*]+)\*(?![\w*])/', '<em>$1</em>', $escaped);
return (string)$escaped;
}
}