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
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:
parent
623d423ad8
commit
c275db4dce
147 changed files with 760 additions and 498 deletions
|
|
@ -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);
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue