Valkey und Redis #

Diese Seite ist für Hosting-Anbieter, die Redis oder Valkey betreiben und es Exponential-Websites anbieten möchten, für Geschwindigkeit oder für Websites, die von mehreren Web-Knoten ausgeliefert werden. Sie beantwortet: was die Erweiterung sevenx_valkey_cache in Redis oder Valkey verlegt, wie Sie sie einrichten, wie sich mehrere Kunden einen Server teilen können, ohne die Schlüssel der anderen zu sehen, und wo die Grenzen liegen. Die Quelle ist sevenx_valkey_cache: Cache-Backend für Redis und Valkey.

Inhalt #

1. Was sie speichert
2. Anforderungen
3. Sie einrichten
4. Einstellungen
5. Mehrere Kunden auf einem Server
6. Leeren
7. Was sie nicht abdeckt
8. Checkliste

Was sie speichert #

Die Erweiterung ersetzt den Festplattenspeicher für:

• Template-Blöcke {valkey-block ...};
• den Content-View-Cache (Vollansicht von content/view);
• den kompilierten INI-Cache, was die Zugriffe pro Anfrage auf var/cache/ini/*.php entfernt und INI-Caches für Cluster sicher macht.

Einträge laufen über eine TTL ab, haben Sperren für die Erzeugung gegen Cache-Stampedes und umgekehrte Indizes für Knoten und Teilbäume, sodass das Veröffentlichen von Inhalten genau die Einträge leert, die es betrifft. Der Kernel ruft die Erweiterung nur auf, wenn ihre Klassen existieren; eine Website ohne sie zahlt also nichts; bei einem Fehlschlag oder wenn ausgeschaltet greift der Kernel wie bisher auf die Dateien zurück.

Anforderungen #

• Exponential 6.0.15 oder später (sein Kernel ruft die Hooks der Erweiterung auf).
• Die PHP-Erweiterung redis, in jedem PHP, das die Website ausliefert (der PHP-FPM-Pool oder das PHP von Velocity), und im PHP der Kommandozeile, das Cronjobs und das Leeren von Caches ausführt.
• Ein erreichbarer Server für Redis oder Valkey.

Sie einrichten #

1. Installieren und aktivieren Sie die Erweiterung:

   composer require se7enxweb/sevenx_valkey_cache

   # settings/override/site.ini.append.php
   [ExtensionSettings]
   ActiveExtensions[]=sevenx_valkey_cache

2. Konfigurieren Sie die Verbindung in settings/override/valkeycache.ini.append.php:

   [ValkeyCacheSettings]
   Host=127.0.0.1
   Port=6379
   Database=0
   KeyPrefix=sevenx_valkey_cache:
   InstallationHash=auto
   DefaultTTL=3600
   LockTTL=30
   Persistent=disabled
   LocalCache=enabled
   IniCache=enabled

3. Erzeugen Sie die Autoloads neu und leeren Sie die Caches (und starten Sie Velocity neu, wenn er die Website ausliefert):

   php bin/php/ezpgenerateautoloads.php -e
   php bin/php/ezcache.php --clear-all --allow-root-user

4. Prüfen: Fragen Sie eine Seite zweimal an, und listen Sie dann die Schlüssel auf:

   redis-cli --scan --pattern 'sevenx_valkey_cache:*'

Einstellungen #

Alle in valkeycache.ini, Block [ValkeyCacheSettings]:

Der Eintrag des Content-View-Caches wird für 3600 Sekunden gespeichert, ein Wert, der in kernel/private/classes/views/content/view.php gesetzt ist, nicht in einer INI-Datei.

Mehrere Kunden auf einem Server #

Der eigene Rat der Erweiterung ist ein eindeutiges KeyPrefix pro Installation. Für einen Hoster:

Warnung Ein geteilter Server für Redis oder Valkey ist geteilter Speicher: Jede Website darauf kann jeden Schlüssel lesen, sofern die eigene Zugriffskontrolle des Servers es nicht verhindert. Behandeln Sie ihn in Ihrem Konzept zur Abschottung wie einen geteilten Datenbankserver (Trennung von Mandanten), und lesen Sie in der Dokumentation von Redis oder Valkey zu ihrer Zugriffskontrolle nach.

Dimensionieren Sie den Server für die Anzahl der Seiten und Siteaccesses und setzen Sie eine Verdrängungsrichtlinie; ein Ausfall des Servers wird zu Cache-Fehlschlägen; die Erweiterung entscheidet, wie Fehler gemeldet werden.

Leeren #

• Das Leeren des INI-Caches löscht die INI-Einträge; das Veröffentlichen leert die Einträge für Ansichten und Blöcke der betroffenen Knoten und ihrer Vorfahren.
• Die Seite der Erweiterung nennt bin/php/ezvalkeycacheclear.php (hinzugefügt am 20. Juli 2026), das alle Caches über dieselben Handler leert, die die Administration nutzt, die Schlüssel entfernt, die die Erweiterung geschrieben hat, und die Autoloads der Erweiterungen neu erzeugt. Es ist der Rückfall, wenn Den kompletten Cache leeren nach dem Entfernen einer Erweiterung oder dem Ausschalten eines Cache-Backends nicht aufräumen kann.

Was sie nicht abdeckt #

settings/file.ini erwähnt, dass eine Cache-Schicht wie Memcached oder Redis im Cluster-Backend hinzugefügt werden kann; das ist ein getrenntes Thema des Clusterings (Clustering und gemeinsamer Speicher).

Checkliste #

• To do: PHP-Erweiterung redis im Web-PHP und im PHP der Kommandozeile.
• To do: Eindeutiges KeyPrefix pro Installation; InstallationHash entschieden.
• To do: Server dimensioniert, Verdrängungsrichtlinie gesetzt, Zugriffskontrolle zwischen Kunden bedacht.
• To do: Schlüssel erscheinen nach zwei Seitenaufrufen; das Verhalten bei angehaltenem Server für Redis oder Valkey auf Staging getestet.
• To do: Der Support kennt ezvalkeycacheclear.php.

Verwandte Seiten #

• Cache-Schichten
• Mehrere Web-Knoten
• Caches leeren und vorwärmen
• sevenx_valkey_cache
• Freie Dokumentation: Diese Seite darf unter der GNU FDL 1.3 frei kopiert, übersetzt und verbessert werden.