Plugins nicht mehr grundlos abschalten (0.48.1)
Some checks failed
CI / PHP 8.3 / mariadb:10.6 (pull_request) Successful in 6m59s
CI / PHP 8.4 / mariadb:10.6 (pull_request) Successful in 6m54s
CI / PHP 8.3 / mariadb:11.4 (pull_request) Successful in 7m42s
CI / PHP 8.4 / mariadb:11.4 (pull_request) Successful in 7m36s
CI / PHP 8.3 / mysql:8.0 (pull_request) Failing after 10m9s
CI / PHP 8.4 / mysql:8.0 (pull_request) Failing after 10m6s
CI / PHP 8.3 / mysql:8.4 (pull_request) Failing after 8m51s
CI / PHP 8.4 / mysql:8.4 (pull_request) Failing after 8m32s
CI / Bekannte Sicherheitslücken in Paketen (pull_request) Successful in 57s
CI / Build-Artefakte aktuell (pull_request) Successful in 1m5s

Absturz-Marken tragen ihren Zeitpunkt im Inhalt statt über filemtime();
ein einzelner Abbruch schaltet nicht mehr ab (zwei Abbrüche binnen 1 h).

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Friederich Loheide 2026-09-28 20:43:40 +00:00
parent d321e36637
commit 0e59748f03
5 changed files with 73 additions and 11 deletions

View file

@ -4,6 +4,12 @@ Neueste Version oben. Jeder Abschnitt beginnt mit `## MAJOR.MINOR.PATCH` und
enthält kurze Stichpunkte für Anwenderinnen und Anwender – keine Commit-Texte.
Der Self-Updater zeigt diese Abschnitte bei neuen Versionen an.
## 0.48.1
- Plugins wurden gelegentlich grundlos mit „Schwerer Fehler beim Laden“ abgeschaltet – vor allem, wenn mehrere Seiten gleichzeitig geladen wurden. Ursache war eine Zeitmessung über die Dateizeit, die auf Netzlaufwerken von der Uhr des Servers abweichen kann. Die Erkennung misst jetzt unabhängig davon
- Ein einzelner Abbruch schaltet ein Plugin nicht mehr ab (er kann auch von außen kommen, z. B. wenn der Hoster einen Prozess beendet). Erst ein zweiter Abbruch binnen einer Stunde deaktiviert es
- Bereits abgeschaltete Plugins bitte einmal unter Admin → Plugins wieder aktivieren
## 0.48.0 – Neue Seitenköpfe
- Die Überschriften der Seiten sind neu gestaltet und im Backend wählbar (Erscheinungsbild → Farben → Seitenköpfe): **Kopfband** (Standard – kompaktes weißes Band über die volle Breite unter dem Menü), **Kopfband mit Symbol** des Bereichs, **Mit Symbol** oder **Kräftiger Titel** mit Akzentstrich. Die Wahl gilt für das ganze Portal, auch für Plugins

View file

@ -29,6 +29,9 @@ class PluginManager
/** Ab diesem Alter gilt eine liegengebliebene Lade-Markierung als Absturz. */
private const CRASH_AFTER_SECONDS = 30;
/** Zwei Abbrüche innerhalb dieser Zeit schalten ein Plugin ab */
private const STRIKE_WINDOW_SECONDS = 3600;
private ?MaintenanceFlag $updateWindow = null;
/** @var array<string, PluginManifest>|null */
@ -429,23 +432,42 @@ class PluginManager
private function recoverFromCrash(): void
{
foreach (glob($this->markerPath('*')) ?: [] as $marker) {
if (time() - (int) @filemtime($marker) < self::CRASH_AFTER_SECONDS) {
// 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);
if ($startedAt === null || time() - $startedAt < self::CRASH_AFTER_SECONDS) {
continue; // Lädt vermutlich gerade in einer parallelen Anfrage.
}
$slug = substr(basename($marker), strlen('booting-'));
// Abgestürzt, während ein Update Dateien austauschte: kein Fehler des Plugins
if ($this->updateWindow()->covers((int) @filemtime($marker))) {
if ($this->updateWindow()->covers($startedAt)) {
Log::warning("Plugin {$slug} ist während eines Updates beim Laden abgebrochen – es bleibt aktiv.");
@unlink($marker);
continue;
}
// 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);
}
}
@ -496,7 +518,15 @@ class PluginManager
return $this->updateWindow ??= $this->app->make(MaintenanceFlag::class);
}
private function markerPath(string $slug): string
/** 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
{
$dir = storage_path('framework/plugins');
@ -504,6 +534,6 @@ class PluginManager
@mkdir($dir, 0775, true);
}
return $dir.'/booting-'.$slug;
return $dir.'/'.$kind.'-'.$slug;
}
}

View file

@ -9,5 +9,5 @@ namespace App;
*/
final class Version
{
public const VERSION = '0.48.0';
public const VERSION = '0.48.1';
}

View file

@ -232,15 +232,42 @@ class PluginSystemTest extends TestCase
$this->makePlugin('absturz', base: 'core');
$marker = storage_path('framework/plugins/booting-absturz');
@mkdir(dirname($marker), 0777, true);
file_put_contents($marker, '1');
touch($marker, time() - 120);
@unlink(storage_path('framework/plugins/strike-absturz'));
// Erster Abbruch: bleibt aktiv (kann von außen kommen, z. B. beendeter PHP-Prozess)
file_put_contents($marker, (string) (time() - 120));
$manager = $this->manager();
$manager->registerAll();
$this->assertTrue($manager->isEnabled('absturz'));
$this->assertFileDoesNotExist($marker);
// Zweiter Abbruch binnen einer Stunde: abgeschaltet
file_put_contents($marker, (string) (time() - 120));
$manager = $this->manager();
$manager->registerAll();
$this->assertFalse($manager->isEnabled('absturz'));
$this->assertStringContainsString('Schwerer Fehler', $manager->problem('absturz'));
$this->assertFileDoesNotExist($marker);
$this->assertFileDoesNotExist(storage_path('framework/plugins/strike-absturz'));
}
public function test_fresh_marker_with_old_file_time_is_not_a_crash(): void
{
// Netzlaufwerk mit nachgehender Uhr: Dateizeit alt, Inhalt aktuell – lädt gerade parallel
$this->makePlugin('parallel', base: 'core');
$marker = storage_path('framework/plugins/booting-parallel');
@mkdir(dirname($marker), 0777, true);
@unlink(storage_path('framework/plugins/strike-parallel'));
foreach ([1, 2] as $round) {
file_put_contents($marker, (string) time());
touch($marker, time() - 600);
$manager = $this->manager();
$manager->registerAll();
$this->assertTrue($manager->isEnabled('parallel'), "Runde {$round}");
}
$this->assertFileDoesNotExist(storage_path('framework/plugins/strike-parallel'));
}
public function test_customer_plugins_are_inactive_until_activated(): void
@ -457,8 +484,7 @@ class PluginSystemTest extends TestCase
// Absturz mitten im Update (Markierung aus dem Update-Zeitraum)
$marker = storage_path('framework/plugins/booting-absturz');
@mkdir(dirname($marker), 0777, true);
file_put_contents($marker, '1');
touch($marker, time() - 150);
file_put_contents($marker, (string) (time() - 150));
// Von einer älteren Version während des Updates abgeschaltet
$state = new PluginState($this->dir.'/state.json');

View file

@ -3,7 +3,7 @@
'name' => 'inhaus/inhaus',
'pretty_version' => 'dev-main',
'version' => 'dev-main',
'reference' => '36a58d47483e4fe6c98a0831d0d08b9aa92dbd01',
'reference' => 'd321e366379fe157bb65e8ea068db2a4e2d73f03',
'type' => 'project',
'install_path' => __DIR__ . '/../../',
'aliases' => array(),
@ -550,7 +550,7 @@
'inhaus/inhaus' => array(
'pretty_version' => 'dev-main',
'version' => 'dev-main',
'reference' => '36a58d47483e4fe6c98a0831d0d08b9aa92dbd01',
'reference' => 'd321e366379fe157bb65e8ea068db2a4e2d73f03',
'type' => 'project',
'install_path' => __DIR__ . '/../../',
'aliases' => array(),