Umsetzung von docs/specs/self-updater.md für Laravel: - Installierter Stand als SHA in storage/.version, Fortschritt in storage/.update-progress, selbstheilender Wartungsmodus in storage/.maintenance - Update-Client je Kanal (stable/development), nur HTTPS, begrenzte Redirects, ZIP-Download per Stream mit PK- und SHA-256-Prüfung - Entpacken mit zweistufigem ZIP-Slip-Schutz, Übernahme mit geschützten Pfaden (atomar je Datei, nie löschen), Migrationen, Cache- und OPcache-Reset - Lizenzspeicher außerhalb der DB, Geräte-ID als Zufallszahl, rotierendes Gerätetoken wird bei jeder Antwort (auch Fehler und Downloads) sofort gespeichert - Lizenzfehler mit verständlichen Meldungen – sie sperren nie das Portal - Seite „Aktualisierung“ mit Kanal, Suche, Changelog-Vorschau, Fortschritt, Migrationen, Änderungsprotokoll, Lizenz und Datenschutzhinweis - Wartungs-Middleware (503 + Retry-After) und Auto-Migration per Fingerabdruck - Audit-Log für Updates, Kanalwechsel und Lizenzänderungen - Version 0.2.0 Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
44 lines
2.9 KiB
PHP
44 lines
2.9 KiB
PHP
<?php
|
||
|
||
namespace App\Support\License;
|
||
|
||
/**
|
||
* Verständliche deutsche Meldungen zu den Fehlercodes der Hersteller-Server.
|
||
* Lizenzfehler sperren nie das Programm – sie verhindern nur den Update-Bezug.
|
||
*/
|
||
final class ServerMessages
|
||
{
|
||
public static function for(ServerError $error): string
|
||
{
|
||
$wait = $error->retryAfter ? ' Bitte in etwa '.self::duration($error->retryAfter).' erneut versuchen.' : ' Bitte später erneut versuchen.';
|
||
|
||
return match ($error->errorCode) {
|
||
'license_required' => 'Für Updates ist eine Lizenz nötig. Bitte Lizenz-E-Mail und Lizenzschlüssel hinterlegen.',
|
||
'invalid_key' => 'Der Lizenzschlüssel ist unbekannt. Bitte die Eingabe prüfen.',
|
||
'email_mismatch' => 'Die E-Mail-Adresse passt nicht zu diesem Lizenzschlüssel. Bitte die auf der Lizenz hinterlegte Adresse verwenden.',
|
||
'license_expired' => 'Die Lizenz ist abgelaufen. Updates sind erst nach einer Verlängerung wieder verfügbar – das Portal läuft unverändert weiter.',
|
||
'license_revoked' => 'Die Lizenz wurde gesperrt. Bitte wenden Sie sich an den Support.',
|
||
'device_limit_reached' => sprintf(
|
||
'Alle Geräteplätze der Lizenz sind belegt (%s von %s). Geben Sie im Kundenportal einen Platz frei oder erweitern Sie die Lizenz.',
|
||
$error->payload['devices_used'] ?? '?',
|
||
$error->payload['devices_max'] ?? '?',
|
||
),
|
||
'device_cloned' => 'Die Lizenz wird offenbar in einer kopierten Installation mehrfach genutzt. Bitte wenden Sie sich an den Support.',
|
||
'device_id_required' => 'Die Lizenz ist gerätegebunden, es wurde aber keine Gerätekennung übermittelt. Bitte wenden Sie sich an den Support.',
|
||
'rate_limited' => 'Zu viele Anfragen in kurzer Zeit.'.$wait,
|
||
'maintenance' => 'Der Update-Server wird gerade gewartet.'.$wait,
|
||
'upstream_unavailable' => 'Der Update-Server ist vorübergehend nicht erreichbar. Die installierte Version bleibt unverändert.'.$wait,
|
||
'mirror_pending' => 'Die neue Version wird gerade bereitgestellt.'.$wait,
|
||
'not_released' => 'Es ist noch keine Version zur Auslieferung freigegeben.'.$wait,
|
||
'unknown_tool' => 'Dieser Update-Kanal ist beim Hersteller noch nicht eingerichtet. Bitte den Kanal „Stabil“ verwenden.',
|
||
'unreachable' => 'Der Update-Server ist nicht erreichbar. Bitte die Internetverbindung des Servers prüfen (ausgehende HTTPS-Verbindungen müssen erlaubt sein).',
|
||
'invalid_response' => 'Der Update-Server hat eine unerwartete Antwort geliefert.'.$wait,
|
||
default => 'Der Update-Server meldet einen Fehler ('.$error->errorCode.').'.$wait,
|
||
};
|
||
}
|
||
|
||
private static function duration(int $seconds): string
|
||
{
|
||
return $seconds < 90 ? "{$seconds} Sekunden" : (int) ceil($seconds / 60).' Minuten';
|
||
}
|
||
}
|