sevenx_valkey_cache: Cache-Backend für Redis und Valkey #

Diese Seite ist für Administratoren, die schnellere Seiten möchten oder mehrere Webserver betreiben. sevenx_valkey_cache speichert die Caches von Exponential in Redis oder Valkey statt in Dateien. Es ersetzt den Plattenspeicher für:

• Template-Blöcke {valkey-block ...} (ein Cache-Block, der in Redis oder Valkey liegt);
• den Inhaltsansichts-Cache (Vollansicht von content/view);
• den kompilierten INI-Cache (Arrays von eZINI). Das entfernt die Zugriffe auf var/cache/ini/*.php pro Anfrage und macht INI-Caches clustersicher.

Einträge haben einen Ablauf über TTL, Generierungssperren (kein Cache-Ansturm) und umgekehrte Indizes nach Knoten und Teilbaum, sodass das Veröffentlichen von Inhalten genau die Einträge leert, die es betrifft. Es wurde zuerst am 20. Juli 2026 ausgeliefert (1.0.0); 1.0.1 dokumentierte 6.0.15 als benötigte Plattform.

Anforderungen #

• Exponential 6.0.15 oder neuer, dessen Kernel die Hooks der Extension aufruft (siehe „Was der Kernel tut“).
• Die PHP-Erweiterung redis (oder igbinary).
• Ein erreichbarer Server mit Redis oder Valkey.

Einrichten #

1. Installieren und aktivieren Sie die Extension:

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:

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

4. Prüfen Sie, dass es funktioniert: Rufen Sie eine Seite zweimal auf und listen Sie dann die Schlüssel auf:

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

Schlüssel werden aufgeführt. Mit eingeschaltetem Debug von eZINI sagt ein Hinweis Loading Redis cache '...' for file '...', wenn INI-Daten vom Server kommen.

Einstellungen #

Alle Schlüssel stehen in valkeycache.ini, Block ValkeyCacheSettings; setzen Sie sie in settings/override.

In Templates verwenden #

{valkey-block expiry=3600 subtree_expiry=$node.node_id keys=array( 'my-block', $node.node_id )}
    ... expensive template logic ...
{/valkey-block}

Aus Code: sevenxValkeyCacheBlock::instance() bietet put( $key, $content, $ttl ), get( $key ), purge( $key ) und flush(). Die Klasse sevenxValkeyCacheHandler ist als ContentSettings.StaticCacheHandler registriert und leert bei Inhaltsänderungen die nach den betroffenen Knoten-IDs und ihren Vorfahren indizierten Ansichts- und Blockeinträge.

Alles aus der Shell leeren #

bin/php/ezvalkeycacheclear.php (hinzugefügt am 20. Juli 2026) leert alle Caches über dieselben PHP-Cache-Handler, die die Administrationsoberfläche verwendet, leert die Schlüssel in Redis/Valkey, die die Extension geschrieben hat, und erzeugt die Extension-Autoloads neu, wobei es für jedes Extension-Verzeichnis, das nicht in ActiveExtensions[] steht, --exclude übergibt, sodass abgeschaltete, aber vorhandene Extensions aus var/autoload/ezp_extension.php und aus Prüfungen mit class_exists() verschwinden. Es ist der Rückfall, wenn Alle Caches leeren der Administrationsoberfläche nach dem Entfernen einer Extension oder dem Abschalten eines Cache-Backends nicht aufräumen kann.

Schnellerer INI-Cache (1.0.2, 30. Juli 2026) #

Der kompilierte INI-Cache ist ein Redis-Hash, mit dem MD5 der Datei als Schlüssel (HGET, HSET, HDEL), statt eines Schlüssels pro Datei. Das bisherige Design durchsuchte bei jeder Anfrage den ganzen Schlüsselraum (SCAN und MGET), was auf einem stark belasteten Server teuer ist; der auf die Anfrage begrenzte Cache im Speicher bleibt und wird bei Bedarf gefüllt.

Was der Kernel tut (Hooks) #

Der Kernel ruft die Extension nur auf, wenn ihre Klassen existieren (class_exists() wird zuerst geprüft), sodass eine Website ohne die Extension nichts bezahlt. Hooks, hinzugefügt am 20. Juli 2026 (Commits fa17892025, 6ef123636c, 908994bb03):

Bei einem Fehltreffer oder wenn abgeschaltet, greift der Kernel genau wie bisher auf den Cluster-Datei-Handler und die Dateien zurück.

Grenzen #

• Einträge liegen im Speicher: Bemessen Sie den Server nach der Anzahl der Seiten und Siteaccesses, und setzen Sie eine Verdrängungsrichtlinie.
• Ein Ausfall des Servers wird zu Cache-Fehltreffern; die Extension entscheidet, wie Fehler gemeldet werden.

Verwandte Seiten #

• Leeren von Caches durch Umbenennen
• HTTP-Caching, SQL-Abfrage-Cache
• Changelog 6.0.15, Juli 2026
• Chronik und Versionshinweise
• Änderungsverzeichnis
• Verhaltensänderungen der Extensions
• Monat: 2026-07 (alle Extensions)