Ergonet Cache

Introduction

Description

Ergonet Cache for Joomla! is a free plugin developed by Ergonet srl, an Italian hosting company, to drastically improve the performance of a Joomla! website by using a server-side page caching system (NGINX Cache or Varnish Cache).
BENEFITS

Using a server-side caching system increases your Joomla! site’s performance by a minimum of 30% and up to 70%. Keep in mind that the actual improvement will also depend on your overall website optimization strategy.
WHAT IS PAGE CACHE AND HOW DOES IT WORK?

Page cache speeds up your website by storing the entire HTML of web pages directly on the web server, instantly serving them to visitors without needing to query the PHP server or the database again. Depending on your hosting plan, you can enable NGINX page cache (Equilibrio plan) or advanced RAM-based Varnish page cache (Progresso and Successo plans).
COMPATIBILITY

The Ergonet Cache plugin is compatible with all other website caching and optimization plugins, such as WP Rocket, W3 Total Cache, WO Optimize, etc.
The Ergonet Cache plugin functions solely as a communication layer between Joomla! and the cache system (Varnish or NGINX) installed on the Joomla! hosting platform (any plan) and dedicated cloud hosting (Solo and Multidomain plans) offered by Ergonet, available for purchase at this link: https://www.ergonet.it/hosting/hosting-joomla-valore
A fundamental requirement for the plugin to work is enabling the caching system from the WebPanel (Ergonet client area available at https://webpanel.ergonet.it) by the user who purchased the shared or dedicated cloud hosting service.
HOW THE PLUGIN WORKS

Once the caching system is enabled from the Ergonet WebPanel and the Ergonet Cache plugin is installed and activated, it will work without any additional configuration.
Cache resource updates
Each time the webmaster updates a post or page, the plugin installed in Joomla! will automatically delete the old cached version to prevent users from seeing outdated content.
At the same time, the homepage cache will also be cleared to reflect any new articles available on it.
Cache resource deletion
Thanks to the automatic update and removal functionality, there is no need to manually clear the cache. Moreover, forcibly clearing the entire cache is discouraged, as it would remove all previously stored resources (pages, articles, etc.) that had been frequently accessed.
On websites with a large amount of content, a full cache purge could also cause significant slowdowns due to Joomla! needing to regenerate all requested pages or articles from scratch.
WHAT IS NOT CACHED

To ensure the plugin works efficiently, some resources and specific HTTP calls are never cached. These include:

Any page, article/resource visited by a logged-in user.
Any page, article/resource where a no-cache header or similar is set.
All requests made to the Joomla! backend.
All data submission requests (e.g., registration forms, contact forms, comments, etc.)

HOW TO CHECK IF CACHING IS WORKING

The server-side cache system sets specific HTTP headers indicating whether the requested resource (link) is cached or not. To verify if your website is using the cache correctly, you must check for these HTTP headers.
It’s essential to ensure you are logged out of the Joomla! site you’re checking, as well as from any other Joomla! site open in other browser tabs. The first step is therefore to log out from the Joomla! admin area.
Open the developer tools based on your browser:

For Firefox: Menu → Browser Tools → Browser Console

For Chrome: View → Developer Options → Developer Tools

Once the developer tools are open:

Select the “Network” tab
In Firefox, choose the “HTML” sub-tab, in Chrome, choose “Doc”
Refresh the website page
Click on the first row showing the domain name or visited link (with status 200)

In the right-hand column, you’ll see the response headers. The last header refers to the cache:
VARNISH CACHE HEADER

X-VC-Cache: HIT = the resource (page) is present in cache and was served from the Varnish cache system. This means the caching system is working properly.
X-VC-Cache: MISS = the resource (page) is NOT in cache and was generated by the Joomla! application. This means the cache system was instructed by headers or custom rules not to serve the cached content to the visitor.
NGINX CACHE HEADER

x-cache-status: HIT or STALE = the resource (page) is present in cache and was served from the NGINX cache system. This means the caching system is working properly.
x-cache-status: MISS = the resource (page) is NOT in cache and was generated by the Joomla! application. This means the cache system was instructed by headers or custom rules not to serve the cached content to the visitor.
ENABLING THE CACHING SYSTEM FROM THE WEBPANEL

The NGINX caching system is enabled by default and doesn’t require any specific settings.
To enable the Varnish caching system, we recommend checking the dedicated guide: https://docs.ergonet.it/gestione-hosting/impostazioni-cache-server/cache-varnish
Contributors & Developers

“Ergonet Cache” is open source software. The following people have contributed to this plugin.

Descrizione

Ergonet Cache for Joomla! è il plugin gratuito sviluppato da Ergonet srl, azienda di hosting italiana, per migliorare drasticamente le performance di un sito web sviluppato in Joomla!, grazie all’ausilio di un sistema di cache di pagina lato server (Cache NGINX oppure Varnish cache).
BENEFICI

L’utilizzo di un sistema di cache lato server, aumenta le performance del tuo sito in Joomla! da un minimo del 30% ad un massimo del 70%. Ricorda che la percentuale di miglioramento dipenderà comunque anche dall’intera strategia di ottimizzazione del tuo sito web.
COS’È LA CACHE DI PAGINA E COME FUNZIONA?

La cache di pagina velocizza il tuo sito memorizzando l’intero HTML delle pagine web direttamente sul web server, restituendole istantaneamente ai visitatori senza necessità di interrogare nuovamente il server php o il database. In base al piano di hosting acquistato, potrai attivare la cache di pagina NGINX (piano Equilibrio) o la cache di pagina avanzata Varnish su memoria RAM (piani Progresso e Successo).
COMPATIBILITÁ

Il plugin Ergonet Cache è compatibile con tutti gli altri plugin di cache e ottimizzazione del sito web. Ad esempio WP Rocket, W3 Total cache, WO Optimize, ecc.
Il plugin Ergonet Cache funziona esclusivamente come layer di comunicazione tra Joomla! e il sistema di cache (Varnish oppure NGINX) installato sulla piattaforma server di hosting per Joomla! (qualsiasi piano) e cloud hosting dedicati (piani Solo e Multidominio) di Ergonet disponibili per l’acquisto a questo link https://www.ergonet.it/hosting/hosting-joomla-valore
Un requisito fondamentale per il funzionamento del plugin è l’attivazione del sistema di cache dal WebPanel (area clienti Ergonet disponibile su https://webpanel.ergonet.it) da parte dell’utente che ha acquistato il servizio di hosting condiviso o cloud dedicato.
COME FUNZIONA IL PLUGIN

Una volta attivato il sistema di cache dal WebPanel di Ergonet e installato e attivato il plugin Ergonet Cache, lo stesso funzionerà senza alcuna configurazione aggiuntiva.
Aggiornamento delle risorse in cache
Ogni volta che il webmaster aggiornerà un articolo o una pagina, il plugin installato in Joomla! si occuperà di eliminare la vecchia risorsa presente in cache, per evitare che gli utenti visualizzino un contenuto vecchio.
Contestualmente verrà anche eliminata la cache della homepage, per aggiornare gli eventuali ultimi articoli disponibili nella stessa.
Cancellazione delle risorse in cache
Considerata la funzionalità di aggiornamento e rimozione automatica delle risorse, non sarà necessario cancellare forzatamente la cache per alcun motivo. Inoltre la cancellazione totale della cache è un’azione sconsigliata, in quanto eliminerebbe dalla stessa tutte le risorse (pagine, articoli, ecc) che sono state immagazzinate in precedenza poiché molto visitate.
Su siti con moltissimi contenuti l’operazione di cancellazione totale della cache potrebbe causare inoltre un rallentamento importante, causato della necessità da parte del sito in Joomla! di rigenerare nuovamente da zero tutte le pagine o articoli richieste dagli utenti.
COSA NON VIENE INSERITO IN CACHE

Per rendere efficiente il funzionamento del plugin, ci sono alcune risorse e chiamate HTTP specifiche che non verranno mai inserite in cache, ecco quali:

Qualsiasi pagina, articolo/risorsa visitato da un utente loggato.
Qualsiasi pagina, articolo/risorsa in cui viene settato un header no-cache e similari.
Tutte le chiamate dirette al backend di Joomla!.
Tutte le chiamate eseguite per inserimento dati (form di registrazione, contatti, commenti e così via.)

COME VERIFICARE CHE LA CACHE VARNISH SIA FUNZIONANTE

Il sistema di cache lato server setta degli header HTTP specifici nel caso la risorsa (link) richiamata sia presente o meno in cache. Per verificare se il sito web stia sfruttando la cache correttamente, è quindi necessario verificare la presenza di questi header HTTP.
È essenziale assicurarsi di essere sloggati dal sito Joomla! oggetto della verifica e da qualsiasi altro sito Joomla! aperto in una scheda del browser utilizzato. Per prima cosa è quindi assolutamente necessario eseguire un logout dall’area di backend di Joomla!.
Aprire gli strumenti per sviluppatori in base al browser utilizzato:

Firefox tramite il menù: strumenti -> strumenti del browser -> Console del browser

Chrome tramite il menù: Vista -> opzioni per sviluppatori -> strumenti per sviluppatori

A questo punto si apriranno gli strumenti per sviluppatori:

Selezionare la scheda “Rete” oppure “Network”
Selezionare la sotto-scheda “HTML” in Firefox oppure “Doc” in Chrome
Ricaricare il sito web eseguendo un refresh della pagina
Cliccare sulla prima riga, relativa al nome dominio (oppure il link della pagina visitata) identificato con stato o status 200

Nella colonna di destra si apriranno gli Header di risposta, l’ultimo header sarà quello relativo alla cache:
HEADER VARNISH CACHE

X-VC-Cache: HIT= la risorsa, quindi la pagina richiamata, è presente in cache ed è stata restituita dal sistema di cache Varnish. Significa che il sistema di cache sta funzionando correttamente.
X-VC-Cache: MISS= la risorsa, quindi la pagina richiamata, NON è presente in cache ed è stata generata dall’applicazione Joomla!. Significa che il sistema di cache è stato istruito dagli header dell’applicazione oppure da regole personalizzate, a non restituire il contenuto presente in cache al visitatore.
HEADER CACHE NGINX

x-cache-status: HIT oppure STALE= la risorsa, quindi la pagina richiamata, è presente in cache ed è stata restituita dal sistema di cache NGINX. Significa che il sistema di cache sta funzionando correttamente.
x-cache-status: MISS= la risorsa, quindi la pagina richiamata, NON è presente in cache ed è stata generata dall’applicazione Joomla!. Significa che il sistema di cache è stato istruito dagli header dell’applicazione oppure da regole personalizzate, a non restituire il contenuto presente in cache al visitatore.
ATTIVAZIONE DEL SISTEMA DI CACHE DAL WEBPANEL

Il sistema di cache NGINX è attivo di default e non presenta configurazioni particolari da settare.
Per l’attivazione del sistema di cache Varnish, consigliamo di visionare la guida dedicata https://docs.ergonet.it/gestione-hosting/impostazioni-cache-server/cache-varnish
Contributi e sviluppo

“Ergonet Cache” è un software open source. Le persone che hanno contribuito allo sviluppo di questo plugin sono indicate di seguito.