Caching
Blockstudio umfasst persistente dateibasierte Caches. Sie sind standardmäßig über die Einstellung cache.enabled aktiviert und werden hier gespeichert:
wp-content/blockstudio/cache/
Dieses konfigurierte Stammverzeichnis enthält Laufzeit-Builddaten, vorab erstellte Blockregistrierungsdaten, Editor-Assets, Tailwind CSS, gerenderte Dokumente, Island-Fragmente, statische HTML, Graph-Indizes, Warteschlangen für warme Daten und Cache-Diagnosen. So werden wiederholte Erkennungs-, Parsing-, Kompilierungs- und Rendering-Arbeiten vermieden, während der gesamte generierte Laufzeitstatus in einer zentral vom Host verwaltbaren Grenze bleibt.
Der Standardpfad liegt bewusst außerhalb von uploads, wo gehärtete Hosts PHP-Cache-Daten blockieren können. Ändere den Speicherort mit cache.path; relative Pfade werden von WP_CONTENT_DIR aus aufgelöst, während absolute Pfade dedizierte beschreibbare Cache-Volumes unterstützen:
{
"cache": {
"enabled": true,
"path": "cache/blockstudio"
}
}
Für umgebungsspezifische Konfiguration verwende entweder den Einstellungsfilter oder den Filter für das aufgelöste Verzeichnis:
add_filter('blockstudio/settings/cache/path', function () {
return '/srv/wordpress-cache/blockstudio';
});
add_filter('blockstudio/cache/dir', function (string $directory): string {
return WP_CONTENT_DIR . '/cache/blockstudio';
});
Eine Pfadänderung beginnt mit einem kalten Cache. Alte Dateien unter wp-content/uploads/blockstudio/cache werden nicht mehr gelesen und können entfernt werden.
Identität und Invalidierung
Jeder Bereich ist unter einer Netzwerk-/Blog-Identität und einer vollständigen Laufzeitidentität verschachtelt. Cache-Einträge ändern sich, wenn sich ihre Eingaben ändern, darunter überwachte Blockdateien, Felddateien, Asset-Abhängigkeiten, Einstellungen, das aktive Theme, aktive Plugins, logische Erkennungsinventare, WordPress-, PHP- und Blockstudio-Versionen. Elementspezifische Abhängigkeitshashes trennen Builds mit ausschließlich geänderten Elementen von nicht betroffenen Objekten.
Logische Erkennungsquellen tragen ebenfalls ihre Quell-ID, ihren Inhaltsfingerabdruck und ihre Überwachungseingaben bei. Alternative Laufzeitauswahlen können einen Wert für blockstudio/cache/context hinzufügen, um alle Cache-Bereiche voneinander zu isolieren.
Hosts, deren Mandantengrenze von WordPress-Netzwerk-/Blog-IDs abweicht, können blockstudio/cache/site_key filtern; das Ergebnis wird bereinigt, bevor es zu einem Pfadsegment wird.
Bei einer Anfrage mit warmem Frontend lädt Blockstudio die Laufzeitregistrierung, bevor Erkennungsquellen erstellt werden. Ein gültiger Cache-Treffer überspringt daher die rekursive Quellenerkennung, die Blockerstellung, das Parsen der Felder und wiederholte Baumdurchläufe für Cache-Schlüssel.
Die Laufzeitnutzdaten speichern außerdem aufgelöste Pfade zu Block-Assets, Größen, Zeitstempel und Stylesheet-Listen der Module. Bei Anfragen mit warmem Cache werden diese Metadaten wiederverwendet, statt für jeden gerenderten Block erneut Asset-Ausgaben abzurufen und Modulverzeichnisse zu durchsuchen. Asset-URL und Deaktivierungsfilter werden weiterhin für die aktuelle Anfrage ausgeführt, und assets.inlineLimit behält sein seitenweites Budget und die Reihenfolge der Kaskade bei. Wenn assets.enqueue oder der persistente Cache deaktiviert ist, werden keine Metadaten zu Asset-Ausgaben erfasst. Bei einem veralteten letzten erfolgreichen Build werden die Assets ersatzweise von der Festplatte aufgelöst.
Unveränderte aufgelöste Einstellungen verwenden innerhalb der Anfrage ebenfalls denselben Fingerabdruck. Beim Neuladen oder Ändern der Einstellungen wird er ungültig; veränderliche Objekt- oder Referenzwerte werden erneut gehasht, statt einen möglicherweise veralteten Fingerabdruck wiederzuverwenden.
In production und staging wird einem validierten Überwachungssnapshot 20 Sekunden lang vertraut, bevor Blockstudio seine Dateien und Verzeichnisse erneut abfragt. In local– und development-Umgebungen ist standardmäßig null eingestellt, damit Änderungen an Quellen sofort sichtbar sind. Ändere dieses Intervall mit:
add_filter('blockstudio/cache/watch_debounce', function () {
return 30;
});
Die Entprellung kann die automatische Erkennung von Quelländerungen höchstens um die konfigurierte Anzahl von Sekunden verzögern. Erforderliche kompilierte Assets, zwischengespeicherte, nicht leere Roh-Assets und Modul-Stylesheets werden bei jedem Cache-Treffer weiterhin geprüft. Wird eine Datei gelöscht, wird die Laufzeit-Nutzlast sofort ungültig, statt bis zum Ablauf des Zeitfensters veraltete Asset-Metadaten auszuliefern. Setze die Entprellung auf 0, wenn eine produktionsähnliche Umgebung auch zum aktiven Bearbeiten von Dateien genutzt wird.
Cache-Nutzlasten werden durch PHP-Dateien geschützt. Kleine Nutzlasten verwenden einfache Arrays, wenn der schreibende Prozess über aktiven gemeinsamen OPcache-Speicher verfügt und das Ziel nicht ausgeschlossen ist. OPcache kann das kompilierte Array dann bei späteren Includes wiederverwenden; Änderungen an den zurückgegebenen Daten folgen weiterhin dem normalen Copy-on-Write-Verhalten von PHP.
Ohne gemeinsamen OPcache-Speicher bleiben Nutzlasten komprimierte serialisierte Daten. Das gilt auch, wenn OPcache voll ist, sein API nicht verfügbar oder eingeschränkt ist oder seine Blacklist beziehungsweise opcache.max_file_size die Datei ausschließt. Ein reiner Datei-Cache in OPcache wählt nicht das Format mit einfachen Arrays. Informationen zu diesen hostseitigen Einstellungen findest du in der PHP OPcache-Konfiguration.
Das Standardformat mit einfachen Arrays ist auf 1 MiB begrenzt, gemessen sowohl an den serialisierten Daten als auch am erzeugten PHP-Quellcode. Größere Nutzlasten bleiben komprimiert, um die Kompilierung großer Arrays zu vermeiden, wenn ein CLI-Prozess ohne OPcache einen Cache liest, der von Web-Workern gefüllt wurde.
Auch kleine Dateien mit einfachen Arrays müssen bei einem solchen Lesezugriff geparst werden; neu geschriebene Dateien müssen möglicherweise während opcache.file_update_protection kompiliert werden.
Der Filter blockstudio/cache/compress überschreibt das Format je Geltungsbereich, zum Beispiel wenn WP-CLI Cache-Dateien für OPcache-aktivierte Web-Worker füllt. Auch false überschreibt die Größenbegrenzung: Verwende das nur, wenn jeder Lesezugriff die erzeugte PHP-Datei verarbeiten kann. Wenn zlib nicht verfügbar ist, bleiben einfache PHP die Ausweichlösung.
Parallelität und Aufbewahrung
Kalte Cache-Schlüssel verwenden eine Single-Flight-Sperre. Eine Anfrage erstellt die Datenladung, während gleichzeitige Anfragen auf das atomar veröffentlichte Ergebnis warten, statt dieselbe Erkennungs- oder Kompilierungsarbeit zu wiederholen. Die atomare Veröffentlichung verhindert unvollständige Objekte. Schlägt eine Aktualisierung fehl, bleibt ein gültiges, zuletzt erfolgreiches Objekt verfügbar, der Fehler ist sichtbar und die nächste Anfrage kann sich davon erholen.
Laufzeitbereiche bewahren standardmäßig 20 veröffentlichte Datenladungen auf. Passe die Obergrenze pro Bereich an, wenn eine Integration absichtlich mehr Cache-Kontexte erstellt:
add_filter(
'blockstudio/cache/max_files_per_scope',
function (int $maximum, string $scope): int {
return 'runtime' === $scope ? 50 : $maximum;
},
10,
2
);
Bei der Aufbewahrung werden niemals Dateien entfernt, auf die die installierte Early-Serve-Zuordnung verweist. Der Filter blockstudio/cache/protected_paths markiert zusätzliche Pfade, die beim Bereinigen ebenfalls erhalten bleiben müssen.
Nicht verwendete Namespaces werden automatisch bereinigt, statt sich bei jeder Plugin-Aktivierung sowie bei jedem PHP- oder WordPress-Update anzusammeln. Ein Deployment-Snippet, das früher das alte Tailwind-Cache-Verzeichnis per Glob durchsucht hat, sollte stattdessen Blockstudio\Runtime_Cache::purge('tailwind') aufrufen.
Ein Namespace wird stillgelegt, wenn sich die Laufzeitidentität ändert, zum Beispiel nach einem WordPress-Core-Update. Bei der ersten Bereinigung, die ihn als stillgelegt erkennt, wird eine .retired-Markierung darin angelegt. Der Verzeichnisbaum wird entfernt, sobald seitdem cache.namespaceGrace Sekunden (standardmäßig ein Tag) vergangen sind. Wird der Baum zwischenzeitlich erneut beschrieben, beginnt die Schonfrist von vorn. Weder der aktuelle Namespace eines Bereichs noch ein Namespace, aus dem die Early-Serve-Zuordnung noch ein aktiviertes Artefakt ausliefert, wird entfernt. Die Schonfrist für Letzteren beginnt, sobald die nächste Aktivierung seinen Zuordnungseintrag verschiebt. Seiten, die außerhalb von WordPress zwischengespeichert werden, verweisen weiterhin auf die inhaltsgehashten Stylesheets, mit denen sie gerendert wurden. Wenn eine Website tailwind.output: "link"-Seiten über ein CDN oder einen langen Browser-Cache ausliefert, sollte die Schonfrist daher mindestens so lang sein, wie eine solche Kopie bestehen kann:
{
"cache": {
"namespaceGrace": 777600
}
}
Enthält eine aktualisierte Installation das flache cache/runtime-Verzeichnis aus einer Version vor 7.6, benennt Blockstudio es atomar um und entfernt es aus dem aktiven Pfad. Ein WP-Cron-Job löscht anschließend pro Durchlauf höchstens 500 Dateisystemeinträge. So werden alte Datenladungen und .build.lock-Verzeichnisbäume entfernt, ohne dass die Anfrage, die ein großes Verzeichnis erkennt, es rekursiv löschen muss. Die Bereinigung läuft nur, wenn cache.enabled aktiv ist. Ändere die Batchgröße mit blockstudio/cache/legacy_cleanup_batch_size, wenn ein Host kleinere oder größere Durchläufe benötigt.
Deaktiviere die persistenten Caches in blockstudio.json:
{
"cache": {
"enabled": false
}
}
Oder über einen Filter:
add_filter('blockstudio/settings/cache/enabled', '__return_false');
Der im Abschnitt Performance beschriebene In-Memory-Render-Cache pro Anfrage ist bewusst separat. Seine persistenten Artefakte verwenden jedoch dieselbe Dateisystemgrenze.
Einen Rückstand alter Sperren abbauen
Versionen vor 7.6.14 ließen bei jeder Inhaltsänderung eine .build.lock-Datei zurück. Auf einer stark frequentierten Website können sich Hunderttausende davon ansammeln. Nach dem Upgrade entfernt WP-Cron sie automatisch in begrenzten Stapeln. Um den Rückstand sofort abzubauen und deinem Host eine Zahl zu nennen, führe die CLI aus:
wp bs cache status
wp bs cache cleanup
status zählt die verbleibenden alten Sperren und meldet, wann der nächste Stapel ausgeführt wird. cleanup führt Stapel aus, bis keine ungenutzten Sperren mehr vorhanden sind, und bereinigt anschließend Cache-Namespaces, deren Schonfrist abgelaufen ist. Sperren, die jünger als eine Stunde sind oder noch von einer laufenden Anfrage gehalten werden, bleiben bis zum nächsten Durchlauf bestehen. Lösche niemals Sperrdateien von Hand, während die Website Anfragen bedient: Eine gehaltene Sperre sorgt dafür, dass gleichzeitige Anfragen nicht parallel aufbauen.
wp bs cache clear leert den gesamten Laufzeitcache der aktuellen Website oder mit --scope=runtime einen Bereich über alle Namespaces hinweg. Die nächste Anfrage baut den Cache kalt neu auf. Führe den Befehl daher bei geringem Traffic aus.
Tailwind-Cache
Der kompilierte CSS-Cache von Tailwind verwendet das gemeinsame Laufzeit-Stammverzeichnis unter seinem Netzwerk-/Website-/Laufzeit-Namespace und dem Bereich tailwind. Standardmäßig speichert er bis zu 1.000 Einträge für 30 Tage. Das reicht aus, um Seitenschlüssel für eine vollständige Website aufzubewahren, statt sie nach wenigen Routen zu verdrängen.
Tailwind verwendet in langlebigen Prozessen außerdem einen warmen Compiler für dieselbe CSS-Eingabe erneut und speichert den Compiler-Erstellungsstatus prozessübergreifend. Kalte Kandidatenmengen für Seiten werden weiterhin unabhängig kompiliert, müssen aber den Framework-Parser nicht jedes Mal neu aufbauen.
Verwende diese Filter, um die Aufbewahrung zu ändern:
add_filter('blockstudio/tailwind/cache_max_files', function () {
return 1500;
});
add_filter('blockstudio/tailwind/cache_max_age', function () {
return 14 * DAY_IN_SECONDS;
});
Das Mindestalter beträgt eine Stunde.
Cache-Dateien sind inhaltsgehasht und eine zwischengespeicherte Seite verknüpft sie einzeln über URL. Daher können Bereinigung und gespeicherte Seite unterschiedliche Vorstellungen davon haben, welche Dateien noch benötigt werden. Vorgerenderte Dokumente werden vor der Auslieferung anhand ihres verknüpften Stylesheets geprüft. Eine entfernte Datei führt daher zu einem erneuten Rendern statt zu einer ungestylten Seite. Erhöhe cache_max_files über die Anzahl unterschiedlicher Seitenschlüssel hinaus, um das erneute Rendern ganz zu vermeiden.
Der anonyme HTML-Cache, der sich im selben Stammverzeichnis befindet.