Configurazione Avanzata WP Super Cache: wp-cache-config.php

Configurazione Avanzata WP Super Cache: wp-cache-config.php

Per gli utenti esperti che desiderano un controllo totale sul comportamento di WP Super Cache, il file wp-cache-config.php rappresenta il cuore della configurazione del plugin. Mentre l’interfaccia grafica del pannello WordPress offre le opzioni più comuni, questo file di configurazione espone parametri avanzati che non sono accessibili dall’interfaccia utente. In questo articolo esploreremo in dettaglio la struttura del file, le variabili più importanti e le personalizzazioni avanzate che possono fare la differenza nelle prestazioni del tuo sito.

Dove Si Trova il File

Il file wp-cache-config.php si trova nella directory wp-content/ del tuo sito WordPress, allo stesso livello dei plugin e dei temi. Il percorso completo è tipicamente:

/var/www/html/wp-content/wp-cache-config.php

Questo file viene creato automaticamente da WP Super Cache durante l’installazione e viene aggiornato ogni volta che modifichi le impostazioni dall’interfaccia del plugin. Tuttavia, può anche essere modificato manualmente per accedere a parametri non esposti nell’interfaccia grafica.

Attenzione: Prima di modificare manualmente questo file, crea sempre un backup. Un errore di sintassi PHP nel file può causare un errore fatale che impedisce il caricamento del sito. Inoltre, le modifiche manuali potrebbero essere sovrascritte se salvi le impostazioni dall’interfaccia del plugin.

Struttura del File

Il file wp-cache-config.php è un file PHP che definisce una serie di variabili globali utilizzate da WP Super Cache durante l’elaborazione delle richieste. Le variabili sono organizzate in sezioni logiche:

• Variabili di stato: Abilitazione/disabilitazione del caching
• Variabili di percorso: Directory della cache, percorsi dei file
• Variabili di comportamento: Modalità di caching, compressione, timeout
• Array di esclusione: URL, cookie, user agent da escludere
• Variabili CDN: Configurazione della Content Delivery Network
• Variabili di preload: Configurazione del pre-caricamento della cache

Variabili Principali di Stato

Le variabili di stato controllano se e come il caching è attivo:

$cache_enabled (true/false): L’interruttore principale del caching. Quando è false, nessuna pagina viene cachata o servita dalla cache. Corrisponde all’opzione “Caching On/Off” nella tab Easy.

$super_cache_enabled (true/false): Abilita la generazione dei file supercache (file HTML statici nella directory supercache). Se false, vengono generati solo i file WP-Cache (meno performanti).

$wp_cache_mod_rewrite (0 o 1): Determina se la modalità Expert (mod_rewrite) è attiva. Quando è 1, WP Super Cache si aspetta che le regole mod_rewrite nel file .htaccess servano direttamente i file supercache.

$wp_cache_not_logged_in (0 o 2): Controlla il caching per gli utenti loggati. Il valore 2 indica “Don’t cache pages for known users” attivo. Il valore 0 permette il caching anche per gli utenti autenticati.

Variabili di Percorso

$cache_path: Il percorso assoluto della directory cache. Per impostazione predefinita, punta a wp-content/cache/. Puoi modificare questo percorso per spostare la cache su un disco più veloce (SSD, ramdisk) o su una partizione separata.

$file_prefix: Il prefisso dei file WP-Cache. Per impostazione predefinita è wp-cache-. Può essere utile modificarlo in installazioni multisite per evitare collisioni tra i file cache di siti diversi.

$blog_cache_dir: La directory specifica del blog all’interno del percorso cache. In installazioni single-site, tipicamente è uguale a $cache_path.

Variabili di Comportamento

$cache_max_time (secondi): Il tempo di scadenza della cache. I file più vecchi di questo valore verranno rimossi dalla Garbage Collection. Il valore 0 disabilita la scadenza automatica.

$cache_schedule_type (’interval’ o ’time’): Il tipo di pianificazione della Garbage Collection. ’interval’ esegue la pulizia a intervalli regolari, ’time’ a un orario specifico.

$cache_time_interval (secondi): L’intervallo tra le esecuzioni della Garbage Collection quando $cache_schedule_type è ’interval’.

$cache_compression (0 o 1): Abilita la compressione gzip delle pagine cached. Quando è 1, WP Super Cache genera anche versioni compresse dei file.

$cache_rebuild_files (0 o 1): Quando è 1, se una pagina cached scade mentre viene richiesta, WP Super Cache serve la versione scaduta mentre genera quella nuova in background. Questo evita che i visitatori debbano attendere la rigenerazione della cache.

$wp_cache_hello_world (0 o 1): Quando è 1, WP Super Cache aggiunge un commento HTML alla fine delle pagine cached indicando che la pagina è stata servita dalla cache e il timestamp di generazione. Utile per il debug, può essere disabilitato in produzione per risparmiare qualche byte.

Array di Esclusione

Gli array di esclusione definiscono le regole per impedire il caching di specifiche richieste:

$cache_rejected_uri (array): Elenco di stringhe URL da escludere dalla cache. Ogni stringa viene confrontata con l’URI della richiesta. Esempio: array(’cart/’, ’checkout/’, ’my-account/’).

$cache_rejected_user_agent (array): Elenco di stringhe User Agent da escludere. Le richieste il cui User Agent contiene una di queste stringhe non verranno cachate.

$cache_acceptable_files (array): Elenco di tipi di file che possono essere cachati. Per impostazione predefinita include wp-comments-popup.php e wp-links-opml.php.

$cache_rejected_cookies (array): Elenco di nomi di cookie che, se presenti nella richiesta, impediscono il servizio dalla cache.

Variabili CDN

$wp_cache_cdn_enabled (0 o 1): Abilita la riscrittura degli URL per la CDN.

$ossdl_off_cdn_url (stringa): L’URL base della CDN. Esempio: https://cdn.tuosito.it.

$ossdl_off_blog_url (stringa): L’URL del sito originale. Gli URL che iniziano con questo valore verranno riscritti con l’URL CDN.

$ossdl_off_include_dirs (stringa): Directory il cui contenuto deve essere servito dalla CDN, separate da virgola. Esempio: wp-content,wp-includes.

$ossdl_off_exclude (stringa): Estensioni o stringhe da escludere dalla riscrittura CDN. Esempio: .php.

$ossdl_cname (stringa): CNAME aggiuntivi per distribuire le richieste su più endpoint CDN, separati da virgola.

Variabili di Preload

$wp_cache_preload_on (0 o 1): Abilita il preload automatico della cache.

$wp_cache_preload_interval (minuti): L’intervallo tra i cicli di preload. 0 per un singolo preload senza ripetizione.

$wp_cache_preload_posts (’all’ o numero): Il numero di post da pre-caricare per ciclo. ’all’ per tutti i post, un numero per limitare il batch.

$wp_cache_preload_taxonomies (0 o 1): Se pre-caricare anche le pagine di tassonomia (categorie, tag).

$wp_cache_preload_email_me (0 o 1): Se inviare una notifica email al completamento del preload.

$wp_cache_preload_email_volume (’none’, ’less’, ’medium’, ’many’): Il livello di dettaglio delle notifiche email del preload.

Personalizzazioni Avanzate

Oltre alle variabili standard, il file wp-cache-config.php può essere utilizzato per personalizzazioni più avanzate:

Cache su RAM disk: Spostare la directory cache su un RAM disk (tmpfs) per prestazioni ancora superiori. Crea un mount point tmpfs e modifica $cache_path per puntare a quella directory. Attenzione: la cache verrà persa al riavvio del server.

Cache separata per mobile: La variabile $wp_cache_mobile_enabled e $wp_cache_mobile_browsers permettono di servire versioni cached separate per dispositivi mobili. Questo è utile solo se il tema non è responsive e serve HTML diverso su mobile.

Late init: La variabile $wp_super_cache_late_init, se impostata a 1, fa sì che WP Super Cache si inizializzi più tardi nel processo di caricamento di WordPress, permettendo ad altri plugin di interagire con il caching.

Il File advanced-cache.php

Strettamente correlato a wp-cache-config.php è il file wp-content/advanced-cache.php. Questo è un file “drop-in” di WordPress che viene caricato molto presto nel processo di bootstrap, prima di qualsiasi plugin. WP Super Cache utilizza questo file come punto di ingresso per il caching in modalità Simple.

Il file advanced-cache.php:

• Viene caricato da WordPress quando la costante WP_CACHE è impostata su true in wp-config.php
• Include wp-cache-config.php per leggere la configurazione
• Verifica se esiste una versione cached della pagina richiesta
• Se la cache è valida, serve il file e termina l’esecuzione (WordPress non viene caricato completamente)
• Se la cache non è disponibile, lascia che WordPress prosegua normalmente e intercetta l’output per salvarlo nella cache

Non modificare mai advanced-cache.php manualmente. Questo file viene generato e gestito automaticamente da WP Super Cache. Se devi personalizzare il comportamento del caching, usa wp-cache-config.php o i filtri/hook PHP nel file functions.php del tema.

Hook e Filtri per Personalizzazioni

WP Super Cache espone diversi hook WordPress che permettono di personalizzare il comportamento senza modificare i file del plugin:

Filtri per l’output:

• wp_cache_ob_callback_filter: Filtra l’HTML prima che venga salvato nella cache. Utile per aggiungere commenti, modificare contenuto o implementare logiche personalizzate

Azioni per eventi della cache:

• wp_cache_cleared: Eseguito quando la cache viene svuotata. Utile per invalidare cache esterne o notificare altri sistemi
• gc_cache: Eseguito durante la Garbage Collection

Filtri per l’esclusione:

• Puoi aggiungere logica personalizzata per escludere pagine dalla cache basandoti su criteri complessi (es. contenuto della pagina, parametri della richiesta, stato dell’utente)

Backup e Ripristino della Configurazione

È buona pratica eseguire un backup del file wp-cache-config.php prima di apportare modifiche significative. Ecco una procedura consigliata:

1. Copia il file corrente con un suffisso data (es. wp-cache-config.php.2026-05-26.bak)
2. Apporta le modifiche desiderate
3. Testa il sito per verificare che le modifiche funzionino come previsto
4. Se ci sono problemi, ripristina il file dal backup
5. Dopo aver verificato che tutto funzioni, puoi rimuovere il backup

Se il file viene corrotto o contiene errori di sintassi, la soluzione più rapida è eliminarlo e salvare nuovamente le impostazioni dall’interfaccia del plugin: WP Super Cache rigenererà automaticamente un file di configurazione valido con le impostazioni correnti.

Configurazione per Installazioni Multisite

In installazioni WordPress Multisite, wp-cache-config.php contiene variabili aggiuntive per gestire le specificità del multisite:

• $wp_cache_blogs: Array che mappa gli ID dei blog ai loro percorsi
• $wp_cache_mutex_disabled: Disabilita il mutex (utile per evitare problemi di lock su server con molti siti)

In un ambiente multisite, è importante che ogni sito abbia la propria directory cache separata per evitare che le pagine di un sito vengano servite a visitatori di un altro sito.

Conclusioni

Il file wp-cache-config.php offre un livello di controllo sulla cache che va ben oltre le opzioni disponibili nell’interfaccia grafica di WP Super Cache. Comprendere le variabili principali e sapere come modificarle può fare la differenza in scenari complessi, come installazioni multisite, server ad alte prestazioni o siti con requisiti particolari. Tuttavia, per la maggior parte dei siti, le impostazioni accessibili dall’interfaccia del plugin sono più che sufficienti, e la modifica manuale del file di configurazione dovrebbe essere riservata a situazioni specifiche in cui l’interfaccia non offre le opzioni necessarie.

Hai bisogno di una configurazione avanzata personalizzata per il tuo sito? Il team di G Tech Group può ottimizzare ogni parametro di WP Super Cache per le tue esigenze specifiche. Scopri anche le nostre soluzioni di hosting WordPress professionale con configurazione cache avanzata e supporto tecnico dedicato.

Migliora il Tuo Sito WordPress

Scopri le nostre guide complete sugli altri plugin essenziali per WordPress:

• Come Installare Elementor su WordPress
• Come Installare e Configurare WP Rocket
• Come Installare e Configurare SEOPress
• Come Installare e Configurare UpdraftPlus