Litespeed Cache guida rapida alle opzioni di configurazione

LiteSpeed Cache è il plugin gratuito che collega WordPress alla cache di LiteSpeed Web Server e ci aggiunge un lungo elenco di ottimizzazioni: compressione delle immagini, minificazione di CSS e JavaScript, pulizia del database, un crawler che prepara le pagine in cache prima che arrivino i visitatori. Le opzioni sono decine. Qui le trovi nell’ordine del menu del plugin, con il valore che consigliamo e i casi in cui conviene cambiarlo.

La cache di pagina funziona solo se il sito gira su un server LiteSpeed. Sui piani Hosting WordPress, Hosting Multidominio e Hosting Professionale di VHosting il web server è già LiteSpeed, quindi basta installare il plugin e attivarlo; su Apache o nginx il plugin offre soltanto le funzioni di ottimizzazione, a meno di passare dalla CDN QUIC.cloud. Le indicazioni valgono per la versione 7 del plugin e per le successive.

I nomi delle opzioni sono quelli originali in inglese. Con WordPress in italiano, alcune voci compaiono tradotte.

Litespeed Cache guida rapida alle opzioni di configurazione

Come si installa LiteSpeed Cache su WordPress?

Il plugin richiede WordPress 6.0 o successivo e PHP 7.4 o successivo. Prima di installarlo, disattiva eventuali altri plugin di cache di pagina: due cache di pagina attive sullo stesso sito vanno in conflitto, mentre object cache e cache del browser possono convivere con LiteSpeed Cache senza problemi.

  1. accedi alla bacheca di WordPress e apri Plugin > Aggiungi nuovo;
  2. cerca «LiteSpeed Cache» e scegli il plugin pubblicato da LiteSpeed Technologies;
  3. fai clic su Installa ora, poi su Attiva;
  4. dal menu laterale apri LiteSpeed Cache > Cache e verifica che Enable Cache sia su ON.

Per controllare che la cache lavori davvero, apri il sito in una finestra anonima e guarda gli header della risposta negli strumenti per sviluppatori del browser, scheda Rete. Al primo caricamento la pagina riporta X-LiteSpeed-Cache: miss, perché viene generata in quel momento; ricaricandola, il valore diventa hit. Se l’header manca, la cache è spenta.

General

La sezione General ha due schede che contano: Online Services, per il collegamento a QUIC.cloud, e General Settings. La vecchia chiave di dominio (Domain Key) non esiste più dalla versione 7.

Online Services

Il pulsante Enable QUIC.cloud services collega il sito ai servizi online di LiteSpeed. Serve solo se vuoi usare la CDN QUIC.cloud, l’ottimizzazione delle immagini o le funzioni che generano CSS e segnaposto nel cloud (UCSS, CCSS, LQIP, VPI). Per la cache di pagina su un server LiteSpeed, come quello dei piani VHosting, il collegamento è facoltativo. Se lo attivi, verifica prima che gli IP dei server QUIC.cloud non siano bloccati da firewall o plugin di sicurezza.

General Settings

  • Automatically Upgrade: OFF. Gli aggiornamenti di un plugin che interviene su cache e codice delle pagine possono cambiare l’aspetto del sito, quindi è più prudente installarli a mano, dopo un backup, e controllare le pagine principali;
  • Guest Mode: OFF. Mostra a chi visita il sito per la prima volta una pagina già in cache e carica la versione personalizzata in un secondo momento, ma aggiunge varianti di cache e su siti multilingua o negozi può mostrare per un attimo lingua o prezzi sbagliati;
  • Guest Optimization: lascia il valore predefinito. Funziona solo con Guest Mode attivo e consuma la quota di QUIC.cloud;
  • Server IP: inserisci l’IP del server che ospita il sito. Il crawler e QUIC.cloud lo usano per raggiungere il sito senza passare dal DNS, e un valore sbagliato manda quasi tutte le pagine nella blocklist del crawler;
  • Notifications: ON. Oltre alle promozioni, arrivano gli avvisi sulle correzioni urgenti.

Per chi parte da zero c’è anche la sezione Presets, che applica configurazioni pronte e cumulative: Essentials attiva cache e cache del browser, Basic aggiunge ottimizzazione immagini e cache mobile, i livelli successivi (Advanced, Aggressive, Extreme) intervengono sempre più a fondo su CSS e JavaScript e diventano più rischiosi. Il plugin salva le impostazioni prima di applicare un preset, quindi si torna indietro dalla cronologia.

Cache

È la sezione che decide cosa finisce in cache, per quanto tempo e quando viene svuotato. Per la maggior parte dei siti i valori predefiniti funzionano già; le schede sono nove, e qui sotto trovi solo le voci su cui vale la pena intervenire.

Cache

  • Enable Cache: ON;
  • Cache Logged-in Users: ON. Gli utenti che hanno effettuato l’accesso ricevono una copia privata delle pagine;
  • Cache Commenters: ON;
  • Cache REST API: ON;
  • Cache Login Page: OFF, il valore predefinito dalla versione 7.9. Le pagine di accesso contengono spesso captcha o codici di sicurezza che una copia in cache renderebbe inutilizzabili;
  • Cache Mobile: OFF, a meno che il sito mostri da smartphone un design o contenuti diversi dal desktop. Attivarla crea una seconda copia di ogni pagina;
  • Private Cached URIs, Force Cache URIs e Force Public Cache URIs: elenchi di indirizzi da mettere in cache privata o da forzare in cache anche quando le altre regole lo impedirebbero. Di solito restano vuoti;
  • Drop Query String: parametri da ignorare nell’URL, come utm_source, così che le visite da campagne diverse usino la stessa copia della pagina.

Le vecchie opzioni Cache favicon.ico e Cache PHP Resources sono state rimosse.

TTL

Lascia i valori predefiniti: 604800 secondi (una settimana) per pagine pubbliche, home, feed e REST API, 1800 secondi per la cache privata. Sotto i 30 secondi la pagina smette di essere messa in cache.

Purge

  • Purge All On Upgrade: ON, come consiglia la documentazione del plugin. Dopo l’aggiornamento di WordPress, di un tema o di un plugin la cache si svuota e nessuno vede pagine generate con il codice vecchio;
  • Auto Purge Rules For Publish/Update: lascia le regole predefinite e aggiungi solo le pagine che il tema mostra davvero, per esempio l’archivio dell’autore se compare nel sito;
  • Serve Stale: OFF. Se attivo, chi visita il sito durante lo svuotamento può vedere per qualche istante il contenuto vecchio;
  • Scheduled Purge URLs e Scheduled Purge Time: servono a svuotare pagine precise a un orario fisso, utile quando un contenuto arriva da una fonte esterna che non avvisa WordPress;
  • Purge All Hooks: azioni di WordPress che svuotano l’intera cache, come il cambio di tema o la modifica di un menu. L’elenco predefinito va bene.

Excludes

Qui si elencano gli indirizzi, i parametri, le categorie, i tag, i cookie, gli user agent e i ruoli da non mettere in cache. Conviene escludere le pagine con moduli di contatto o aree riservate; il checkout di WooCommerce è già escluso. Attenzione ai cookie: escluderne uno presente in tutto il sito spegne la cache ovunque.

ESI

ESI permette di mettere in cache una pagina pubblica lasciando dinamici alcuni blocchi, come la barra di amministrazione o il carrello. Funziona con LiteSpeed Web Server Enterprise, con Web ADC o con la CDN QUIC.cloud, mentre OpenLiteSpeed non la supporta.

  • Enable ESI: OFF, salvo sui negozi WooCommerce, dove la documentazione la raccomanda;
  • Cache Admin Bar: ON;
  • Cache Comment Form: ON;
  • ESI Nonces: da compilare solo se un plugin che usa codici di sicurezza nonce smette di funzionare con la cache;
  • Vary Group: lascia il valore predefinito.

Object

L’object cache conserva in memoria i risultati delle query al database. Ha senso sui siti con molti contenuti dinamici, e solo se sul server è attivo Redis o Memcached.

  • Object Cache: OFF, oppure ON se hai Redis o Memcached;
  • Method: Redis o Memcached, secondo il servizio disponibile;
  • Host e Port: localhost con porta 6379 per Redis, 11211 per Memcached;
  • Username, Password e Redis Database ID: vuoti, salvo indicazioni diverse dell’hosting;
  • Persistent Connection: ON;
  • Cache WP Admin: OFF. Velocizza la bacheca dei siti pesanti, ma chi lavora nell’amministrazione rischia di vedere dati non aggiornati.

Default Object Lifetime e Store Transients sono stati rimossi nelle versioni più recenti: i transient ora vengono sempre memorizzati.

Browser

  • Browser Cache: ON. Il browser conserva i file statici come immagini, CSS e JavaScript e non li riscarica a ogni pagina;
  • Browser Cache TTL: 31557600 secondi, cioè un anno (2592000 corrisponde a 30 giorni).

Advanced

  • Login Cookie: serve solo se più installazioni di WordPress condividono lo stesso dominio, per esempio una in una sottocartella; ognuna deve avere un nome di cookie diverso;
  • Improve HTTP/HTTPS Compatibility: OFF. Un sito con certificato SSL non dovrebbe avere contenuti misti;
  • Instant Click: OFF. Precarica le pagine al passaggio del mouse e aumenta le richieste al server.

WooCommerce

La scheda compare solo con WooCommerce attivo. Product Update Interval stabilisce cosa svuotare quando cambiano le scorte di un prodotto: il valore predefinito aggiorna la scheda prodotto a ogni variazione di quantità e le categorie solo quando il prodotto passa da disponibile a esaurito, o viceversa. Se nelle pagine di categoria mostri la disponibilità, scegli un’opzione che svuoti anche le categorie. Vary for Mini Cart resta OFF.

CDN

Se il sito non usa una CDN, questa sezione si salta. Le schede sono tre, una per tipo di servizio.

QUIC.cloud

La CDN di LiteSpeed si attiva con una sequenza di pulsanti: prima Enable QUIC.cloud services, poi Enable QUIC.cloud CDN, infine Finish CDN setup. Il collegamento può passare dal DNS di QUIC.cloud o da un record CNAME; chi usa DNSSEC deve scegliere il CNAME, perché il DNS di QUIC.cloud non lo supporta. Su un server LiteSpeed la CDN è utile soprattutto per servire il sito più velocemente a visitatori lontani dal datacenter.

Cloudflare

  • Cloudflare API: ON solo se il sito passa da Cloudflare. Servono un token creato con il modello «WordPress», l’email dell’account e il dominio;
  • Clear Cloudflare cache: ON, così ogni Purge All di LiteSpeed svuota anche la cache di Cloudflare;
  • Development Mode: disattiva temporaneamente la cache di Cloudflare mentre lavori sul sito e si spegne da sola dopo tre ore;
  • Purge Everything: svuota solo la cache di Cloudflare, utile dopo aver sostituito un’immagine o un file statico.

Other static CDN

  • Use CDN Mapping: ON solo con una CDN tradizionale che serve i file statici da un dominio proprio. Con Cloudflare o QUIC.cloud non serve;
  • CDN URL: l’indirizzo della CDN, con i tipi di file da servire (immagini, CSS, JavaScript);
  • HTML Attribute To Replace: lascia il valore predefinito;
  • Original URLs: l’indirizzo del sito, che va cambiato solo per i multisito o i siti multilingua su più domini;
  • Included Directories: wp-content e wp-includes, i valori predefiniti;
  • Exclude Path: le cartelle da non servire tramite CDN, senza caratteri jolly.

Image Optimization

L’ottimizzazione delle immagini avviene sui server di QUIC.cloud, quindi richiede il collegamento descritto nella sezione General. Il plugin invia le immagini, le riceve compresse e conserva gli originali in una copia di backup.

Come si ottimizzano le immagini?

Nella scheda Image Optimization Summary il pulsante Send Optimization Request invia le immagini a QUIC.cloud: la prima richiesta ne manda una, le successive fino a 200 alla volta. Il ritiro delle immagini compresse è automatico dalla versione 7. Per non ripetere la richiesta a mano, attiva Auto Request Cron nelle impostazioni.

Nella stessa scheda ci sono gli strumenti di gestione:

  • Clean Up Unfinished Data: chiude le richieste bloccate, così se ne possono inviare di nuove;
  • calcolo dello spazio dei backup: mostra quanto occupano gli originali conservati sul server;
  • Use original files e Use optimized files: passano dagli originali alle versioni compresse e ritorno, utili per confrontare la qualità;
  • Remove Original Image Backups: elimina i backup, un’operazione che non si può annullare. Prima scarica gli originali sul tuo computer;
  • Destroy All Optimization Data: cancella tutti i dati di ottimizzazione e non si può annullare.

Image Optimization Settings

  • Auto Request Cron: ON, se vuoi che ogni immagine caricata venga ottimizzata in automatico;
  • Optimize Original Images: ON;
  • Remove Original Backups: OFF. Se attiva, gli originali vengono cancellati dopo l’ottimizzazione e non si recuperano più;
  • Optimize Losslessly: OFF. Mantiene la qualità al cento per cento, ma i file restano più pesanti;
  • Optimize Image Sizes: lascia selezionate tutte le dimensioni.

La conversione in WebP o AVIF produce file più leggeri di JPEG e PNG, al costo di più spazio occupato sul server. Se la attivi, attiva anche la sostituzione delle immagini nelle pagine, altrimenti i nuovi formati restano inutilizzati. La qualità di compressione di WordPress si imposta invece in Page Optimization > Media Settings.

Page Optimization

Quasi tutti i problemi di visualizzazione dopo l’attivazione di LiteSpeed Cache nascono da questa sezione. Ogni modifica va provata su una pagina alla volta, possibilmente in un ambiente di prova, e seguita da un Purge All. Il principio che consigliamo è semplice: partire con tutto spento e attivare una funzione solo quando serve e funziona.

CSS Settings

Minificare e combinare i file costa lavoro al server, e sulle prime visite rallenta la pagina invece di velocizzarla; se il sito passa da Cloudflare o da un’altra CDN che minifica già, conviene lasciare il compito a lei. Combinare CSS e JavaScript, poi, causa spesso errori senza un guadagno di velocità apprezzabile.

  • CSS Minify: OFF;
  • CSS Combine: OFF;
  • Generate UCSS: OFF. Genera il CSS effettivamente usato da ogni pagina tramite QUIC.cloud e occupa molto spazio;
  • CSS Combine External and Inline: OFF, conta solo con CSS Combine attivo;
  • Load CSS Asynchronously: OFF. Migliora i punteggi dei test di velocità, ma la pagina può comparire per un attimo senza stili;
  • CSS Per URL e Inline CSS Async Lib: lascia i valori predefiniti, contano solo con il caricamento asincrono;
  • Font Display Optimization: Default.

JS Settings

  • JS Minify: OFF;
  • JS Combine: OFF. Se decidi di attivarlo, prova con attenzione ogni tipo di pagina;
  • JS Combine External and Inline: OFF;
  • Load JS Deferred: OFF. Alcuni script servono agli elementi visibili appena si apre la pagina e non vanno rimandati; l’opzione Delayed ottiene punteggi più alti nei test e peggiora più spesso l’esperienza di navigazione.

HTML Settings

  • HTML Minify: OFF;
  • DNS Prefetch: i domini esterni da cui il sito carica risorse, uno per riga. Per trovarli, apri il sito in una finestra anonima, apri gli strumenti per sviluppatori e annota i domini nella scheda Sorgenti o Rete: statistiche, font, chat, social, CDN;
  • DNS Prefetch Control: OFF se hai già compilato l’elenco precedente, ON se preferisci che il plugin individui i domini da CSS e JavaScript;
  • DNS Preconnect: come il prefetch, ma apre anche la connessione. Va riservato ai due o tre domini più importanti;
  • HTML Lazy Load Selectors: i selettori degli elementi HTML da caricare in ritardo, uno per riga;
  • Remove Query Strings: OFF. Migliora i punteggi dei test, ma non la velocità reale;
  • Load Google Fonts Asynchronously: OFF;
  • Remove Google Fonts: ON solo se i font sono già caricati in locale;
  • Remove WordPress Emoji: ON. I browser moderni mostrano le emoji da soli;
  • Remove Noscript Tags: OFF.

Media Settings

  • Lazy Load Images: OFF. Se lo attivi, il plugin sostituisce il caricamento differito nativo di WordPress;
  • Basic Image Placeholder, Responsive Placeholder e LQIP: contano solo con Lazy Load Images attivo. Responsive Placeholder riserva lo spazio dell’immagine ed evita che la pagina «salti» durante lo scorrimento; LQIP mostra una versione sfocata dell’immagine, generata da QUIC.cloud, finché non arriva quella definitiva;
  • Lazy Load Iframes: ON se il sito incorpora video o mappe sotto la prima schermata;
  • Add Missing Sizes: OFF;
  • WordPress Image Quality Control: 82, il valore predefinito. Abbassalo per file più leggeri, alzalo se noti un calo di qualità;
  • Auto Rescale Original Images: OFF. Ridimensiona gli originali oltre i 2560 pixel e non si può annullare.

La scheda VPI (Viewport Images) individua le immagini visibili appena si apre la pagina e le esclude dal caricamento differito. Richiede Lazy Load Images e QUIC.cloud; con il caricamento differito spento può restare OFF.

Media Excludes

Qui si escludono dal caricamento differito singole immagini o iframe, per indirizzo, per classe CSS o per classe dell’elemento che li contiene, e intere pagine tramite Lazy Load URI Excludes. Conviene escludere le immagini in testa alla pagina, come logo e immagine di copertina, e le landing page in cui tutto deve comparire subito.

Localization

  • Gravatar Cache: ON solo sui siti con molti commenti, insieme a Gravatar Cache Cron. Il TTL predefinito di una settimana va bene;
  • Localize Resources: OFF.

Tuning e Tuning CSS

Sono gli elenchi di eccezioni: file CSS e JavaScript da non minificare, combinare o rimandare (per esempio quelli di Elementor, indicati anche con un nome parziale), indirizzi da escludere da ogni ottimizzazione, ruoli utente esclusi. Optimize for Guest Only resta ON, così le ottimizzazioni valgono solo per chi non ha effettuato l’accesso. Se una pagina si rompe dopo una modifica, il rimedio più rapido è aggiungerla a URI Excludes.

Database

Gli strumenti di pulizia del database sono tra le funzioni più comode del plugin. Prima di usarli fai un backup del database: le eliminazioni non si annullano.

Manage

  • Clean All: esegue tutte le pulizie dell’elenco, tranne l’ottimizzazione delle tabelle;
  • Post Revisions: elimina tutte le revisioni degli articoli;
  • Orphaned Post Meta: elimina i dati collegati ad articoli che non esistono più;
  • Auto Drafts, Trashed Posts, Spam Comments e Trashed Comments: bozze automatiche, articoli nel cestino, commenti spam e commenti nel cestino. Prima di cancellarli conviene dare un’occhiata;
  • Trackbacks & Pingbacks: si possono eliminare senza rischi;
  • Expired Transients e All Transients: dati temporanei che WordPress rigenera da solo, si eliminano senza rischi;
  • Optimize Tables: riorganizza le tabelle e va lanciato a parte;
  • Database Table Engine Converter: elenca le tabelle ancora in formato MyISAM, con un pulsante per convertirle in InnoDB, il formato più efficiente. Conviene convertirle tutte;
  • Database Summary: mostra le opzioni caricate automaticamente a ogni pagina. Se il totale supera 1 MB, qualche plugin sta appesantendo il sito.

DB Optimization Settings

  • Revisions Max Number: 0, cioè nessun limite, va bene per i siti leggeri. Sui siti con molti articoli e un database grande, un valore tra 10 e 50 tiene sotto controllo le revisioni;
  • Revisions Max Age: 0. Eliminare le revisioni in base all’età è sconsigliato, perché si perde la cronologia degli articoli modificati di rado.

Crawler

Il crawler percorre il sito seguendo la sitemap e rigenera in cache le pagine scadute, così chi arriva trova più spesso una pagina già pronta. Servono due condizioni. Il crawler deve essere abilitato a livello di server dall’amministratore dell’hosting, e deve sapere dove si trova la sitemap del sito.

Come si attiva il crawler?

  1. apri LiteSpeed Cache > Crawler e vai nella scheda Settings;
  2. porta Crawler su ON;
  3. nel campo Custom Sitemap inserisci l’URL della sitemap: /sitemap_index.xml se la genera un plugin SEO come Yoast o Rank Math, /wp-sitemap.xml se usi quella di WordPress;
  4. salva, poi nella scheda Map premi Refresh Crawler Map per caricare l’elenco degli URL.

Nella scheda Summary segui l’avanzamento con i colori: grigio per le pagine in coda, verde per quelle già in cache, blu per quelle appena messe in cache dal crawler, rosso per quelle finite nella blocklist. Dalla versione 7.9 un URL entra nella blocklist solo dopo tre errori consecutivi. Se ci finiscono quasi tutte le pagine, controlla il campo Server IP nella sezione General.

Il crawler di litespeed è una delle funzioni attivate recentemente da LiteSpeed, utile a velocizzare il sito web. Il crawler effettua una scansione, con cadenza regolare, del sito web in modo da memorizzare in cache, in maniera preventiva, tutte le pagine del proprio sito web in modo da accellerare il tempo di caricamento dello stesso.

La schermata che si presenterà sarà la seguente dove si deve cliccare su General Settings

WordPress: Come configurare LiteSpeed Cache ed il suo Crawler

Si aprirà quindi questa schermata

WordPress: Come configurare LiteSpeed Cache ed il suo Crawler

Per l’attivazione del crawler bisogna attenzionarsi sul pulsante OFF/ON iniziale

WordPress: Come configurare LiteSpeed Cache ed il suo Crawler

Settandolo su ON e salvando il crawler sarà quindi attivo

WordPress: Come configurare LiteSpeed Cache ed il suo Crawler

Ultimo passaggio, ma il più importante di tutti, è quello di posizionarsi sul tab Sitemap Settings e impostare l’URL della sitemap in modo che il crawler sappia dove prelevare tutte le URL.

WordPress: Come configurare LiteSpeed Cache ed il suo Crawler

Una volta inserito l’URL della sitemap basta salvare e il crawler inizierò a mettere in cache tutte le pagine presenti

WordPress: Come configurare LiteSpeed Cache ed il suo Crawler

La sitemap può essere generata tramite un qualsiasi plugin seo o tramite plugin appositi.

Quali valori impostare?

  • Crawler: ON;
  • Crawl Interval: indica ogni quanti secondi ricomincia la scansione completa. Il predefinito è 302400, circa tre giorni e mezzo; il valore giusto è poco più del tempo che il crawler impiega per un giro intero, e lo si misura lasciandolo lavorare un paio di volte;
  • Server Load Limit: è il carico del server oltre il quale il crawler si ferma. Il predefinito è 1, e una buona regola è la metà dei core disponibili (0,5 con un core, 1 con due, 2 con quattro). Con 0 il crawler non parte;
  • Role Simulation: contiene gli ID degli utenti di cui il crawler simula la visita, per mettere in cache anche le pagine viste da chi ha effettuato l’accesso. Dalla versione 7 non accetta utenti con ruolo Editor o superiore. Se il sito non ha aree riservate, lascialo vuoto;
  • Cookie Simulation: serve ai siti multilingua o multivaluta che distinguono le versioni con un cookie, come fa WPML. Ogni valore aggiunto crea un crawler in più, quindi va usato con parsimonia.

Dalla versione 7, Delay, Run Duration, Interval Between Runs, Threads, Timeout, Drop Domain from Sitemap e Sitemap Timeout sono spariti dal pannello. Valgono rispettivamente 500 microsecondi, 900 secondi al massimo, 600 secondi, 3 thread, 30 secondi, attivo e 120 secondi. Run Duration resta fisso; gli altri si cambiano con una costante in wp-config.php, per esempio così per portare il timeout a 60 secondi:

define('LITESPEED_CRAWLER_TIMEOUT', 60);