diff --git a/.gitignore b/.gitignore index 703206f1..cc33122d 100644 --- a/.gitignore +++ b/.gitignore @@ -24,9 +24,11 @@ /storage/.version /storage/.update-progress /storage/.maintenance +/storage/.maintenance-* # Laufzeitzustand der Installation – nie ausliefern (ein manuelles Update würde sonst fällige Migrationen überspringen) /storage/.migrations-fingerprint /storage/.background-heartbeat /storage/.background.lock _ide_helper.php Thumbs.db +/public/plugin-assets diff --git a/CHANGELOG.md b/CHANGELOG.md index c243ea47..4cab0a6a 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,14 @@ 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.45.0 – Schneller und stabiler bei Updates + +- Seiten laden schneller: Der Texteditor und der vollständige Symbolsatz werden nur noch geladen, wenn sie gebraucht werden – pro Seite etwa halb so viel JavaScript wie bisher +- Menüpunkte und Neuigkeiten laden schon beim Überfahren mit der Maus vor – der Klick wirkt dann fast sofort (das Vorladen zählt nicht als „gelesen“) +- Die Oberflächen-Dateien von Plugins (Nachrichten, Gruppen, Kleinanzeigen …) liefert der Webserver jetzt direkt aus statt über PHP – deutlich schneller beim ersten Aufruf +- Weitere Menü-Symbole (u. a. Nachrichten, Gruppen, Kleinanzeigen, Redaktion, Umfragen) sind jetzt fest eingebaut +- Updates schalten keine Plugins mehr ab: Fehler, die nur entstehen, weil während eines Portal- oder Plugin-Updates gerade Dateien ausgetauscht werden, lassen das Plugin aktiv. Ein Plugin, das vor dieser Version so abgeschaltet wurde, bitte einmal unter „Plugins“ wieder einschalten + ## 0.44.0 – Herzen und Kommentare schon in der Vorschau - Neuigkeiten zeigen jetzt überall, wo sie als Vorschau erscheinen, wie viele Herzen und Kommentare sie haben – in der Übersicht, auf der Startseite (Neuigkeiten, Aktuelles aus den Bereichen, Slider), im Baustein „Neuigkeiten“ und unter „Weitere Beiträge“. Ein gefülltes Herz heißt: Sie haben selbst eins gegeben diff --git a/app/Plugins/PluginAssets.php b/app/Plugins/PluginAssets.php index f8257db5..1c06d5a8 100644 --- a/app/Plugins/PluginAssets.php +++ b/app/Plugins/PluginAssets.php @@ -2,7 +2,9 @@ namespace App\Plugins; +use App\Support\Update\Filesystem; use App\Version; +use Illuminate\Support\Facades\Log; /** * Vorkompilierte Oberflächen separat installierter Plugins (Plugin-SDK). @@ -59,6 +61,9 @@ class PluginAssets $clean = fn ($file) => is_string($file) && preg_match('#^[A-Za-z0-9_./-]+$#', $file) && ! str_contains($file, '..') ? $file : null; + // Einmal nach public/ kopieren – dann liefert der Webserver die Dateien ohne PHP aus + $this->publish($slug, $manifest); + $this->cache[$slug] = [ 'base' => '/plugin-assets/'.rawurlencode($slug).'/'.rawurlencode($manifest->version).'/', 'components' => array_filter(array_map($clean, (array) ($data['components'] ?? [])), fn ($file, $key) => $file !== null && preg_match('#^[A-Za-z0-9_/-]+$#', (string) $key), ARRAY_FILTER_USE_BOTH), @@ -85,6 +90,83 @@ class PluginAssets ]]; } + /** + * dist/ eines aktiven Plugins nach public/plugin-assets/// kopieren (gleiche + * Adresse wie die PHP-Route). Der Webserver liefert vorhandene Dateien direkt aus – schneller + * und ohne Sitzung. Geht das Kopieren nicht (public/ schreibgeschützt), springt die Route ein. + */ + public function publish(string $slug, PluginManifest $manifest): bool + { + $target = self::publicPath($slug).'/'.$manifest->version; + + if (is_file($target.'/.complete')) { + return true; + } + + $dist = realpath($manifest->path.'/dist'); + + if (! $dist || ! preg_match('#^[A-Za-z0-9.+-]+$#', $manifest->version)) { + return false; + } + + $staging = self::publicPath($slug).'/.tmp-'.bin2hex(random_bytes(4)); + + try { + $files = new \RecursiveIteratorIterator(new \RecursiveDirectoryIterator($dist, \FilesystemIterator::SKIP_DOTS)); + + foreach ($files as $file) { + $relative = substr($file->getPathname(), strlen($dist) + 1); + + // Nur erlaubte Dateitypen und saubere Namen (wie bei der Route) + if (! $file->isFile() || ! isset(self::TYPES[strtolower($file->getExtension())]) || ! preg_match('#^[A-Za-z0-9_./-]+$#', $relative)) { + continue; + } + + if (! is_dir(dirname($staging.'/'.$relative)) && ! @mkdir(dirname($staging.'/'.$relative), 0775, true)) { + throw new \RuntimeException('public/plugin-assets ist nicht beschreibbar.'); + } + + if (! @copy($file->getPathname(), $staging.'/'.$relative)) { + throw new \RuntimeException("{$relative} konnte nicht kopiert werden."); + } + } + + @file_put_contents($staging.'/.complete', (string) time()); + Filesystem::deleteDirectory($target); + + if (! @rename($staging, $target)) { + throw new \RuntimeException('Kopie konnte nicht übernommen werden.'); + } + + // Ältere Versionen dieses Plugins entfernen + foreach (glob(self::publicPath($slug).'/*', GLOB_ONLYDIR) ?: [] as $dir) { + if (basename($dir) !== $manifest->version) { + Filesystem::deleteDirectory($dir); + } + } + + return true; + } catch (\Throwable $e) { + Filesystem::deleteDirectory($staging); + Log::info("Plugin-Dateien von {$slug} werden über PHP ausgeliefert: ".$e->getMessage()); + + return false; + } + } + + /** Veröffentlichte Kopie entfernen (Plugin deaktiviert oder gelöscht) */ + public static function unpublish(string $slug): void + { + if (preg_match('#^[a-z0-9-]+$#', $slug)) { + Filesystem::deleteDirectory(self::publicPath($slug)); + } + } + + private static function publicPath(string $slug): string + { + return rtrim((string) (config('inhaus.plugin_assets_path') ?: public_path('plugin-assets')), '/').'/'.$slug; + } + /** * Pfad einer ausgelieferten Datei – nur aus dist/ eines aktiven Kunden-Plugins. */ diff --git a/app/Plugins/PluginInstaller.php b/app/Plugins/PluginInstaller.php index c033c0cd..23b0bda8 100644 --- a/app/Plugins/PluginInstaller.php +++ b/app/Plugins/PluginInstaller.php @@ -4,6 +4,7 @@ namespace App\Plugins; use App\Support\Audit; use App\Support\Update\Filesystem; +use App\Support\Update\MaintenanceFlag; use App\Support\Update\ZipExtractor; use RuntimeException; use Throwable; @@ -65,12 +66,23 @@ class PluginInstaller throw new RuntimeException('Das Verzeichnis plugins/ ist nicht beschreibbar.'); } - Filesystem::deleteDirectory($target); + // Parallele Anfragen sehen kurz ein halbes Plugin – das soll es nicht abschalten + $window = app(MaintenanceFlag::class); + $window->beginQuietUpdate(); - if (! Filesystem::moveDirectory($staging, $target)) { - throw new RuntimeException('Das Plugin konnte nicht nach plugins/ verschoben werden. Bitte Schreibrechte prüfen.'); + try { + Filesystem::deleteDirectory($target); + + if (! Filesystem::moveDirectory($staging, $target)) { + throw new RuntimeException('Das Plugin konnte nicht nach plugins/ verschoben werden. Bitte Schreibrechte prüfen.'); + } + } finally { + $window->endQuietUpdate(); } + // Neu veröffentlichen (auch bei gleicher Versionsnummer) + PluginAssets::unpublish($manifest->slug); + $this->plugins->forgetDiscovered(); Audit::log($existing ? 'plugin.updated' : 'plugin.installed', ['plugin' => $manifest->slug, 'version' => $manifest->version]); diff --git a/app/Plugins/PluginManager.php b/app/Plugins/PluginManager.php index 1cddfe3d..b9336b3b 100644 --- a/app/Plugins/PluginManager.php +++ b/app/Plugins/PluginManager.php @@ -5,6 +5,7 @@ namespace App\Plugins; use App\Http\Middleware\EnsurePluginAccess; use App\Support\Audit; use App\Support\Update\Filesystem; +use App\Support\Update\MaintenanceFlag; use Illuminate\Contracts\Foundation\Application; use Illuminate\Support\Facades\Artisan; use Illuminate\Support\Facades\Log; @@ -28,6 +29,8 @@ class PluginManager /** Ab diesem Alter gilt eine liegengebliebene Lade-Markierung als Absturz. */ private const CRASH_AFTER_SECONDS = 30; + private ?MaintenanceFlag $updateWindow = null; + /** @var array|null */ private ?array $manifests = null; @@ -176,6 +179,7 @@ class PluginManager { $this->recoverFromCrash(); $this->reenableAfterIncompleteUpload(); + $this->reenableAfterUpdate(); foreach ($this->bootOrder() as $manifest) { $this->guard($manifest, function () use ($manifest) { @@ -256,6 +260,7 @@ class PluginManager } $this->state->setEnabled($slug, false, $reason); + PluginAssets::unpublish($slug); Audit::log('plugin.deactivated', ['plugin' => $slug, 'reason' => $reason]); } @@ -284,6 +289,7 @@ class PluginManager } Filesystem::deleteDirectory($manifest->path); + PluginAssets::unpublish($slug); $this->state->forget($slug); $this->manifests = null; Audit::log('plugin.deleted', ['plugin' => $slug, 'data_removed' => $removeData]); @@ -381,8 +387,14 @@ class PluginManager private function guard(PluginManifest $manifest, callable $callback): void { + // 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); - @file_put_contents($marker, (string) time()); + + if (! $updating) { + @file_put_contents($marker, (string) time()); + } try { $callback(); @@ -395,6 +407,13 @@ class PluginManager } catch (Throwable $e) { unset($this->loaded[$manifest->slug]); $this->problems[$manifest->slug] = $e->getMessage(); + + if ($updating) { + Log::warning("Plugin {$manifest->slug} konnte während eines Updates nicht geladen werden (nicht deaktiviert): ".$e->getMessage()); + + return; + } + Log::error("Plugin {$manifest->slug} wurde wegen eines Fehlers deaktiviert: ".$e->getMessage(), ['exception' => $e]); try { @@ -415,6 +434,15 @@ class PluginManager } $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))) { + Log::warning("Plugin {$slug} ist während eines Updates beim Laden abgebrochen – es bleibt aktiv."); + @unlink($marker); + + 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); @@ -444,6 +472,30 @@ class PluginManager } } + /** + * Plugins, die während eines Updates wegen eines Ladefehlers abgeschaltet wurden (ältere + * Portal-Versionen taten das), wieder einschalten – der Fehler war nur ein Zwischenstand. + * Ist das Plugin wirklich defekt, fällt es beim nächsten Laden außerhalb des Updates erneut auf. + */ + private function reenableAfterUpdate(): void + { + foreach ($this->state->all() as $slug => $entry) { + $reason = (string) ($entry['disabled_reason'] ?? ''); + $at = $this->state->disabledAt($slug); + $crash = str_starts_with($reason, 'Fehler beim Laden') || str_starts_with($reason, 'Schwerer Fehler beim Laden'); + + if (($entry['enabled'] ?? true) === false && $crash && $at !== null && $this->updateWindow()->covers($at)) { + $this->state->setEnabled($slug, true); + Log::info("Plugin {$slug} wieder aktiviert (Ladefehler während eines Updates)."); + } + } + } + + private function updateWindow(): MaintenanceFlag + { + return $this->updateWindow ??= $this->app->make(MaintenanceFlag::class); + } + private function markerPath(string $slug): string { $dir = storage_path('framework/plugins'); diff --git a/app/Plugins/PluginState.php b/app/Plugins/PluginState.php index 29c7a948..3a5463f8 100644 --- a/app/Plugins/PluginState.php +++ b/app/Plugins/PluginState.php @@ -32,7 +32,15 @@ class PluginState public function setEnabled(string $slug, bool $enabled, ?string $reason = null): void { - $this->update($slug, ['enabled' => $enabled, 'disabled_reason' => $enabled ? null : $reason]); + $this->update($slug, ['enabled' => $enabled, 'disabled_reason' => $enabled ? null : $reason, 'disabled_at' => $enabled ? null : time()]); + } + + /** Zeitpunkt der Deaktivierung (Unix-Zeit), falls bekannt */ + public function disabledAt(string $slug): ?int + { + $at = $this->all()[$slug]['disabled_at'] ?? null; + + return is_int($at) ? $at : null; } public function disabledReason(string $slug): ?string diff --git a/app/Support/Update/MaintenanceFlag.php b/app/Support/Update/MaintenanceFlag.php index dec64578..3d87aff6 100644 --- a/app/Support/Update/MaintenanceFlag.php +++ b/app/Support/Update/MaintenanceFlag.php @@ -11,6 +11,12 @@ namespace App\Support\Update; */ class MaintenanceFlag { + /** + * So lange nach einem Update gelten Abstürze beim Laden noch als Folge des Dateiaustauschs + * (Zwischenspeicher wie OPcache und parallele Anfragen brauchen einen Moment). + */ + public const GRACE_SECONDS = 120; + public function __construct(private readonly ?string $file = null) {} public function activate(int $maxSeconds = 600): void @@ -23,7 +29,67 @@ class MaintenanceFlag public function deactivate(): void { + $data = json_decode((string) @file_get_contents($this->path()), true); @unlink($this->path()); + + // Zeitraum des letzten Updates merken (siehe covers()) + if (is_array($data) && isset($data['since'])) { + AtomicFile::write($this->lastPath(), json_encode(['since' => (int) $data['since'], 'until' => time()])); + } + } + + /** + * Dateiaustausch ohne Wartungsmodus (z. B. ein Plugin wird aktualisiert): Die Seite bleibt + * erreichbar, Ladefehler in dieser Zeit schalten aber kein Plugin ab. + */ + public function beginQuietUpdate(): void + { + AtomicFile::write($this->windowPath(), json_encode(['since' => time()])); + } + + public function endQuietUpdate(): void + { + $data = json_decode((string) @file_get_contents($this->windowPath()), true); + @unlink($this->windowPath()); + + if (is_array($data) && isset($data['since'])) { + AtomicFile::write($this->lastPath(), json_encode(['since' => (int) $data['since'], 'until' => time()])); + } + } + + /** + * Läuft gerade ein Update – oder ist eines erst eben zu Ende gegangen? + */ + public function isUpdating(): bool + { + return $this->isActive() || $this->covers(time()); + } + + /** + * Fiel dieser Zeitpunkt in ein Update (einschließlich der Nachlaufzeit)? + */ + public function covers(int $timestamp): bool + { + foreach ([$this->path(), $this->windowPath(), $this->lastPath()] as $file) { + $data = json_decode((string) @file_get_contents($file), true); + + if (! is_array($data) || ! isset($data['since'])) { + continue; + } + + $until = match ($file) { + // Läuft noch (ein abgebrochener Plugin-Austausch zählt höchstens zehn Minuten) + $this->path() => max(time(), (int) ($data['until'] ?? 0)), + $this->windowPath() => min(time(), (int) $data['since'] + 600), + default => (int) ($data['until'] ?? 0), + }; + + if ($timestamp >= (int) $data['since'] && $timestamp <= $until + self::GRACE_SECONDS) { + return true; + } + } + + return false; } public function isActive(): bool @@ -56,4 +122,14 @@ class MaintenanceFlag { return $this->file ?? storage_path('.maintenance'); } + + private function windowPath(): string + { + return $this->path().'-quiet'; + } + + private function lastPath(): string + { + return $this->path().'-last'; + } } diff --git a/app/Version.php b/app/Version.php index e1c365b5..29a3077b 100644 --- a/app/Version.php +++ b/app/Version.php @@ -9,5 +9,5 @@ namespace App; */ final class Version { - public const VERSION = '0.44.0'; + public const VERSION = '0.45.0'; } diff --git a/config/inhaus.php b/config/inhaus.php index b0808e6e..747c0065 100644 --- a/config/inhaus.php +++ b/config/inhaus.php @@ -10,6 +10,10 @@ return [ // Plugins über den Admin-Bereich (z. B. bei strengen IT-Richtlinien). 'disallow_file_mods' => env('INHAUS_DISALLOW_FILE_MODS', false), + // Ziel für die Oberflächen-Dateien von Kunden-Plugins (Webserver liefert sie ohne PHP aus); + // leer = public/plugin-assets + 'plugin_assets_path' => env('INHAUS_PLUGIN_ASSETS_PATH'), + // Adress-Schemata, an die die Anmeldung der App zurückleitet. Für die Entwicklung mit // Expo Go zusätzlich „exp“ eintragen: INHAUS_APP_SCHEMES=inhaus,exp 'app_schemes' => array_filter(array_map('trim', explode(',', (string) env('INHAUS_APP_SCHEMES', 'inhaus')))), diff --git a/docs/PLUGINS.md b/docs/PLUGINS.md index 2071bdc0..c9c36904 100644 --- a/docs/PLUGINS.md +++ b/docs/PLUGINS.md @@ -247,6 +247,13 @@ ausschließlich aus `dist/` aktiver Kunden-Plugins und nur bestimmte Dateitypen speichern die Dateien deshalb dauerhaft zwischen. Nach einer Änderung also die Version in `plugin.json` erhöhen. +Ab 0.45.0 kopiert das Portal diese Dateien beim ersten Aufruf nach +`public/plugin-assets///` (gleiche Adresse) – dann liefert sie der Webserver ohne PHP +aus. Ist `public/` nicht beschreibbar, bleibt es bei der Auslieferung über PHP. Beim Deaktivieren, +Löschen oder erneuten Hochladen wird die Kopie entfernt; `INHAUS_PLUGIN_ASSETS_PATH` setzt ein +anderes Ziel. `RichTextEditor` aus `@inhaus/ui` lädt ab 0.45.0 erst nach, wenn er angezeigt wird – +Props, `v-model` und Template-Refs funktionieren unverändert. + ### Was Plugins importieren dürfen - `vue` – die Vue-Instanz des Portals (`ref`, `computed`, `onMounted` …). diff --git a/phpunit.xml b/phpunit.xml index 2ebfd70d..1adf5d17 100644 --- a/phpunit.xml +++ b/phpunit.xml @@ -22,6 +22,7 @@ + diff --git a/plugins-core/glossar/resources/js/components/EntryDialog.vue b/plugins-core/glossar/resources/js/components/EntryDialog.vue index ae9457cb..48ea9dc4 100644 --- a/plugins-core/glossar/resources/js/components/EntryDialog.vue +++ b/plugins-core/glossar/resources/js/components/EntryDialog.vue @@ -6,7 +6,7 @@ import { Button } from '@/components/ui/button'; import { Input } from '@/components/ui/input'; import { Dialog, DialogContent, DialogFooter, DialogHeader, DialogTitle } from '@/components/ui/dialog'; import FormField from '@/components/FormField.vue'; -import RichTextEditor from '@/components/RichTextEditor.vue'; +import RichTextEditor from '@/components/RichTextEditorAsync.js'; /** * Begriff anlegen oder bearbeiten. diff --git a/plugins-core/news/resources/js/components/NewsCard.vue b/plugins-core/news/resources/js/components/NewsCard.vue index e21951f5..161cfedd 100644 --- a/plugins-core/news/resources/js/components/NewsCard.vue +++ b/plugins-core/news/resources/js/components/NewsCard.vue @@ -11,7 +11,7 @@ defineProps({