Gestione & monitoraggio della Cache Redis: configurazione e aiuto

Nel Back Office, apri Moduli > "Module Manager", scegli "Upload a module" e carica lo ZIP del modulo. Installalo, poi fai clic su Configura. Nelle versioni precedenti di PrestaShop, usa la pagina dei moduli corrispondente.

Il tuo hosting deve già fornire Redis e l'estensione PHP Redis per l'ambiente PHP web. Il modulo gestisce una connessione, un pannello e un esploratore di chiavi. Non installa Redis né configura il backend della cache del tuo negozio.

Nel Back Office il modulo si chiama Pannello Redis e gestione delle chiavi. Apri la sua schermata Configurazione. Inizia da Connessione. Inserisci host Redis, porta, password facoltativa, database e un prefisso esclusivo per le chiavi. Su Docker, usa il nome del servizio Redis se 127.0.0.1 punta al contenitore PHP stesso.

Prima del primo salvataggio, controlla Memorizzazione nella cache > Svuota la cache al salvataggio della configurazione, che ha come valore predefinito Sì. Disattivalo se vuoi solo provare la connessione. Salva, poi controlla il risultato della connessione.

Le schede sono Connessione, Memorizzazione nella cache e Monitoraggio. Connessione contiene l'interruttore principale e i dati Redis. Memorizzazione nella cache contiene le tre preferenze della cache memorizzate e lo svuotamento al salvataggio. Monitoraggio controlla le statistiche del pannello e l’aggiornamento automatico.

• Attiva modulo. Attiva o disattiva la connessione del pannello Redis e dell'esploratore di chiavi; valore predefinito: 1. Impostalo nella scheda Connessione.
• Host Redis. Imposta il nome host o l'indirizzo IP di Redis; valore predefinito: 127.0.0.1. Su hosting Docker, usa il nome del contenitore o del servizio Redis.
• Porta Redis. Imposta la porta TCP di Redis; valore predefinito: 6379.
• Password Redis. Imposta la password di autenticazione Redis; valore predefinito: vuota. Un campo segreto vuoto conserva la password memorizzata. Usa il controllo di cancellazione del campo segreto per rimuoverla quando Redis non richiede più l'autenticazione.
• Indice del database Redis. Seleziona il numero del database Redis; valore predefinito: 0. Usa un altro numero solo se te lo ha assegnato il tuo hosting.
• Prefisso delle chiavi. Limita le ricerche nell'esploratore e gli svuotamenti per prefisso alle chiavi che iniziano con questo prefisso; valore predefinito: ps_.
• Attiva la cache degli oggetti. Memorizza la preferenza del modulo per usare Redis come backend della cache degli oggetti PrestaShop; valore predefinito: 0. Il modulo registra questa impostazione ma non riscrive autonomamente i file della cache del server PrestaShop.
• Attiva l’archiviazione delle sessioni. Memorizza la preferenza del modulo per conservare le sessioni PHP in Redis; valore predefinito: 0. La gestione delle sessioni server/PHP deve comunque essere configurata dal tuo hosting o sviluppatore.
• Attiva la cache delle pagine complete. Memorizza la preferenza del modulo per la cache delle pagine complete per gli ospiti; valore predefinito: 0. Questo modulo non aggiunge autonomamente un livello di cache delle pagine al negozio.
• Svuota la cache al salvataggio della configurazione. Elimina le chiavi che corrispondono al prefisso configurato dopo il salvataggio riuscito della configurazione e il test di connessione; valore predefinito: 1.
• Attiva il pannello di monitoraggio. Controlla il caricamento delle statistiche del pannello; valore predefinito: 1. Richiede l’estensione PHP Redis e l’attivazione sia di questo interruttore sia di Attiva modulo.
• Intervallo di aggiornamento del pannello. Ricarica automaticamente il pannello a questo intervallo in secondi; valore predefinito: 30. Imposta 0 per il solo aggiornamento manuale.

I tre interruttori della cache non attivano la cache degli oggetti, l’archiviazione delle sessioni PHP o la cache delle pagine complete. L’aggiornamento automatico funziona solo quando l’estensione PHP Redis è disponibile e il modulo e il monitoraggio sono attivi. Si interrompe temporaneamente mentre la scheda è nascosta o compili la conferma per svuotare il database condiviso. Usa l’URL del pannello senza parametri di azione, così non ripete un’operazione inviata.

Questi esempi descrivono valori di connessione; non sono un formato di importazione di file di ambiente:

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_

Usa la password fornita dal tuo hosting. Se gestisci la configurazione del deployment in PHP, le chiavi memorizzate sono REDIS_HOST, REDIS_PORT, REDIS_AUTH, REDIS_DB, REDIS_PREFIX, FLUSH_ON_SAVE, MONITOR_ENABLED e STATS_REFRESH sotto ConfigTable::setMultiple('mprinstantredis', [...]).

Apri il pannello del modulo e usa il suo test di connessione. Riporta la versione Redis, i dettagli della connessione, il tempo di attività, la memoria, il tasso di hit, le operazioni al secondo, i client, le espulsioni e le informazioni sulle scadenze. Sono statistiche del server Redis, non misurazioni limitate al tuo prefisso. Il numero totale di chiavi viene sommato dalle voci dei database di Redis INFO.

Apri Esplora chiavi. "Pattern" ha come valore predefinito *. "Limit" ha come valore predefinito 100 e accetta da 1 a 1000. Il prefisso configurato viene anteposto alla tua ricerca:

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

L'elenco mostra la chiave senza il prefisso, il tipo, il TTL e la dimensione/il numero di elementi. Ispeziona stringhe, liste, insiemi, insiemi ordinati e hash. Le anteprime delle liste e degli insiemi ordinati sono limitate alle prime 100 voci. Usa l'azione Elimina della riga solo per le chiavi che intendi rimuovere. Le richieste di eliminazione in blocco sono supportate, ma l’esploratore delle chiavi non ha controlli di selezione multipla.

Usa Svuota lo spazio dei nomi del pannello Redis e della gestione delle chiavi per lo spazio dei nomi di proprietà del modulo. Uno svuotamento cerca ed elimina le chiavi con il prefisso configurato letterale. Una proprietà vuota e la sovrapposizione con un altro proprietario registrato bloccano l'eliminazione. Gli stessi controlli di proprietà si applicano all'eliminazione delle righe e allo svuotamento al salvataggio.

Per un ripristino completo, il pannello espone Svuota il database condiviso come operazione separata solo quando il coordinamento degli spazi dei nomi è pronto. Controlla i proprietari, seleziona la casella di presa visione e digita la frase di conferma mostrata sullo schermo. Un manifesto di proprietà obsoleto o un coordinamento non disponibile bloccano l'operazione. Uno svuotamento completo rimuove ogni chiave nel database Redis selezionato, comprese quelle di applicazioni non correlate. Controlla cosa contengono queste chiavi prima di usarlo.

1. Salva i dati di connessione e verifica il messaggio Connessione Redis verificata.
2. Apri il pannello e confronta host e porta con l'istanza Redis prevista.
3. Cerca una chiave nota in Esplora chiavi. Un numero di chiavi del server maggiore di zero senza chiavi corrispondenti nell'esploratore può indicare un prefisso errato.
4. Se compare l'avviso sull'estensione, attiva php-redis per l'ambiente PHP che serve il Back Office. Attivarla solo per la riga di comando (CLI) non basta.
5. In caso di connessione non riuscita, controlla con il tuo hosting la raggiungibilità della rete, il nome host, le credenziali e i permessi del database.
6. Se l'eliminazione è bloccata, controlla il prefisso esclusivo e le sovrapposizioni tra proprietari registrati. Non ampliare il prefisso per aggirare la protezione.

Leggi il tasso di hit insieme alla memoria e alle espulsioni. È il rapporto tra gli hit Redis e la somma di hit e miss nell'intero server. L'eliminazione delle chiavi può forzare la ricostruzione della cache. Se Redis memorizza anche sessioni o altri dati applicativi, la rimozione può influire su quelle applicazioni.

Usa Integrità per i controlli del modulo. Gli identificatori dei controller sono AdminMPRInstantRedis per il pannello, AdminMPRInstantRedisConfig per la configurazione, AdminMPRInstantRedisBrowser per l'esplorazione e AdminMPRInstantRedisIntegrity per l'integrità.

Imposta Attiva modulo su No per interrompere le normali connessioni del pannello/esploratore. Disinstalla tramite "Module Manager" per rimuovere la configurazione e i menu del modulo. La procedura di disinstallazione non svuota Redis e non rimuove il server Redis. Esamina separatamente la configurazione indipendente della cache e delle sessioni del tuo hosting.

Richiede PrestaShop 1.6.1 o successivo e PHP 7.1 o successivo.