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>
139 lines
5.3 KiB
PHP
139 lines
5.3 KiB
PHP
<?php
|
||
|
||
namespace App\Support\Update;
|
||
|
||
use App\Support\Audit;
|
||
use App\Support\License\ServerError;
|
||
use App\Support\License\ServerMessages;
|
||
use Illuminate\Support\Facades\Artisan;
|
||
use Illuminate\Support\Facades\Log;
|
||
use RuntimeException;
|
||
use Throwable;
|
||
|
||
/**
|
||
* Self-Updater: holt den Stand des aktiven Kanals als ZIP, legt ihn über die
|
||
* Produktion (mit geschützten Pfaden), migriert, leert Caches und merkt sich
|
||
* den neuen Commit-SHA. Ablauf und Prozentwerte nach docs/specs/self-updater.md.
|
||
*/
|
||
class Updater
|
||
{
|
||
public function __construct(
|
||
private readonly Channels $channels,
|
||
private readonly InstalledVersion $version,
|
||
private readonly UpdateProgress $progress,
|
||
private readonly MaintenanceFlag $maintenance,
|
||
private readonly ZipExtractor $extractor,
|
||
private readonly Migrations $migrations,
|
||
private readonly ?string $basePath = null,
|
||
) {}
|
||
|
||
/**
|
||
* @return array{sha: string, migrations: int, files: int}
|
||
*/
|
||
public function installUpdate(?int $userId = null, ?string $channel = null): array
|
||
{
|
||
$channel ??= $this->channels->active();
|
||
$zipFile = storage_path('app/update-'.bin2hex(random_bytes(4)).'.zip');
|
||
$staging = storage_path('.update-staging');
|
||
$targetSha = null;
|
||
$migrationCount = 0;
|
||
|
||
try {
|
||
$this->progress->set(0, 'maintenance', 'Wartungsmodus wird aktiviert …');
|
||
$this->maintenance->activate((int) config('updater.maintenance_max_seconds', 600));
|
||
|
||
$this->progress->set(5, 'version', 'Neueste Version wird ermittelt …');
|
||
$client = $this->channels->client($channel);
|
||
$targetSha = (string) ($client->version()['sha'] ?? '');
|
||
|
||
if (! InstalledVersion::isSha($targetSha)) {
|
||
throw new RuntimeException('Der Update-Server hat keinen gültigen Versionsstand gemeldet.');
|
||
}
|
||
|
||
$this->progress->set(20, 'download', 'Neue Version wird heruntergeladen …');
|
||
$headers = $client->downloadZip($targetSha, $zipFile);
|
||
$this->verifyZip($zipFile, $headers);
|
||
|
||
$this->progress->set(50, 'extract', 'Archiv wird entpackt …');
|
||
$this->extractor->extract($zipFile, $staging);
|
||
|
||
$this->progress->set(65, 'apply', 'Dateien werden übernommen …');
|
||
$result = (new StagingApplier(ProtectedPaths::fromConfig()))->apply($staging, $this->basePath ?? base_path());
|
||
|
||
$this->progress->set(80, 'migrate', 'Datenbank wird aktualisiert …');
|
||
$migrationCount = $this->migrations->run();
|
||
|
||
$this->progress->set(90, 'cache', 'Zwischenspeicher werden geleert …');
|
||
$this->clearCaches();
|
||
|
||
$this->version->save($targetSha);
|
||
@file_put_contents(storage_path('.migrations-fingerprint'), $this->migrations->fingerprint());
|
||
|
||
Audit::log('update.installed', [
|
||
'channel' => $channel,
|
||
'sha' => $targetSha,
|
||
'migrations' => $migrationCount,
|
||
'files' => $result['copied'],
|
||
], $userId);
|
||
|
||
$this->progress->set(100, 'done', 'Aktualisierung abgeschlossen.');
|
||
|
||
return ['sha' => $targetSha, 'migrations' => $migrationCount, 'files' => $result['copied']];
|
||
} catch (Throwable $e) {
|
||
$message = $e instanceof ServerError ? ServerMessages::for($e) : $e->getMessage();
|
||
|
||
$this->progress->fail($message);
|
||
Log::error('Update fehlgeschlagen: '.$e->getMessage(), ['exception' => $e]);
|
||
Audit::log('update.failed', [
|
||
'channel' => $channel,
|
||
'sha' => $targetSha,
|
||
'migrations' => $migrationCount,
|
||
'error' => $message,
|
||
'code' => $e instanceof ServerError ? $e->errorCode : null,
|
||
], $userId);
|
||
|
||
throw $e;
|
||
} finally {
|
||
$this->maintenance->deactivate();
|
||
@unlink($zipFile);
|
||
Filesystem::deleteDirectory($staging);
|
||
}
|
||
}
|
||
|
||
/**
|
||
* @param array{sha: string|null, sha256: string|null} $headers
|
||
*/
|
||
private function verifyZip(string $file, array $headers): void
|
||
{
|
||
$handle = @fopen($file, 'rb');
|
||
$magic = $handle ? fread($handle, 2) : '';
|
||
|
||
if ($handle) {
|
||
fclose($handle);
|
||
}
|
||
|
||
if ($magic !== 'PK') {
|
||
throw new RuntimeException('Die Antwort des Update-Servers ist kein ZIP-Archiv (vermutlich eine Fehlerseite). Die installierte Version bleibt unverändert.');
|
||
}
|
||
|
||
if ($headers['sha256'] && ! hash_equals(strtolower($headers['sha256']), hash_file('sha256', $file))) {
|
||
throw new RuntimeException('Das heruntergeladene Archiv ist beschädigt (Prüfsumme stimmt nicht). Bitte erneut versuchen.');
|
||
}
|
||
}
|
||
|
||
private function clearCaches(): void
|
||
{
|
||
foreach (['cache:clear', 'view:clear', 'config:clear', 'route:clear', 'event:clear'] as $command) {
|
||
try {
|
||
Artisan::call($command);
|
||
} catch (Throwable $e) {
|
||
Log::warning("{$command} fehlgeschlagen: ".$e->getMessage());
|
||
}
|
||
}
|
||
|
||
// Bytecode-Cache verwerfen – sonst läuft noch eine Weile der alte Code.
|
||
if (function_exists('opcache_reset')) {
|
||
@opcache_reset();
|
||
}
|
||
}
|
||
}
|