Menüleiste am Handy, Updater in zwei Schritten, Absturzerkennung ohne Merkdateien (0.62.0)
Some checks failed
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 11m34s
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 12m8s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 15m14s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 15m47s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 13m48s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 14m15s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 16m38s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 17m2s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 1m16s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m53s

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Friederich Loheide 2026-10-07 17:03:05 +00:00
parent 623d423ad8
commit c275db4dce
147 changed files with 760 additions and 498 deletions

View file

@ -19,15 +19,17 @@ use Throwable;
* plugins-core/<slug>/ mitgeliefert (Teil jedes Updates)
* plugins/<slug>/ vom Kunden installiert (geschützt, Updates lassen sie in Ruhe)
*
* Wiederherstellungsmodus: Vor dem Laden eines Plugins wird eine Markierung
* geschrieben und danach entfernt. Bleibt sie liegen, ist der Prozess beim
* Laden abgestürzt (Fatal Error) – das Plugin wird beim nächsten Aufruf
* deaktiviert, das Portal bleibt erreichbar. Ausnahmen führen sofort dazu.
* Wiederherstellungsmodus: Ausnahmen beim Laden schalten ein Plugin sofort ab.
* Schwere Fehler (Fatal Error), die PHP beendet, fängt eine Shutdown-Funktion ab:
* Sie weiß, welches Plugin gerade geladen wurde, und vermerkt den Absturz in
* plugins.json. Zweimal binnen einer Stunde → abgeschaltet, das Portal bleibt
* erreichbar. Ohne Merkdateien: Ein von außen beendeter Prozess (Speicher,
* Hoster) hinterlässt nichts und kann kein gesundes Plugin mehr abschalten.
*/
class PluginManager
{
/** Ab diesem Alter gilt eine liegengebliebene Lade-Markierung als Absturz. */
private const CRASH_AFTER_SECONDS = 30;
/** Fehlerarten, bei denen PHP abbricht und kein catch mehr greift */
private const FATAL_ERRORS = [E_ERROR, E_PARSE, E_CORE_ERROR, E_COMPILE_ERROR];
/** Zwei Abbrüche innerhalb dieser Zeit schalten ein Plugin ab */
private const STRIKE_WINDOW_SECONDS = 3600;
@ -46,6 +48,11 @@ class PluginManager
/** @var array<string, bool> */
private array $autoloaded = [];
/** Plugin, das gerade geladen wird – für die Shutdown-Funktion */
private ?string $booting = null;
private bool $shutdownHandlerRegistered = false;
public function __construct(
private readonly Application $app,
private readonly PluginState $state,
@ -180,7 +187,7 @@ class PluginManager
*/
public function registerAll(): void
{
$this->recoverFromCrash();
$this->removeLegacyMarkers();
$this->reenableAfterIncompleteUpload();
$this->reenableAfterUpdate();
@ -393,12 +400,20 @@ class PluginManager
// Während eines Updates tauscht das Portal gerade Dateien aus: Fehler beim Laden sind dann
// meist nur ein Zwischenstand – das Plugin fehlt in dieser Anfrage, wird aber nicht abgeschaltet.
$updating = $this->updateWindow()->isUpdating();
$marker = $this->markerPath($manifest->slug);
if (! $updating) {
@file_put_contents($marker, (string) time());
if (! $this->shutdownHandlerRegistered) {
$this->shutdownHandlerRegistered = true;
register_shutdown_function(function () {
$error = error_get_last();
if ($this->booting !== null && is_array($error)) {
$this->handleFatalError($error);
}
});
}
$this->booting = $manifest->slug;
try {
$callback();
} catch (PluginClassMissing $e) {
@ -425,49 +440,49 @@ class PluginManager
$this->state->setEnabled($manifest->slug, false, 'Fehler beim Laden: '.$e->getMessage());
}
} finally {
@unlink($marker);
$this->booting = null;
}
}
private function recoverFromCrash(): void
/**
* Aus der Shutdown-Funktion: PHP ist mit einem schweren Fehler abgebrochen, während
* ein Plugin geladen wurde. Erster Abbruch: nur vermerken (kann z. B. eine überschrittene
* Laufzeit auf einem überlasteten Server sein). Ein wirklich defektes Plugin bricht bei
* jeder Anfrage ab und fällt binnen Sekunden ein zweites Mal auf – dann wird es abgeschaltet.
*
* @param array{type: int, message: string, file?: string, line?: int} $error
*/
public function handleFatalError(array $error): void
{
foreach (glob($this->markerPath('*')) ?: [] as $marker) {
// Zeitpunkt aus dem Inhalt, nicht aus filemtime(): Liegt storage auf einem Netzlaufwerk,
// stammt die Dateizeit von dessen Uhr – geht sie nach, sähe eine eben geschriebene Marke
// wie ein alter Absturz aus und ein gesundes Plugin würde abgeschaltet.
$startedAt = $this->markerTime($marker);
$slug = $this->booting;
if ($startedAt === null || time() - $startedAt < self::CRASH_AFTER_SECONDS) {
continue; // Lädt vermutlich gerade in einer parallelen Anfrage.
if ($slug === null || ! in_array($error['type'], self::FATAL_ERRORS, true)) {
return;
}
$this->booting = null;
$message = mb_substr(trim(strtok($error['message'], "\n") ?: ''), 0, 300);
try {
if ($this->updateWindow()->isUpdating()) {
Log::warning("Plugin {$slug} ist während eines Updates beim Laden abgebrochen – es bleibt aktiv: {$message}");
return;
}
$slug = substr(basename($marker), strlen('booting-'));
$previous = $this->state->crashedAt($slug);
// Abgestürzt, während ein Update Dateien austauschte: kein Fehler des Plugins
if ($this->updateWindow()->covers($startedAt)) {
Log::warning("Plugin {$slug} ist während eines Updates beim Laden abgebrochen – es bleibt aktiv.");
@unlink($marker);
if ($previous === null || time() - $previous > self::STRIKE_WINDOW_SECONDS) {
$this->state->recordCrash($slug);
Log::warning("Plugin {$slug} ist beim Laden abgebrochen ({$message}) – es bleibt vorerst aktiv. Bricht es binnen einer Stunde erneut ab, wird es deaktiviert.");
continue;
return;
}
// Erster Abbruch: nur merken. Ein einzelner Abbruch kann auch von außen kommen (z. B. ein
// vom Hoster beendeter PHP-Prozess). Ein wirklich defektes Plugin bricht bei jeder Anfrage ab
// und fällt so binnen Sekunden ein zweites Mal auf.
$strike = $this->markerPath($slug, 'strike');
if (time() - (int) $this->markerTime($strike) > self::STRIKE_WINDOW_SECONDS) {
@file_put_contents($strike, (string) time());
@unlink($marker);
Log::warning("Plugin {$slug} ist beim Laden abgebrochen – es bleibt vorerst aktiv. Bricht es binnen einer Stunde erneut ab, wird es deaktiviert.");
continue;
}
Log::critical("Plugin {$slug} hat beim Laden einen schweren Fehler verursacht und wurde deaktiviert.");
$this->state->setEnabled($slug, false, 'Schwerer Fehler beim Laden (das Portal wurde dadurch unterbrochen).');
@unlink($marker);
@unlink($strike);
Log::critical("Plugin {$slug} hat beim Laden einen schweren Fehler verursacht und wurde deaktiviert: {$message}");
$this->state->setEnabled($slug, false, 'Schwerer Fehler beim Laden: '.$message);
} catch (Throwable) {
// Im Shutdown darf nichts mehr werfen.
}
}
@ -518,22 +533,22 @@ class PluginManager
return $this->updateWindow ??= $this->app->make(MaintenanceFlag::class);
}
/** Zeitpunkt, den die Marke enthält; null, solange sie noch geschrieben wird. */
private function markerTime(string $file): ?int
{
$content = trim((string) @file_get_contents($file));
return ctype_digit($content) ? (int) $content : null;
}
private function markerPath(string $slug, string $kind = 'booting'): string
/**
* Merkdateien früherer Versionen (storage/framework/plugins) aufräumen – sie würden
* sonst nie mehr gelesen. Danach kostet die Prüfung nur noch ein is_dir().
*/
private function removeLegacyMarkers(): void
{
$dir = storage_path('framework/plugins');
if (! is_dir($dir)) {
@mkdir($dir, 0775, true);
return;
}
return $dir.'/'.$kind.'-'.$slug;
foreach (array_merge(glob($dir.'/booting-*') ?: [], glob($dir.'/strike-*') ?: []) as $file) {
@unlink($file);
}
@rmdir($dir);
}
}