Erste Schritte

Systemvoraussetzungen

FG Cache WP 1.0.0 setzt WordPress 6.0 oder neuer und PHP 8.1 oder neuer voraus.

Für den Page Cache muss WordPress das Drop-in wp-content/advanced-cache.php laden können. Dafür ist WP_CACHE erforderlich. FG Cache WP versucht bei der Aktivierung, die benötigte Zeile automatisch in wp-config.php einzutragen, sofern keine ausdrückliche gegenteilige Definition vorhanden ist und die Datei beschreibbar ist.

Das Plugin benötigt außerdem Schreibzugriff für:

• wp-content/advanced-cache.php
• wp-content/cache/fg-cache/
• gegebenenfalls wp-config.php zur automatischen Aktivierung von WP_CACHE
• gegebenenfalls .htaccess, wenn der optionale Browser-Cache-Fallback auf Apache oder LiteSpeed verwendet wird

Installation

1. Das Plugin-Verzeichnis fg-cache-wp nach wp-content/plugins/ installieren oder das Plugin als ZIP über WordPress hochladen.
2. FG Cache WP in der WordPress-Administration aktivieren.
3. Die FUNCKGROUP-Seite FG Cache → Diagnose öffnen.
4. Prüfen, ob advanced-cache.php als aktuelles FG-Cache-Drop-in erkannt wird.
5. Prüfen, ob WP_CACHE aktiv ist.
6. Prüfen, ob die Runtime-Konfiguration lesbar und das Cache-Verzeichnis beschreibbar ist.

Was passiert bei der Aktivierung?

FG Cache WP führt bei der Aktivierung folgende Schritte aus:

1. Standard-Einstellungen werden angelegt, falls noch keine Einstellungen existieren.
2. Das Schema der Plugin-Einstellungen wird auf den aktuellen Stand gesetzt.
3. wp-content/cache/fg-cache/ und das Unterverzeichnis pages/ werden angelegt.
4. Die Plugin-Vorlage für advanced-cache.php wird nach wp-content/advanced-cache.php kopiert, sofern dort kein fremdes Drop-in liegt.
5. WP_CACHE wird geprüft und bei Bedarf mit einer eindeutig markierten FG-Cache-Zeile in wp-config.php aktiviert.
6. Die frühe Runtime-Konfiguration wird erzeugt.
7. Der optionale Browser-Cache-Fallback wird synchronisiert.

Ein bereits vorhandenes fremdes advanced-cache.php wird nicht überschrieben.

Erste Konfiguration

Die Standardwerte sind bereits auf einen konservativen Betrieb ausgelegt. Für eine erste Prüfung genügt normalerweise:

1. Page Cache aktivieren eingeschaltet lassen.
2. Die Standard-TTL von 3.600 Sekunden beibehalten.
3. Diagnose-Header aktiviert lassen.
4. HTTP Basic Auth nur bei einem konkreten Bedarf für das Caching freigeben.
5. Eigene dynamische Pfade, Cookies oder Query-Parameter als BYPASS ergänzen.
6. Den automatischen Warmup erst aktivieren, wenn der normale Cache-Betrieb geprüft wurde.

Alle Einstellungen sind unter Konfiguration beschrieben.

Funktion nach der Installation prüfen

Eine öffentliche, nicht eingeloggte Seite zweimal aufrufen und die Response-Header prüfen.

Beim ersten cachefähigen Aufruf sollte typischerweise erscheinen:

X-FG-Cache: MISS

Bei einem folgenden Aufruf innerhalb der TTL sollte erscheinen:

X-FG-Cache: HIT
X-FG-Cache-Age: 12

Der genaue Wert von X-FG-Cache-Age entspricht dem Alter der Cache-Datei in Sekunden.

Erscheint stattdessen ein BYPASS, enthält der Header bei aktivierten Diagnose-Headern zusätzlich einen Grund, beispielsweise method, cookie oder query-bypass.

Cache manuell leeren

Der vollständige Page Cache kann über zwei Stellen geleert werden:

• FG Cache → Übersicht → FG Cache leeren
• FG Cache leeren in der WordPress-Admin-Bar für Benutzer mit manage_options

Weitere Informationen zur Invalidierung enthält Cache-Invalidierung.

Deaktivierung

Bei der Deaktivierung:

• wird ein laufender automatischer Warmup abgebrochen,
• wird das eigene advanced-cache.php entfernt,
• wird eine von FG Cache selbst gesetzte WP_CACHE-Zeile entfernt, sofern kein fremdes Drop-in vorhanden ist,
• wird der eigene .htaccess-Marker für den Browser-Cache-Fallback entfernt,
• werden Runtime-Konfiguration und Page-Cache-Dateien entfernt.

Gespeicherte Plugin-Einstellungen bleiben bei einer normalen Deaktivierung bestehen.

Deinstallation

Bei einer WordPress-Deinstallation des Plugins werden zusätzlich entfernt:

• fg_cache_settings
• fg_cache_settings_schema
• Statusoptionen des automatischen FG-Cache-Warmups
• Transients mit dem Präfix fg_cache_
• das eigene advanced-cache.php, sofern es anhand des Markers als FG-Cache-Datei erkannt wird
• eine von FG Cache selbst markierte WP_CACHE-Zeile, sofern kein fremdes Drop-in geschützt werden muss
• ein vollständiger eigener .htaccess-Markerblock
• wp-content/cache/fg-cache/ einschließlich Cache-Dateien und Metadaten

Gemeinsam vom eingebetteten FG Core verwendete Status-Reporting-Optionen werden durch uninstall.php von FG Cache WP nicht entfernt. Details stehen unter Datenverarbeitung.