Zum Inhalt springen

Statisch, wenn möglich

Prerenderte Seiten und Produktionsstandards, festgelegt in blockstudio.json.

Anonyme Seiten vorab rendern

Statisches Prerendering ist standardmäßig deaktiviert. Aktiviere performance.staticPrerender; dann speichert Blockstudio das vollständige HTML-Dokument, das ein anonymer Besucher erhält, und liefert diese Kopie an den nächsten anonymen Besucher aus.

Anfragen, die dynamisch bleiben müssen, greifen nie darauf zu: Nicht-GET-Anfragen, Query-Strings, Admin-Bereich, REST, Ajax, cron, Feeds, Suche, Vorschauen, Seiten mit Nonce, alle Pfade unter dynamicPaths und angemeldete Besucher, sofern serveLoggedIn nicht aktiviert ist.

blockstudio.json
{
  "performance": {
    "staticPrerender": {
      "enabled": true,
      "ttl": 3600,
      "earlyServe": true,
      "dynamicPaths": ["/account", "/checkout"]
    }
  }
}

Standardmäßig deaktiviert

Es ändert sich nichts, bis blockstudio.json das Feature benennt.

Dynamische Pfade

Ein dynamischer Pfad von /account umfasst /account/orders, aber nicht /accounting.

Opt-out-Markierung

Ein blockstudio:no-cache-Kommentar hält jede Antwort aus dem Cache heraus.

Angemeldete Besucher

Mit serveLoggedIn lesen sie gespeicherte Seiten; ihre eigenen Seiten werden nie gespeichert.

Individuelle Umgehung

Der Filter static_prerender/request_bypass nimmt jede von dir angegebene Anfrage von gespeicherten Seiten aus, etwa eine Anfrage mit einem Warenkorb-Cookie.

Warteschlange zum Aufwärmen

Eine persistente Warteschlange rendert veraltete Seiten in dem von dir festgelegten Intervall neu.

Routen mit geringem Aufkommen

Auch Routen außerhalb der ausgelieferten Karte werden früh ausgeliefert, sobald WordPress sie gerendert und gespeichert hat.

Stylesheet-Prüfung

Wenn das verknüpfte Tailwind-Stylesheet einer gespeicherten Seite fehlt, wird die Seite neu gerendert und niemals ohne Styles ausgeliefert.

Wird ausgeliefert, bevor WordPress startet

Wenn earlyServe aktiviert ist, installiert Blockstudio ein advanced-cache.php-Drop-in, das eine gespeicherte Seite ausliefert, bevor WordPress, Plugins oder das Theme geladen werden. Es überschreibt niemals ein Drop-in, eine Routenübersicht oder eine WP_CACHE-Zeile, die es nicht selbst geschrieben hat.

Diese Website verwendet es. Am 8. Oktober 2026 wurden blockstudio.dev-Seiten mit x-blockstudio-static-prerender: HIT-EARLY beantwortet, dem Header, den das Drop-in sendet.

Terminal
# Identity, files, queue, and hit/miss counters
wp bs prerender status

# Re-render stale entries now
wp bs prerender warm

# Dead or orphaned early-serve map entries
wp bs prerender map status
wp bs prerender map prune --dry-run

# Remove the drop-in and map this install owns
wp bs teardown

Nach jeder Änderung aktuell

Der standardmäßige signature-Modus füllt den Cache bei einem anonymen Cache-Miss und erneuert ihn nach Änderungen auf Website-Ebene. Beim Speichern oder Löschen eines Beitrags werden dieser Beitrag und die Startseite geleert oder zur erneuten Generierung vorgemerkt, wenn das Aufwärmen aktiviert ist.

Der graph-Modus ist für Deployment-Tools gedacht. Er erfasst, welche Dateien jede Seite gelesen hat. Beim Build werden dadurch nur die Routen neu gerendert, deren Dateien sich geändert haben; anschließend wird der neue Satz als ein Artefakt aktiviert. Schlägt die Validierung einer referenzierten Datei fehl, bleibt das vorherige Artefakt live.

Bei der Installation eines Artefakts werden Bytes verglichen und geänderte Dokumente atomar ausgetauscht. last_promotion() meldet, wie viele Routen übernommen, ersetzt, übersprungen oder beibehalten wurden. So kann ein Deployment dies protokollieren und mit der aktiven Build-ID abgleichen.

deploy.php
use Blockstudio\Static_Prerender_Runtime;

$plan = Static_Prerender_Runtime::build_plan($sourceUrls);

foreach ($plan['affectedUrls'] as $url) {
  $result = render_with_dependencies($url);

  Static_Prerender_Runtime::persist_built_response(
    $url,
    $result['html'],
    $result['files'],
    $result['virtualHashes']
  );
}

Static_Prerender_Runtime::garbage_collect(array_keys($plan['live']));

Hinter einem CDN

Der Prerender-Header gibt bereits an, welche Antworten sicher geteilt werden können. Ordne HIT und HIT-EARLY einer Cache-Control-Lebensdauer am Origin zu, cache nur Antworten, die eine solche Angabe enthalten, und umgehe den Edge-Cache für die Cookies wordpress_logged_in_, wp-postpass_ und comment_author_email_ sowie für dein dynamicPaths, wp-admin und wp-json.

Am Edge gecachte Seiten verweisen weiterhin auf das gehashte Stylesheet, mit dem sie gerendert wurden. Erhöhe cache.namespaceGrace auf die längste mögliche Lebensdauer einer solchen Kopie. Ausgemusterte Stylesheets bleiben so lange auf der Festplatte, bis dieser Zeitraum abläuft.

nginx.conf
map $upstream_http_x_blockstudio_static_prerender $edge_cache_control {
  "~^HIT"  "public, s-maxage=604800";
  default  "";
}

location ~ \.php$ {
  include fastcgi_params;
  fastcgi_pass unix:/run/php/php-fpm.sock;
  add_header Cache-Control $edge_cache_control;
}

Ein aktiver Block auf einer gecachten Seite

Setze blockstudio.island auf dynamic, damit die gecachte Seite anstelle des Blocks einen Platzhalter enthält. Der Browser sammelt alle dynamischen Inseln auf der Seite und ruft ihre Fragmente in einer einzigen gebündelten Anfrage ab. Jedes Fragment wird mit dem Blocknamen und seinen zulässigen Attributen signiert.

hydrate behält das vollständige HTML auf der Seite und sendet nur ein Mount-Ereignis. Dynamische Inseln können warten, bis sie sichtbar sind, sich bei einem Fensterereignis aktualisieren und Fragmente pro Benutzer oder global cachen.

block.json
{
  "name": "acme/cart-count",
  "title": "Cart count",
  "blockstudio": {
    "island": {
      "mode": "dynamic",
      "attributes": ["productId"],
      "loading": "visible",
      "event": "cart:updated",
      "cache": {
        "ttl": 60,
        "per": "user"
      }
    }
  }
}

Sieh, wofür die Renderzeit draufgeht

Füge ?blockstudio-perf zu einem beliebigen Frontend-URL hinzu. Ein Panel zeigt die Renderzeiten pro Block, die Anzahl der Aufrufe sowie die Phasen für Transformation, Template und Komponente an. Dieselben Zeitangaben werden als Server-Timing-Header ausgegeben; das funktioniert auch, wenn ein CDN das HTML cached.

Nur angemeldete Benutzer mit edit_posts sehen die Ausgabe. Bei allen anderen Anfragen wird der Profiler auf init deaktiviert. performance.measurement ergänzt Profil- und Konfigurations-Hash-Header sowie ein Performance_Measurement::snapshot() API.

blockstudio.json
{
  "dev": {
    "perf": true
  },
  "performance": {
    "measurement": {
      "enabled": true,
      "headers": true,
      "timings": true
    }
  }
}

Ein Schalter für Produktionsstandards

Wenn performance.profile auf speed gesetzt ist, werden Generator-, Emoji-, Feed- und Discovery-Ausgaben aus dem Head entfernt, die oEmbed-Erkennung entfernt, XML-RPC und Pingbacks deaktiviert, allgemeine Core-Frontend-Assets entfernt, Heartbeat außerhalb von Editoren gedrosselt und Links derselben Domain bei Hover oder Fokus vorgeladen.

Der Standardwert ist compat und ändert nichts. Jeder untergeordnete Wert überschreibt das Profil, sodass du ein Verhalten beibehalten und den Rest übernehmen kannst.

blockstudio.json
{
  "performance": {
    "profile": "speed",
    "preload": {
      "links": "off"
    }
  }
}

Bilder, die ihren Platz behalten

Theme-Bilder liegen außerhalb der Mediathek, daher kennt WordPress ihre Größe nicht. bs_media_image() liest die tatsächlichen Abmessungen aus einem generierten assets/media.json und reserviert das Seitenverhältnis, bevor die Datei geladen wird.

Aktiviere performance.media.lazy, und das echte URL bleibt hinter einem Platzhalter mit den richtigen Abmessungen, bis sich das Bild dem Ansichtsbereich nähert.

index.php
<?php
echo bs_media_image([
  'src' => 'assets/images/hero.webp',
  'alt' => 'Hero',
  'eager' => true,
]);

Ein Cache-Verzeichnis

Jede generierte Datei liegt unter cache.path und wird anhand einer Laufzeitidentität zugeordnet.

Builds mit Einzelflug

Eine Anfrage erstellt einen noch nicht im Cache vorhandenen Schlüssel. Andere warten, verwenden die letzte erfolgreiche Nutzlast erneut oder erhalten ein 503 mit Retry-After.

OPcache-freundliche Nutzlasten

Kleine Cache-Nutzlasten sind einfache PHP-Arrays, die OPcache aus dem gemeinsamen Speicher wiederverwenden kann. Größere bleiben komprimiert.

Render-Cache

Ein selbstschließender Block-Tag mit denselben Attributen wird pro Anfrage einmal gerendert. Wiederholungen kommen aus dem Arbeitsspeicher.

Gebündelte Aktualisierung von Auswahloptionen

Eine Reihe von Inhaltsänderungen, etwa durch einen Import, löst eine einzige Aktualisierung der gecachten, vorausgefüllten Feldauswahloptionen aus.

Mandantenfähige Caches

Nutze den Filter cache/site_key für die Abgrenzung deiner Mandanten und cache/context für Laufzeitvarianten derselben Website.

Kompilierte Assets im Cache

Wenn assets.output auf cache gesetzt ist, verlassen kompilierte Assets den Blockbaum, sodass du aus einem unveränderlichen Checkout deployen kannst.

Gebündelte Builds

Static_Prerender_Batch_Renderer teilt einen Build in stabile N/TOTAL-Shards auf. Ein Aufrufer kann dieselbe Aufteilung berechnen.

Kleine Stylesheets inline einfügen

assets.inlineLimit gibt die kleinsten Block-Stylesheets innerhalb eines Byte-Limits inline aus, und zwar in derselben Kaskadenreihenfolge.

Block-CSS zuletzt im Head

Block-CSS wird direkt vor dem schließenden Head-Tag eingefügt, nach den Stylesheets des Themes und der Plugins.

Nicht verwendete Assets überspringen

Ein Template, das nichts zurückgibt, bindet keine Assets ein. Mit assets.enqueue false überlässt du dir die Verwaltung aller Assets.

Cache-Befehle

wp bs cache status, cleanup und clear prüfen, leeren und löschen den Laufzeit-Cache. wp bs prerender purge entfernt gespeicherte Seiten.

Sauberes Entfernen

wp bs teardown entfernt nur den Zustand, der dieser Installation gehört.

Hooks für Ergebnisse

cache/outcome und static_prerender/outcome melden Treffer, Builds, Fehlschläge und Fehler an deine Metriken.

Fehler-Hooks

error/logged und error/exception leiten Blockstudio-Fehler an einen externen Logger oder Tracker weiter.

Stapelverarbeitung beim Rendern

Batch_Render::reset() setzt den Anfragezustand zwischen Dokumenten in einem Prozess zurück. render/dependencies listet die Dateien jedes Blocks auf.

Plus

Das offizielle Erweiterungspaket

Premium-Websitevorlagen, KI-Systemanweisungen und eine private Discord-Community. Einmaliger Kauf, Updates auf Lebenszeit.

  • 500+ Website-Vorlagen
  • KI-Systemanweisungen
  • Updates auf Lebenszeit
  • Private Discord-Community