Unifi-Voucher-Tool/updater
Friederich Loheide 4c1e58e68f
All checks were successful
CI / PHP Lint (push) Successful in 36s
CI / PHP Lint-1 (push) Successful in 38s
CI / Unit Tests & Static Analysis (push) Successful in 42s
CI / PHP Lint (pull_request) Successful in 36s
CI / PHP Lint-1 (pull_request) Successful in 41s
CI / Unit Tests & Static Analysis (pull_request) Successful in 42s
Zertifikatsprüfung als Opt-in: pro Site und für SMTP
Übernommen aus dem alten Review-Branch
claude/tool-review-optimization-q9nyv5, neu gebaut auf dem aktuellen
Stand. Der Rest jenes Branches ist durch das Redesign überholt.

Bisher galt CURLOPT_SSL_VERIFYPEER => false für jede Verbindung zum
Controller, ohne Möglichkeit, das zu ändern. Wer den Controller unter
seinem echten Namen mit gültigem Zertifikat betreibt, kann die Prüfung
jetzt pro Site einschalten; Standard bleibt aus, weil UniFi-Geräte ab
Werk ein selbst signiertes Zertifikat liefern.

- Migration 0008, Spalte sites.ssl_verify (Default 0)
- UniFiController: fünfter Konstruktor-Parameter, steuert VERIFYPEER und
  VERIFYHOST; testConnection() ebenso. Alle acht Aufrufer geben den Wert
  der Site weiter, tolerant über "?? 0" für Alt-Installationen
- Site-Verwaltung: Schalter in beiden Modalen, Abzeichen auf der Karte
- Mailer: dasselbe über die Einstellung smtp_verify_ssl, Schalter im
  SMTP-Tab
- Backup nimmt die Spalte mit, Readme erklärt, wann man sie einschaltet
- 3 Tests auf den Durchgriff bis cURL (75 Tests, 178 Assertions)

Nebenbei: der Aufruf von openEditModal() hat fehlende Spalten bisher als
leeres Argument gerendert - jetzt über (int)(... ?? 0) abgesichert.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-25 05:12:28 +00:00
..
migrations Zertifikatsprüfung als Opt-in: pro Site und für SMTP 2026-09-25 05:12:28 +00:00
storage Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00
templates Entwicklerhinweis "Entwickelt von Loheide.eu" ergänzen 2026-09-23 11:21:53 +00:00
AuditLogger.php Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00
bootstrap.php Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00
MigrationRunner.php Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00
README.md Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00
routes.php Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00
UpdateController.php Updater-Migration für Feature-Tabellen + README um neue Features erweitern 2026-06-05 19:16:55 +00:00
UpdateManager.php Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00
UpdaterFactory.php Updater-System (OpenNIT-Modell) im isolierten updater/-Ordner 2026-06-05 18:51:51 +00:00

Updater (OpenVoucherTool)

Auto-Update-System nach dem OpenNIT-Modell: zieht Quellcode + DB-Migrationen aus einem zentralen Repository über einen HTTP-Update-Proxy nach.

[diese App]  ←HTTPS→  [Update-Proxy]  ←pull→  [Git-Repo]
  • Versions-Identität: 40-stelliger Git-Commit-SHA in updater/storage/.version
  • Channels: stable → https://update.loheide.eu/openvouchertool, development → https://update.loheide.eu/openvouchertool-development
  • User-Agent: OpenVoucherTool-Updater/1.0
  • DB-Treiber: MySQL/MariaDB (Migrations-Tracking-Tabelle _updater_migrations)

Aufruf

Admin-Oberfläche: /admin/update.php (nur für angemeldete Admins).

Endpoint Methode Zweck
admin/update.php GET Admin-UI
admin/update.php?action=check GET Update-Prüfung (JSON)
admin/update.php?action=progress GET Fortschritt (JSON)
admin/update.php?action=migrations GET Migrations-Status (JSON)
admin/update.php action=install POST Update installieren (+csrf_token)
admin/update.php action=set_channel POST Channel wählen (+csrf_token)

Optional: In der Admin-Navigation (admin/index.php) einen Link zu update.php ergänzen, damit die Seite auffindbar ist. Das ist bewusst nicht automatisch geschehen (Isolations-Prinzip – siehe unten).

Isolation

Der Updater liegt vollständig in updater/ (eigener Namespace Updater\) plus zwei dünne, klar markierte Anknüpfungen:

  1. Front-Controller-Hook in index.php (Maintenance-Check, markiert mit // Updater maintenance hook).
  2. Entry-Shim admin/update.php (lädt nur Basis + Bootstrap, delegiert an den Controller).

Eigene Settings (updater/storage/updater-settings.json), eigener Autoloader (updater/bootstrap.php), eigener AuditLogger (schreibt in die vorhandene audit_log-Tabelle), eigenes Migrations-System (updater/migrations/ + Tabelle _updater_migrations). Es werden keine Projekt-Klassen erweitert – \Database und \Auth werden nur per Injection genutzt.

Geschützte Pfade (werden bei Updates nie überschrieben)

config.php, .htaccess, .env*, .git/, .gitignore, public/uploads/, vendor/, composer.lock, updater/storage/.

Rückbau (restlos entfernen)

  1. In index.php den Block „Updater maintenance hook" (die Zeilen 2–8, beginnend mit $maintenanceFile = … bis zum schließenden }) entfernen.
  2. rm -r updater/
  3. rm admin/update.php
  4. (optional) In der Datenbank: DROP TABLE _updater_migrations;
  5. (optional, falls vorhanden) Laufzeitdateien sind bereits in updater/ und damit mit Schritt 2 weg. Nichts liegt außerhalb.

Danach ist keine Spur des Updaters mehr im Bestandscode – der Beweis für die Isolation.

Smoke-Test

# 1) Syntax aller Updater-Dateien
php -l updater/UpdateManager.php
php -l updater/MigrationRunner.php
php -l updater/UpdateController.php
php -l updater/UpdaterFactory.php
php -l updater/AuditLogger.php

# 2) Admin-Seite aufrufen (eingeloggt als Admin):
#    https://<host>/admin/update.php
#    -> "Auf Updates prüfen" klicken. Erwartung: Proxy-Antwort oder klare
#       Fehlermeldung (wenn Proxy/Channel nicht erreichbar).

# 3) Maintenance-Mode manuell testen:
touch updater/storage/.maintenance     # index.php zeigt jetzt 503-Wartungsseite
rm    updater/storage/.maintenance     # wieder normal

Hinweis: Ein vollständiger Installations-Durchlauf (action=install) setzt einen erreichbaren Update-Proxy unter den oben genannten URLs voraus.