Self-Updater und Lizenzprüfung

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>
This commit is contained in:
Friederich Loheide 2026-09-26 06:02:19 +00:00
parent a36752e09a
commit 43244d751a
41 changed files with 3184 additions and 3 deletions

View file

@ -0,0 +1,97 @@
<?php
namespace App\Http\Controllers\Admin;
use App\Http\Controllers\Controller;
use App\Support\Audit;
use App\Support\License\ServerError;
use App\Support\License\ServerMessages;
use App\Support\Update\Channels;
use App\Support\Update\Migrations;
use App\Support\Update\UpdateCheck;
use App\Support\Update\UpdateProgress;
use App\Support\Update\Updater;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Validation\Rule;
use Throwable;
/**
* Endpunkte der Seite „Aktualisierung“ – nur für Administratoren, CSRF-geschützt.
*/
class UpdateController extends Controller
{
public function check(Request $request, UpdateCheck $check): JsonResponse
{
try {
return response()->json(['ok' => true, 'result' => $check->run()]);
} catch (ServerError $e) {
return $this->serverError($e);
}
}
public function install(Request $request, Updater $updater, UpdateProgress $progress): JsonResponse
{
if ($progress->isRunning()) {
return response()->json(['ok' => false, 'message' => 'Es läuft bereits eine Aktualisierung.'], 409);
}
// Der Ablauf läuft serverseitig zu Ende, auch wenn der Browser die Verbindung trennt.
@set_time_limit(0);
@ignore_user_abort(true);
try {
$result = $updater->installUpdate($request->user()?->id);
return response()->json(['ok' => true, 'result' => $result]);
} catch (ServerError $e) {
return $this->serverError($e);
} catch (Throwable $e) {
return response()->json(['ok' => false, 'message' => $e->getMessage()], 500);
}
}
public function progress(UpdateProgress $progress): JsonResponse
{
return response()->json($progress->get());
}
public function channel(Request $request, Channels $channels): JsonResponse
{
$validated = $request->validate([
'channel' => ['required', 'string', Rule::in(array_keys($channels->all()))],
]);
$channels->setActive($validated['channel']);
Audit::log('update.channel_changed', ['channel' => $validated['channel']]);
return response()->json(['ok' => true, 'channel' => $validated['channel']]);
}
public function migrations(Migrations $migrations): JsonResponse
{
@set_time_limit(0);
try {
$count = $migrations->run();
@file_put_contents(storage_path('.migrations-fingerprint'), $migrations->fingerprint());
Audit::log('update.migrations', ['migrations' => $count]);
return response()->json(['ok' => true, 'count' => $count, 'status' => $migrations->status()]);
} catch (Throwable $e) {
Audit::log('update.migrations_failed', ['error' => $e->getMessage()]);
return response()->json(['ok' => false, 'message' => 'Migrationen fehlgeschlagen: '.$e->getMessage()], 500);
}
}
private function serverError(ServerError $e): JsonResponse
{
return response()->json([
'ok' => false,
'code' => $e->errorCode,
'message' => ServerMessages::for($e),
'license_input' => $e->needsLicenseInput(),
], 200);
}
}