Warum Ihr FastCGI-Cache in Nginx mit WordPress nicht funktioniert – und wie Sie es beheben

WordPress ist eine fantastische Plattform, die jedoch für ihre Ressourcenintensität bekannt ist. Um die Ladezeiten zu beschleunigen und die Serverlast zu reduzieren, setzen viele auf das Caching. Eine beliebte Methode ist die Verwendung von FastCGI-Cache in Verbindung mit Nginx. Aber was tun, wenn dieser Cache scheinbar nicht funktioniert? Keine Panik! Dieser Artikel führt Sie durch die häufigsten Ursachen und liefert detaillierte Lösungen.

Was ist FastCGI-Cache und warum ist er wichtig für WordPress?

Bevor wir uns den Problemlösungen zuwenden, ist es wichtig zu verstehen, was FastCGI-Cache ist und warum er für WordPress so nützlich ist. Im Wesentlichen fungiert FastCGI-Cache als eine Art Zwischenspeicher für dynamische Inhalte, die von PHP erzeugt werden (in diesem Fall von WordPress). Normalerweise würde jede Anfrage an Ihre WordPress-Seite den PHP-Interpreter (in der Regel PHP-FPM) auslösen, der die WordPress-Dateien lädt, die Datenbank abfragt und die Seite dynamisch generiert. Dieser Prozess ist zeitaufwändig und beansprucht Serverressourcen.

Der FastCGI-Cache speichert die generierten Ergebnisse (also die fertige HTML-Seite) im Cache. Wenn ein Besucher die gleiche Seite erneut aufruft, liefert Nginx die gecachte Version direkt aus dem Speicher, ohne PHP bemühen zu müssen. Das Ergebnis: deutlich schnellere Ladezeiten, weniger Serverlast und eine bessere Benutzererfahrung. Dies ist besonders wichtig für Websites mit viel Traffic.

Häufige Gründe, warum Ihr FastCGI-Cache nicht funktioniert

Es gibt verschiedene Gründe, warum Ihr FastCGI-Cache in Nginx mit WordPress möglicherweise nicht richtig funktioniert. Hier sind die häufigsten Verdächtigen:

• Falsche Nginx-Konfiguration: Dies ist der häufigste Grund. Fehler in Ihrer Nginx-Konfigurationsdatei (normalerweise `nginx.conf` oder eine separate Konfigurationsdatei für Ihre Website) können den Cache deaktivieren oder ihn ineffizient machen.
• Fehlende oder falsche Cache-Regeln: Die Konfiguration muss explizit angeben, welche Arten von Anfragen gecacht werden sollen und wie lange.
• Probleme mit den Header-Informationen: Bestimmte HTTP-Header können verhindern, dass Nginx eine Seite im Cache speichert.
• Dynamische Inhalte und Cookies: Seiten, die dynamische Inhalte enthalten oder Cookies setzen, werden standardmäßig nicht gecacht.
• WordPress-Plugins, die den Cache beeinflussen: Einige WordPress-Plugins können den Caching-Mechanismus stören.
• PHP-FPM-Einstellungen: Falsche PHP-FPM-Konfiguration kann die Interaktion mit dem Cache beeinträchtigen.
• Cache-Berechtigungen: Nginx benötigt die richtigen Berechtigungen, um auf das Cache-Verzeichnis zuzugreifen und Daten zu schreiben.

So beheben Sie Probleme mit dem FastCGI-Cache

Nachdem wir die möglichen Ursachen identifiziert haben, können wir uns nun der Fehlersuche widmen. Hier sind die Schritte, die Sie unternehmen können, um den FastCGI-Cache in Nginx mit WordPress zum Laufen zu bringen:

1. Überprüfen Sie Ihre Nginx-Konfiguration

Beginnen Sie mit der Überprüfung Ihrer Nginx-Konfigurationsdatei. Suchen Sie nach den relevanten Abschnitten, die den FastCGI-Cache definieren. Achten Sie besonders auf die folgenden Direktiven:

• `fastcgi_cache_path`: Definiert den Pfad zum Cache-Verzeichnis, die Cache-Ebenen, die Schlüsselzonengröße und die Inaktivitätszeit (`inactive`). Beispiel:

  fastcgi_cache_path /var/run/nginx-cache levels=1:2 keys_zone=WORDPRESS:100m inactive=60m;

  • `levels=1:2` definiert eine zweistufige Verzeichnisstruktur, um zu viele Dateien in einem einzigen Verzeichnis zu vermeiden.
  • `keys_zone=WORDPRESS:100m` reserviert 100 MB Speicher für die Speicherung der Cache-Schlüssel. Passen Sie die Größe an Ihren Bedarf an.
  • `inactive=60m` bedeutet, dass Einträge, die 60 Minuten lang nicht aufgerufen wurden, aus dem Cache entfernt werden.
• `fastcgi_cache_key`: Definiert, wie der Cache-Schlüssel generiert wird. Normalerweise wird er auf `$scheme$request_method$host$request_uri` gesetzt.
• `fastcgi_cache`: Aktiviert den Cache für eine bestimmte Location. Beispiel: `fastcgi_cache WORDPRESS;`
• `fastcgi_cache_valid`: Definiert, wie lange verschiedene Response-Codes im Cache gespeichert werden sollen. Beispiel:

  fastcgi_cache_valid 200 301 302 60m;
      fastcgi_cache_valid any 10m;

• `fastcgi_pass`: Gibt den Socket an, an dem PHP-FPM erreichbar ist. Beispiel: `fastcgi_pass unix:/run/php/php7.4-fpm.sock;` (Passen Sie die PHP-Version an!)
• `fastcgi_pass_request_headers`: Sollte aktiviert sein, um sicherzustellen, dass alle HTTP-Header an PHP-FPM weitergeleitet werden.

Ein typischer Nginx-Konfigurationsblock für WordPress mit FastCGI-Cache könnte so aussehen:

location / {
    try_files $uri $uri/ /index.php?$args;
}

location ~ .php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_cache_bypass $skip_cache;
    fastcgi_no_cache $skip_cache;
    fastcgi_cache WORDPRESS;
    fastcgi_cache_valid 200 301 302 60m;
    fastcgi_cache_valid any 5m;
    fastcgi_cache_key "$scheme$request_method$host$request_uri";
    fastcgi_cache_lock on;
    fastcgi_cache_lock_timeout 5s;
    fastcgi_cache_use_stale updating;
    fastcgi_pass unix:/run/php/php7.4-fpm.sock;
}

Achten Sie auf Tippfehler, fehlende Semikolons oder falsche Pfade. Verwenden Sie `nginx -t` um die Konfiguration auf Syntaxfehler zu prüfen.

2. Definieren Sie Ausnahmen für dynamische Inhalte

Seiten, die dynamische Inhalte enthalten (z. B. Warenkörbe, Benutzerkonten) oder Cookies setzen, sollten nicht gecacht werden. Definieren Sie Variablen, die diese Fälle erkennen und den Cache umgehen. Ein Beispiel:

set $skip_cache 0;
if ($request_method = POST) {
    set $skip_cache 1;
}
if ($query_string != "") {
    set $skip_cache 1;
}
if ($request_uri ~* "/wp-admin/|/xmlrpc.php|wp-.*.php|/feed/|index.php|sitemap(_index)?.xml") {
    set $skip_cache 1;
}
if ($http_cookie ~* "comment_author|wordpress_[a-f0-9]+|wp-postpass|wordpress_logged_in") {
    set $skip_cache 1;
}

Diese Regeln umgehen den Cache für POST-Anfragen, Anfragen mit Query-Strings, bestimmte WordPress-URLs (Admin-Bereich, XML-RPC, Feeds, etc.) und Benutzer, die angemeldet sind oder Kommentare hinterlassen haben.

3. Überprüfen Sie die Response-Header

Manchmal senden PHP oder WordPress Response-Header, die den Cache deaktivieren. Überprüfen Sie die Header mit den Entwicklertools Ihres Browsers oder mit einem Tool wie `curl -I yourdomain.com`. Achten Sie auf:

• `Cache-Control: no-cache` oder `Cache-Control: private`: Diese Header verhindern das Caching.
• `Expires: [Datum]`: Ein Datum in der Vergangenheit kann ebenfalls das Caching verhindern.
• `Set-Cookie`: Das Setzen eines Cookies kann dazu führen, dass die Seite nicht gecacht wird, es sei denn, es werden entsprechende Ausnahmen definiert (siehe oben).

Sie können diese Header in Ihrer Nginx-Konfiguration überschreiben oder mit WordPress-Plugins anpassen.

4. WordPress-Plugins, die Caching stören

Einige WordPress-Plugins, insbesondere solche, die mit Sicherheit, Optimierung oder Benutzerverwaltung zu tun haben, können den FastCGI-Cache beeinträchtigen. Deaktivieren Sie verdächtige Plugins testweise, um festzustellen, ob sie das Problem verursachen. Stellen Sie sicher, dass Ihre Caching-Plugins (falls Sie diese verwenden) mit FastCGI-Cache kompatibel sind.

5. PHP-FPM-Einstellungen

Überprüfen Sie Ihre PHP-FPM-Einstellungen (normalerweise in `/etc/php/[PHP-Version]/fpm/php.ini` und `/etc/php/[PHP-Version]/fpm/pool.d/www.conf`). Stellen Sie sicher, dass die Einstellungen für `opcache` korrekt konfiguriert sind. Obwohl `opcache` kein direkter Ersatz für FastCGI-Cache ist, arbeitet es Hand in Hand, um die PHP-Performance zu optimieren. Stellen Sie sicher, dass `opcache.enable` auf `1` gesetzt ist und dass genügend Speicher zugewiesen ist (`opcache.memory_consumption`).

6. Cache-Berechtigungen

Stellen Sie sicher, dass der Nginx-Benutzer (normalerweise `www-data` oder `nginx`) die Berechtigung hat, auf das Cache-Verzeichnis zu schreiben. Überprüfen Sie die Berechtigungen mit `ls -l /path/to/your/cache/directory` und ändern Sie sie gegebenenfalls mit `chown -R www-data:www-data /path/to/your/cache/directory`.

7. Testen Sie Ihren Cache

Nachdem Sie die obigen Schritte ausgeführt haben, ist es wichtig, zu überprüfen, ob der FastCGI-Cache tatsächlich funktioniert. Es gibt mehrere Möglichkeiten:

• Überprüfen Sie die Response-Header: Nach dem Aktivieren des Caches sollten Sie den Header `X-Cache: HIT` oder `X-Cache: MISS` (wenn die Seite noch nicht gecacht wurde) in den Response-Headern sehen.
• Verwenden Sie ein Geschwindigkeitstest-Tool: Tools wie Google PageSpeed Insights oder GTmetrix können Ihnen helfen, die Ladezeiten Ihrer Website zu messen und festzustellen, ob der Cache die Performance verbessert.
• Überwachen Sie die Serverlast: Beobachten Sie die CPU- und Speicherauslastung Ihres Servers, um zu sehen, ob der Cache die Last reduziert.

Fazit

Die Einrichtung und Wartung eines funktionierenden FastCGI-Cache für WordPress mit Nginx kann etwas knifflig sein, aber die Vorteile in Bezug auf Geschwindigkeit und Serverleistung sind es wert. Wenn Sie die oben genannten Schritte sorgfältig befolgen und die Konfiguration auf Fehler überprüfen, sollten Sie in der Lage sein, die meisten Probleme zu beheben und einen schnellen und effizienten WordPress-Server zu genießen.