Guide pratiche

configurare la memorizzazione nella cache HTTP senza esporre i dati privati

La memorizzazione nella cache aiuta solo quando la risposta riutilizzata è appropriata per il visitatore e l'ora di accesso. Una singola politica per ogni risorsa può nascondere un aggiornamento o esporre una risposta personalizzata.

vedere il metodo

Illustrazione — configurare la memorizzazione nella cache HTTP senza esporre i dati privati
Illustrazione generata dall’IA

Classifica le risposte prima di scegliere una vita

Pagine pubbliche di inventario, asset statici, risposte API, account e conferme. Registra se ogni modifica con l'utente, la lingua o un parametro. Identificare il browser, gli intermediari e le cache CDN. Una pagina dell'account non dovrebbe ereditare la politica di una fotografia pubblica semplicemente perché tale politica è facile da applicare.

distinguere la freschezza dal permesso di memorizzare una risposta. MDN spiega che l'assenza di cache richiede una riconvalida, mentre nessun archivio richiede alcuna archiviazione. Private Limita l'archiviazione alle cache private. Un cookie da solo non rende automaticamente una risposta privata.

Pianifica come diventa visibile un aggiornamento

Scrivi una regola di aggiornamento per ogni famiglia. Per un file con versioni, confermare che la nuova pagina richieda il nuovo URL. Per una pagina pubblica con un indirizzo stabile, descrivi la riconvalida o l'eliminazione. Una lunga durata senza una procedura di sostituzione sposta solo il problema alla successiva modifica del contenuto.

Scegli un esempio pratico: una correzione del prezzo, orari di apertura o un documento sostituito. Registra quando l'origine cambia, quindi ispeziona una sessione che ha già visitato la pagina. Un nuovo browser da solo non copre un visitatore di ritorno che mantiene una risposta precedente.

Durante la rivalidazione, il browser può inviare in If-None-Match l’ETag della copia conservata. Se la rappresentazione corrisponde ancora, una risposta 304 consente di riutilizzare il corpo già salvato; non trasmette un nuovo corpo della pagina. Se è cambiata, una risposta completa 200 può fornire contenuto e nuovo validatore. Il solo codice non descrive quindi ciò che il visitatore vede alla fine.

Se la prima risposta contiene Last-Modified, copia la data senza modificarla in If-Modified-Since e invia una seconda GET allo stesso URL. Un 304 indica che la data di modifica del server non è successiva a quella inviata. Se il server distribuisce due versioni nello stesso secondo, la data può coincidere anche se il contenuto è cambiato. Usa un ETag che distingua le versioni quando serve questa precisione. Se la richiesta contiene entrambi i campi condizionali, ha la precedenza If-None-Match.

La tabella usa i validatori fittizi demo-v1 e demo-v2 per distinguere le fasi, senza misurare questo sito. Conservate insieme richiesta condizionale, risposta, copia riutilizzata e correzione visualizzata. Un ETag è un identificatore opaco prodotto dal server, non necessariamente un’impronta o una data. Verificate anche Indietro: la cronologia può ripristinare un’istantanea con un meccanismo distinto dalla cache HTTP.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Esempio fittizio: seguire la rivalidazione fino al contenuto visualizzato
Situazione di provaScambio da collegareProva utile
Prima lettura200 con corpo ed ETag demo-v1.La copia iniziale contiene la versione prevista.
Rivalidazione senza modificheIf-None-Match demo-v1, poi 304.Si riutilizza il corpo conservato; non ne arriva uno nuovo.
Rappresentazione modificataIf-None-Match demo-v1, poi 200 con demo-v2.Il nuovo corpo viene ricevuto e la correzione è effettivamente visibile.
Risposta 304 osservata da solaLa risposta va collegata alla copia conservata.Il solo codice non dimostra recupero del contenuto o visualizzazione della variante corretta.

testare diverse identità e stati

In un ambiente di test, confronta una visita anonima, due account distinti, logout e navigazione indietro. Ispezionare il contenuto visualizzato e le intestazioni ricevute anziché solo la configurazione di hosting. Utilizzare record di test sintetici invece di documenti personali reali.

Includere gli stati di lingua, dispositivo, filtro e errore pertinenti. Mantieni l'URL, lo stato della sessione, la risposta prevista e il risultato per ogni test. Quando la personalizzazione passa attraverso una cache condivisa, chiedi al proprietario dell'infrastruttura di rivedere le chiavi e le esclusioni della cache.

Conserva una procedura di recupero

Documento che può eliminare la cache, verificarne l'effetto e ripristinare una configurazione precedente. Un'ampia epurazione può ridurre temporaneamente i benefici della memorizzazione nella cache, quindi preparare un controllo delle pagine essenziali dopo l'operazione.

Esamina la politica quando vengono introdotti account cliente, commercio, lingua o CDN. Un risultato utile è una matrice di risposta-politica-test-proprietario. Un solo punteggio di prestazione non stabilisce né freschezza né isolamento tra gli utenti.

Documentazione primaria: MDN : Caching HTTP.

Evitare che una cache condivisa distribuisca la variante sbagliata.

Caso fittizio: una URL serve due formati secondo un’intestazione. Provate entrambi dietro la cache reale e controllate la chiave di variazione, incluso Vary quando pertinente. Le edizioni editoriali possono richiedere URL distinte. La scelta esplicita deve rimanere accessibile.

  • Ogni richiesta riceve la variante corretta anche dopo l’altra e con cache attiva.
  • MDN Content Negotiation

    Guida alla scelta di rappresentazioni HTTP secondo lingua, formato, codifica o capacità del client.

Separare risposte personali nella cache

Due portatili con contrassegni colorati accanto a un router
Illustrazione generata dall’IA · Osserva separatamente i contenuti di due sessioni di prova.

Caso proposto: una conferma personale passa da una cache condivisa. Occorre verificare cosa riceve ciascuna sessione.

Usa due sessioni di prova isolate. Confronta richieste, intestazioni e contenuto; una regola generale non dimostra da sola la separazione osservata.

  • Aprire due sessioni isolate
  • Confrontare intestazioni e contenuto
  • Registrare la separazione

Documenti di riferimento

Contenuto aggiornato

Riferimenti documentati per questo argomento

Riferimenti documentati per questo argomento
RiferimentoValore o sintassiAmbito
HTTP · 304
If-None-Match → 304Con una richiesta GET o HEAD, una rappresentazione invariata può essere riutilizzata senza inviarne di nuovo il corpo.
MDN · Vary
Vary: Accept-LanguageSe un URL restituisce risposte diverse secondo Accept-Language, Vary indica questo criterio alla cache. Mantenga un valore coerente nelle risposte 200 e 304. URL distinti per lingua non richiedono questa intestazione solo perché il sito è multilingue.
HTTP · If-Match
If-Match: "r7" → 412If-Match confronta un validatore forte prima di scrivere. Nel contratto illustrato una versione superata riceve 412; conservare la bozza per confrontare le modifiche.

Le date indicano la consultazione delle fonti. Questi riferimenti non costituiscono un audit del sito né una dichiarazione globale di conformità.

Leggere una riconvalida della cache

Confronti un corpo sostituito e una copia riutilizzata. Gli estratti mostrano validatori e contenuto disponibile oltre al codice.

Gli estratti sono incompleti e usano indirizzi dimostrativi. La prova crea una Response in memoria: non contatta server né simula rete, cache o elaborazione operativa.

200Una nuova rappresentazione completa
Significato
Nel frammento il server risponde al GET condizionale con corpo JSON e validatore demo-v2.
Cosa verificare
Confronti If-None-Match, ETag e revisione del corpo. La prova locale analizza il JSON fornito nell’esempio.
Attenzione
Un 200 non garantisce JSON valido o dati operativi corretti. L’analisi riuscita non convalida lo schema dei propri dati.
Estratto di uno scambio fittizio
GET /demo/catalogue
If-None-Match: "demo-v1"

HTTP/1.1 200 OK
ETag: "demo-v2"
Content-Type: application/json

{"revision":"demo-v2"}

304Copia riconvalidata, nessun corpo nuovo
Significato
304 risponde a una richiesta condizionale: si può riutilizzare la rappresentazione conservata. Non fornisce un nuovo corpo.
Cosa verificare
Confronti il validatore inviato con la copia demo-v2 disponibile. L’interpretazione dipende anche dalla copia conservata.
Attenzione
La prova crea una Response 304 isolata, non una cache HTTP. Con un fetch reale il browser può fornire la risposta conservata: stato di rete e stato visto dallo script possono differire.
Estratto di uno scambio fittizio
GET /demo/catalogue
If-None-Match: "demo-v2"

HTTP/1.1 304 Not Modified
ETag: "demo-v2"

Riferimenti tecnici : RFC 9110 §15 · MDN · Response.ok · MDN · Response.json() · WHATWG · Fetch · .

Matrice di convalida funzionale per adattarsi al progetto

Questi controlli proposti utilizzano casi fittizi. Decidi quale comportamento è previsto con il team, annota il risultato e assegna discrepanze irrisolte prima della pubblicazione.

Scorri la tabella orizzontalmente per leggere tutte le colonne. Con la tastiera, porta il focus sulla tabella e usa i tasti freccia.

Casi di test, risultati attesi e prove utili
Casorisultato attesoProva da mantenere
Pagina pubblica invariataLa politica pubblicizzata e la risposta condizionale rimangono coerenti tra le richieste.Intestazioni, validatore e stato da entrambe le richieste, con lo stato del browser registrato.
Contenuto pubblico modificatoLa versione corretta arriva all'interno delle condizioni di freschezza definite.contenuti vecchi e nuovi, tempo di richiesta e intestazioni ricevute.
Due conti di provaUna risposta personalizzata per il primo account non viene mai servita al secondo.richieste e contenuti isolati ricevuti da ciascun account sintetico.
Esci e torna indietroIl comportamento dello schermo sensibile corrisponde al requisito di riservatezza documentato.Sequenza completa del browser e limitazioni esplicitamente registrate.

Domande frequenti

no-cache e no-store sono equivalenti?

No. Il primo richiede la convalida prima del riutilizzo; il secondo richiede che la risposta non venga archiviata. Scegli in base al contenuto e alle cache coinvolte, quindi testa i viaggi interessati.

Ogni risorsa dovrebbe condividere una durata della cache?

Una singola vita ignora le differenze tra i beni pubblici con versione, le pagine editoriali, i prezzi e le risposte personalizzate. Classifica le risposte, definisci il processo di aggiornamento e verifica gli stati di accesso prima di scegliere le vite.