Redis-Cache-Verwaltung & -Überwachung: Einrichtung und Hilfe

Öffnen Sie im Backoffice Module > "Module Manager", wählen Sie "Upload a module" und laden Sie die ZIP-Datei des Moduls hoch. Installieren Sie es und klicken Sie anschließend auf Konfigurieren. Verwenden Sie bei älteren PrestaShop-Versionen die entsprechende Modulseite.

Ihr Hosting muss Redis und die PHP-Redis-Erweiterung für die Web-PHP-Laufzeit bereits bereitstellen. Das Modul verwaltet eine Verbindung, eine Übersicht und einen Schlüsselbrowser. Es installiert Redis nicht und konfiguriert nicht das Cache-Backend Ihres Frontoffice.

Im Backoffice heißt das Modul Redis-Übersicht und Schlüsselverwaltung. Öffnen Sie seine Seite Konfiguration. Beginnen Sie unter Verbindung. Geben Sie Redis-Host, Port, optionales Passwort, Datenbank und ein exklusives Schlüsselpräfix ein. Verwenden Sie bei Docker den Redis-Dienstnamen, wenn 127.0.0.1 auf den PHP-Container selbst verweisen würde.

Prüfen Sie vor dem ersten Speichern Zwischenspeicherung > Cache beim Speichern der Konfiguration leeren, dessen Standardwert Ja ist. Schalten Sie es aus, wenn Sie nur die Verbindung testen möchten. Speichern Sie und prüfen Sie dann das Verbindungsergebnis.

Die Tabs heißen Verbindung, Zwischenspeicherung und Überwachung. Verbindung enthält den Hauptschalter und die Redis-Daten. Zwischenspeicherung enthält die drei gespeicherten Cache-Einstellungen und das Leeren beim Speichern. Überwachung steuert die Übersichtsstatistiken und die automatische Aktualisierung.

• Modul aktivieren. Schaltet die Verbindung der Redis-Übersicht und des Schlüsselbrowsers ein oder aus; Standard: 1. Stellen Sie dies im Tab Verbindung ein.
• Redis-Host. Legt den Redis-Hostnamen oder die IP-Adresse fest; Standard: 127.0.0.1. Verwenden Sie bei Docker-Hosting den Redis-Container- oder Dienstnamen.
• Redis-Port. Legt den Redis-TCP-Port fest; Standard: 6379.
• Redis-Passwort. Legt das Passwort für die Redis-Authentifizierung fest; Standard: leer. Ein leeres Geheimnisfeld behält das gespeicherte Passwort bei. Entfernen Sie es über die Löschfunktion des Geheimnisfelds, wenn Redis keine Authentifizierung mehr verlangt.
• Redis-Datenbankindex. Wählt die Redis-Datenbanknummer; Standard: 0. Verwenden Sie nur dann eine andere Nummer, wenn Ihr Hoster sie zugewiesen hat.
• Schlüsselpräfix. Beschränkt Browsersuchen und präfixbezogenes Leeren auf Schlüssel, die mit diesem Präfix beginnen; Standard: ps_.
• Objektcache aktivieren. Speichert die Moduleinstellung zur Nutzung von Redis als Backend des PrestaShop-Objektcaches; Standard: 0. Das Modul speichert diese Einstellung, schreibt aber selbst keine PrestaShop-Server-Cachedateien um.
• Sitzungsspeicherung aktivieren. Speichert die Moduleinstellung zur Ablage von PHP-Sitzungen in Redis; Standard: 0. Die Sitzungsverarbeitung auf Server-/PHP-Ebene muss weiterhin Ihr Hoster oder Entwickler konfigurieren.
• Ganzseitencache aktivieren. Speichert die Moduleinstellung zur Ganzseitenspeicherung für Gäste; Standard: 0. Dieses Modul fügt selbst keine Seiten-Cache-Schicht im Frontoffice hinzu.
• Cache beim Speichern der Konfiguration leeren. Löscht nach erfolgreichem Speichern der Konfiguration und Verbindungstest alle Schlüssel, die dem konfigurierten Präfix entsprechen; Standard: 1.
• Überwachungsübersicht aktivieren. Steuert, ob die Übersichtsstatistiken geladen werden; Standard: 1. Dafür muss die PHP-Redis-Erweiterung verfügbar sein, und dieser Schalter sowie Modul aktivieren müssen eingeschaltet sein.
• Aktualisierungsintervall der Übersicht. Lädt die Übersicht in diesem Sekundenintervall automatisch neu; Standard: 30. Stellen Sie 0 ein, um nur manuell zu aktualisieren.

Die drei Cache-Schalter aktivieren weder Objektcaching noch PHP-Sitzungsspeicherung oder Ganzseitencaching. Die automatische Aktualisierung läuft nur, wenn die PHP-Redis-Erweiterung verfügbar ist und Modul sowie Überwachung eingeschaltet sind. Sie pausiert, solange der Tab ausgeblendet ist oder Sie die Bestätigung zum Leeren der gemeinsamen Datenbank ausfüllen. Die Aktualisierung verwendet die reine Übersichts-URL und wiederholt daher keine übermittelte Aktion.

Diese Beispiele beschreiben Verbindungswerte; sie sind kein Importformat für Umgebungsdateien:

Local service: Redis Host=127.0.0.1, Redis Port=6379, Redis Database Index=0, Key Prefix=shop1_
Docker service: Redis Host=redis, Redis Port=6379, Redis Database Index=0, Key Prefix=shop1_

Verwenden Sie das von Ihrem Hoster bereitgestellte Passwort. Wenn Sie die Bereitstellungskonfiguration in PHP verwalten, lauten die gespeicherten Schlüssel REDIS_HOST, REDIS_PORT, REDIS_AUTH, REDIS_DB, REDIS_PREFIX, FLUSH_ON_SAVE, MONITOR_ENABLED und STATS_REFRESH unter ConfigTable::setMultiple('mprinstantredis', [...]).

Öffnen Sie die Modulübersicht und verwenden Sie den Verbindungstest. Sie zeigt Redis-Version, Verbindungsdetails, Laufzeit, Speicher, Trefferrate, Vorgänge pro Sekunde, Clients, Verdrängungen und Ablaufinformationen. Dies sind Redis-Serverstatistiken und keine auf Ihr Präfix beschränkten Messwerte. Die Gesamtschlüsselzahl wird aus den Datenbankeinträgen von Redis INFO summiert.

Öffnen Sie Schlüsselbrowser. "Pattern" hat den Standardwert *. "Limit" hat den Standardwert 100 und akzeptiert 1 bis 1000. Das konfigurierte Präfix wird Ihrer Suche vorangestellt:

Key Prefix: ps_
Pattern: *           scans ps_*
Pattern: product:*   scans ps_product:*

Die Liste zeigt den Schlüssel ohne Präfix, seinen Typ, TTL und Größe/Anzahl. Prüfen Sie Strings, Listen, Sets, sortierte Sets und Hashes. Die Vorschau von Listen und sortierten Sets ist auf die ersten 100 Einträge beschränkt. Verwenden Sie die Zeilenaktion Löschen nur für Schlüssel, die Sie entfernen möchten. Anfragen zum gesammelten Löschen werden unterstützt, der Schlüsselbrowser hat jedoch keine Steuerelemente zur Mehrfachauswahl.

Verwenden Sie Namensraum der Redis-Übersicht und Schlüsselverwaltung leeren für den eigenen Namensraum des Moduls. Beim Leeren werden Schlüssel mit dem konfigurierten Präfix als wörtlicher Zeichenfolge gesucht und gelöscht. Eine leere Eigentumszuordnung und Überschneidungen mit einem anderen registrierten Eigentümer blockieren das Löschen. Dieselben Eigentumsprüfungen gelten für das Löschen einzelner Zeilen und das Leeren beim Speichern.

Für ein vollständiges Zurücksetzen bietet die Übersicht Gemeinsame Datenbank leeren als separaten Vorgang nur dann an, wenn die Namensraumkoordination bereit ist. Prüfen Sie die Eigentümer, markieren Sie die Bestätigung und geben Sie den auf dem Bildschirm angezeigten Bestätigungssatz ein. Ein veraltetes Eigentumsmanifest oder eine nicht verfügbare Koordination blockiert den Vorgang. Vollständiges Leeren entfernt jeden Schlüssel in der ausgewählten Redis-Datenbank, einschließlich der Schlüssel unabhängiger Anwendungen. Prüfen Sie den Inhalt dieser Schlüssel vor der Nutzung.

1. Speichern Sie die Verbindungsdaten und prüfen Sie die Meldung Redis-Verbindung überprüft.
2. Öffnen Sie die Übersicht und gleichen Sie Host und Port mit Ihrer vorgesehenen Redis-Instanz ab.
3. Suchen Sie unter Schlüsselbrowser nach einem bekannten Schlüssel. Eine Serverschlüsselzahl größer als null ohne passende Browserschlüssel kann auf ein falsches Präfix hinweisen.
4. Wenn die Erweiterungswarnung erscheint, aktivieren Sie php-redis für die PHP-Laufzeit, die das Backoffice bedient. Es nur für die Kommandozeile (CLI) zu aktivieren, reicht nicht.
5. Prüfen Sie bei Verbindungsfehlern mit Ihrem Hoster die Netzwerkerreichbarkeit, den Hostnamen, die Zugangsdaten und die Datenbankberechtigungen.
6. Wenn das Löschen blockiert wird, prüfen Sie das exklusive Präfix und Überschneidungen registrierter Eigentümer. Erweitern Sie das Präfix nicht, um den Schutz zu umgehen.

Betrachten Sie die Trefferrate zusammen mit Speicher und Verdrängungen. Sie ist das Verhältnis der Redis-Treffer zur Summe aus Treffern und Fehlschlägen auf dem gesamten Server. Das Löschen von Schlüsseln kann einen Neuaufbau des Caches erzwingen. Speichert Redis auch Sitzungen oder andere Anwendungsdaten, können diese Anwendungen durch das Entfernen betroffen sein.

Verwenden Sie Integrität für Modulprüfungen. Die Controller-Kennungen sind AdminMPRInstantRedis für die Übersicht, AdminMPRInstantRedisConfig für die Konfiguration, AdminMPRInstantRedisBrowser für das Durchsuchen und AdminMPRInstantRedisIntegrity für die Integrität.

Setzen Sie Modul aktivieren auf Nein, um normale Verbindungen der Übersicht/des Browsers zu stoppen. Deinstallieren Sie über "Module Manager", um Modulkonfiguration und Menüs zu entfernen. Die Deinstallationsroutine leert Redis nicht und entfernt den Redis-Server nicht. Prüfen Sie die unabhängige Cache-/Sitzungskonfiguration Ihres Hosters separat.

Erfordert PrestaShop 1.6.1 oder höher und PHP 7.1 oder höher.