5. Definizioni dei campi di intestazione
Questa sezione definisce la sintassi e la semantica dei campi di intestazione HTTP/1.1 relativi alla memorizzazione in cache.
5.1. Age
Il campo di intestazione "Age" comunica la stima del mittente del tempo trascorso da quando la risposta è stata generata o validata con successo sul server di origine. I valori di Age sono calcolati come specificato nella sezione 4.2.3.
Age = delta-seconds
Il valore del campo Age è un intero non negativo che rappresenta un tempo in secondi (vedere la sezione 1.2.1).
La presenza di un campo di intestazione Age implica che la risposta non è stata generata o validata dal server di origine per questa richiesta. Tuttavia, l'assenza di un campo di intestazione Age non implica che l'origine sia stata contattata, poiché la risposta potrebbe essere stata ricevuta da una cache HTTP/1.0 che non implementa Age.
5.2. Cache-Control
Il campo di intestazione "Cache-Control" serve a specificare direttive per le cache lungo la catena richiesta/risposta. Tali direttive di cache sono unidirezionali, nel senso che la presenza di una direttiva in una richiesta non implica che la stessa direttiva debba essere data nella risposta.
Una cache MUST obbedire ai requisiti delle direttive Cache-Control definite in questa sezione. Per informazioni su come vengono gestite le direttive Cache-Control definite altrove, vedere la sezione 5.2.3.
Nota: Alcune cache HTTP/1.0 potrebbero non implementare Cache-Control.
Un proxy, indipendentemente dal fatto che implementi o meno una cache, MUST far passare le direttive di cache nei messaggi inoltrati, a prescindere dalla loro importanza per tale applicazione, poiché le direttive possono essere applicabili a tutti i destinatari lungo la catena richiesta/risposta. Non è possibile indirizzare una direttiva a una cache specifica.
Le direttive di cache sono identificate da un token, da confrontare senza distinguere le maiuscole/minuscole, e hanno un argomento opzionale, che può usare sia la sintassi token sia quella quoted-string. Per le direttive definite di seguito che definiscono argomenti, i destinatari dovrebbero accettare entrambe le forme, anche se una è documentata come preferibile. Per qualsiasi direttiva non definita da questa specifica, un destinatario MUST accettare entrambe le forme.
Cache-Control = 1#cache-directive
cache-directive = token [ "=" ( token / quoted-string ) ]
Per le direttive di cache definite di seguito, nessun argomento è definito (né consentito) salvo diversa indicazione.
5.2.1. Direttive di cache della richiesta
5.2.1.1. max-age
Sintassi dell'argomento: delta-seconds (vedere la sezione 1.2.1)
La direttiva di richiesta "max-age" indica che il client non è disposto ad accettare una risposta la cui età sia maggiore del numero di secondi specificato. A meno che non sia presente anche la direttiva di richiesta max-stale, il client non è disposto ad accettare una risposta obsoleta.
Questa direttiva usa la forma token della sintassi dell'argomento: ad esempio 'max-age=5' e non 'max-age="5"'. Un mittente SHOULD NOT generare la forma quoted-string.
5.2.1.2. max-stale
Sintassi dell'argomento: delta-seconds (vedere la sezione 1.2.1)
La direttiva di richiesta "max-stale" indica che il client è disposto ad accettare una risposta che ha superato la sua durata di freschezza. Se a max-stale viene assegnato un valore, il client è disposto ad accettare una risposta che ha superato la sua durata di freschezza di non più del numero di secondi specificato. Se a max-stale non viene assegnato alcun valore, il client è disposto ad accettare una risposta obsoleta di qualsiasi età.
Questa direttiva usa la forma token della sintassi dell'argomento: ad esempio 'max-stale=10' e non 'max-stale="10"'. Un mittente SHOULD NOT generare la forma quoted-string.
5.2.1.3. min-fresh
Sintassi dell'argomento: delta-seconds (vedere la sezione 1.2.1)
La direttiva di richiesta "min-fresh" indica che il client è disposto ad accettare una risposta la cui durata di freschezza non sia inferiore alla sua età corrente più il tempo specificato in secondi. Ossia, il client desidera una risposta che rimarrà fresca per almeno il numero di secondi specificato.
Questa direttiva usa la forma token della sintassi dell'argomento: ad esempio 'min-fresh=20' e non 'min-fresh="20"'. Un mittente SHOULD NOT generare la forma quoted-string.
5.2.1.4. no-cache
La direttiva di richiesta "no-cache" indica che una cache MUST NOT usare una risposta archiviata per soddisfare la richiesta senza una validazione riuscita sul server di origine.
5.2.1.5. no-store
La direttiva di richiesta "no-store" indica che una cache MUST NOT archiviare alcuna parte di questa richiesta né di qualsiasi risposta ad essa. Questa direttiva si applica sia alle cache private sia a quelle condivise. "MUST NOT archiviare" in questo contesto significa che la cache MUST NOT archiviare intenzionalmente le informazioni in memoria non volatile e MUST fare ogni sforzo per rimuovere le informazioni dalla memoria volatile il prima possibile dopo averle inoltrate.
Questa direttiva NON è un meccanismo affidabile o sufficiente per garantire la privacy. In particolare, cache malevole o compromesse potrebbero non riconoscere o non obbedire a questa direttiva, e le reti di comunicazione potrebbero essere vulnerabili all'intercettazione.
Si noti che, se una richiesta contenente questa direttiva viene soddisfatta da una cache, la direttiva di richiesta no-store non si applica alla risposta già archiviata.
5.2.1.6. no-transform
La direttiva di richiesta "no-transform" indica che un intermediario (indipendentemente dal fatto che implementi una cache) MUST NOT trasformare il payload, come definito nella sezione 5.7.2 di [RFC7230].
5.2.1.7. only-if-cached
La direttiva di richiesta "only-if-cached" indica che il client desidera ottenere solo una risposta archiviata. Se riceve questa direttiva, una cache SHOULD rispondere usando una risposta archiviata coerente con gli altri vincoli della richiesta, oppure rispondere con il codice di stato 504 (Gateway Timeout). Se un gruppo di cache è gestito come sistema unificato con buona connettività interna, una cache membro MAY inoltrare tale richiesta all'interno di quel gruppo di cache.
5.2.2. Direttive di cache della risposta
5.2.2.1. must-revalidate
La direttiva di risposta "must-revalidate" indica che, una volta diventata obsoleta, una cache MUST NOT usare la risposta per soddisfare richieste successive senza una validazione riuscita sul server di origine.
La direttiva must-revalidate è necessaria per supportare un funzionamento affidabile di determinate funzionalità del protocollo. In ogni circostanza una cache MUST obbedire alla direttiva must-revalidate; in particolare, se una cache non riesce a raggiungere il server di origine per qualsiasi motivo, MUST generare una risposta 504 (Gateway Timeout).
La direttiva must-revalidate dovrebbe essere usata dai server se e solo se il mancato completamento della validazione di una richiesta sulla rappresentazione potrebbe causare un funzionamento errato, come una transazione finanziaria silenziosamente non eseguita.
5.2.2.2. no-cache
Sintassi dell'argomento: #field-name
La direttiva di risposta "no-cache" indica che la risposta MUST NOT essere usata per soddisfare una richiesta successiva senza una validazione riuscita sul server di origine. Ciò consente a un server di origine di impedire a una cache di usarla per soddisfare una richiesta senza contattarlo, anche nel caso di cache configurate per inviare risposte obsolete.
Se la direttiva di risposta no-cache specifica uno o più field-name, una cache MAY usare la risposta per soddisfare una richiesta successiva, fatti salvi gli altri vincoli sulla memorizzazione in cache. Tuttavia, i campi di intestazione della risposta che hanno il o i field-name elencati MUST NOT essere inviati nella risposta a una richiesta successiva senza una rivalidazione riuscita con il server di origine. Ciò consente a un server di origine di impedire il riutilizzo di determinati campi di intestazione in una risposta, permettendo comunque la memorizzazione in cache del resto della risposta.
I field-name forniti non sono limitati all'insieme dei campi di intestazione definiti da questa specifica. I nomi dei campi non sono sensibili alle maiuscole/minuscole.
Questa direttiva usa la forma quoted-string della sintassi dell'argomento. Un mittente SHOULD NOT generare la forma token (anche se le virgolette sembrano non essere necessarie per elenchi a voce singola).
Nota: sebbene sia stata retroportata in molte implementazioni, alcune cache HTTP/1.0 non riconosceranno o non obbediranno a questa direttiva. Inoltre, le direttive di risposta no-cache con field-name sono spesso gestite dalle cache come se fosse stata ricevuta una direttiva no-cache non qualificata; ossia, la gestione speciale della forma qualificata non è ampiamente implementata.
5.2.2.3. no-store
La direttiva di risposta "no-store" indica che una cache MUST NOT archiviare alcuna parte della richiesta immediata o della risposta. Questa direttiva si applica sia alle cache private sia a quelle condivise. "MUST NOT archiviare" in questo contesto significa che la cache MUST NOT archiviare intenzionalmente le informazioni in memoria non volatile e MUST fare ogni sforzo per rimuovere le informazioni dalla memoria volatile il prima possibile dopo averle inoltrate.
Questa direttiva NON è un meccanismo affidabile o sufficiente per garantire la privacy. In particolare, cache malevole o compromesse potrebbero non riconoscere o non obbedire a questa direttiva, e le reti di comunicazione potrebbero essere vulnerabili all'intercettazione.
5.2.2.4. no-transform
La direttiva di risposta "no-transform" indica che un intermediario (indipendentemente dal fatto che implementi una cache) MUST NOT trasformare il payload, come definito nella sezione 5.7.2 di [RFC7230].
5.2.2.5. public
La direttiva di risposta "public" indica che qualsiasi cache MAY archiviare la risposta, anche se la risposta sarebbe normalmente non memorizzabile in cache o memorizzabile solo in una cache privata. (Vedere la sezione 3.2 per ulteriori dettagli relativi all'uso di public in risposta a una richiesta contenente Authorization, e la sezione 3 per i dettagli su come public influenzi le risposte che normalmente non verrebbero archiviate, perché i loro codici di stato non sono definiti come memorizzabili in cache per impostazione predefinita; vedere la sezione 4.2.2.)
5.2.2.6. private
Sintassi dell'argomento: #field-name
La direttiva di risposta "private" indica che il messaggio di risposta è destinato a un singolo utente e MUST NOT essere archiviato da una cache condivisa. Una cache privata MAY archiviare la risposta e riutilizzarla per richieste successive, anche se la risposta sarebbe normalmente non memorizzabile in cache.
Se la direttiva di risposta private specifica uno o più field-name, questo requisito è limitato ai valori dei campi associati ai campi di intestazione di risposta elencati. Ossia, una cache condivisa MUST NOT archiviare i field-name specificati, mentre MAY archiviare il resto del messaggio di risposta.
I field-name forniti non sono limitati all'insieme dei campi di intestazione definiti da questa specifica. I nomi dei campi non sono sensibili alle maiuscole/minuscole.
Questa direttiva usa la forma quoted-string della sintassi dell'argomento. Un mittente SHOULD NOT generare la forma token (anche se le virgolette sembrano non essere necessarie per elenchi a voce singola).
Nota: questo uso della parola "private" controlla solo dove la risposta può essere archiviata; non può garantire la riservatezza del contenuto del messaggio. Inoltre, le direttive di risposta private con field-name sono spesso gestite dalle cache come se fosse stata ricevuta una direttiva private non qualificata; ossia, la gestione speciale della forma qualificata non è ampiamente implementata.
5.2.2.7. proxy-revalidate
La direttiva di risposta "proxy-revalidate" ha lo stesso significato della direttiva di risposta must-revalidate, tranne per il fatto che non si applica alle cache private.
5.2.2.8. max-age
Sintassi dell'argomento: delta-seconds (vedere la sezione 1.2.1)
La direttiva di risposta "max-age" indica che la risposta deve essere considerata obsoleta dopo che la sua età è maggiore del numero di secondi specificato.
Questa direttiva usa la forma token della sintassi dell'argomento: ad esempio 'max-age=5' e non 'max-age="5"'. Un mittente SHOULD NOT generare la forma quoted-string.
5.2.2.9. s-maxage
Sintassi dell'argomento: delta-seconds (vedere la sezione 1.2.1)
La direttiva di risposta "s-maxage" indica che, nelle cache condivise, l'età massima specificata da questa direttiva sostituisce l'età massima specificata dalla direttiva max-age o dal campo di intestazione Expires. La direttiva s-maxage implica anche la semantica della direttiva di risposta proxy-revalidate.
Questa direttiva usa la forma token della sintassi dell'argomento: ad esempio 's-maxage=10' e non 's-maxage="10"'. Un mittente SHOULD NOT generare la forma quoted-string.
5.2.3. Estensioni di controllo della cache
Il campo di intestazione Cache-Control può essere esteso mediante l'uso di uno o più token cache-extension, ciascuno con un valore opzionale. Una cache MUST ignorare le direttive di cache non riconosciute.
Le estensioni informative (quelle che non richiedono un cambiamento del comportamento della cache) possono essere aggiunte senza modificare la semantica delle altre direttive.
Le estensioni comportamentali sono progettate per funzionare come modificatori della base esistente di direttive di cache. Vengono fornite sia la nuova sia la vecchia direttiva, cosicché le applicazioni che non comprendono la nuova direttiva adotteranno per impostazione predefinita il comportamento specificato dalla vecchia direttiva, e quelle che comprendono la nuova direttiva la riconosceranno come modifica dei requisiti associati alla vecchia direttiva. In questo modo si possono apportare estensioni alle direttive di controllo della cache esistenti senza rompere le cache già distribuite.
Ad esempio, si consideri una nuova ipotetica direttiva di risposta chiamata "community" che agisce come modificatore della direttiva private: oltre alle cache private, qualsiasi cache condivisa solo dai membri della community nominata è autorizzata a memorizzare la risposta in cache. Un server di origine che desideri consentire alla community UCI di usare una risposta altrimenti privata nelle proprie cache condivise potrebbe farlo includendo
Cache-Control: private, community="UCI"
Una cache che riconosce tale estensione di cache community potrebbe ampliare il proprio comportamento in conformità a tale estensione. Una cache che non riconosce l'estensione di cache community la ignorerebbe e si atterrebbe alla direttiva private.
5.3. Expires
Il campo di intestazione "Expires" indica la data/ora dopo la quale la risposta è considerata obsoleta. Per un'ulteriore discussione del modello di freschezza, vedere la sezione 4.2.
La presenza di un campo Expires non implica che la risorsa originale cambierà o cesserà di esistere in quel momento, prima o dopo.
Il valore di Expires è un timestamp HTTP-date, come definito nella sezione 7.1.1.1 di [RFC7231].
Expires = HTTP-date
Ad esempio
Expires: Thu, 01 Dec 1994 16:00:00 GMT
Un destinatario della cache MUST interpretare i formati di data non validi, in particolare il valore "0", come rappresentanti un tempo nel passato (ossia "già scaduto").
Se una risposta include un campo Cache-Control con la direttiva max-age (sezione 5.2.2.8), un destinatario MUST ignorare il campo Expires. Analogamente, se una risposta include la direttiva s-maxage (sezione 5.2.2.9), un destinatario di cache condivisa MUST ignorare il campo Expires. In entrambi i casi, il valore in Expires è destinato solo ai destinatari che non hanno ancora implementato il campo Cache-Control.
Un server di origine privo di orologio MUST NOT generare un campo Expires, a meno che il suo valore non rappresenti un tempo fisso nel passato (sempre scaduto) o che il suo valore non sia stato associato alla risorsa da un sistema o un utente con un orologio affidabile.
Storicamente, HTTP richiedeva che il valore del campo Expires non superasse di un anno il futuro. Sebbene durate di freschezza più lunghe non siano più vietate, valori estremamente grandi si sono dimostrati causa di problemi (ad esempio overflow dell'orologio dovuti all'uso di interi a 32 bit per i valori di tempo), e molte cache espelleranno una risposta molto prima di allora.
5.4. Pragma
Il campo di intestazione "Pragma" consente la compatibilità all'indietro con le cache HTTP/1.0, cosicché i client possono specificare una richiesta "no-cache" che esse comprenderanno (poiché Cache-Control non fu definito prima di HTTP/1.1). Quando il campo di intestazione Cache-Control è presente e compreso in una richiesta, Pragma viene ignorato.
In HTTP/1.0, Pragma era definito come campo estensibile per direttive specificate dall'implementazione destinate ai destinatari. Questa specifica depreca tali estensioni per migliorare l'interoperabilità.
Pragma = 1#pragma-directive
pragma-directive = "no-cache" / extension-pragma
extension-pragma = token [ "=" ( token / quoted-string ) ]
Quando il campo di intestazione Cache-Control non è presente in una richiesta, le cache MUST considerare la pragma-directive di richiesta no-cache come avente lo stesso effetto che se fosse presente "Cache-Control: no-cache" (vedere la sezione 5.2.1).
Quando invia una richiesta no-cache, un client dovrebbe includere sia la direttiva pragma sia quella cache-control, a meno che Cache-Control: no-cache non sia deliberatamente omesso per indirizzare altre direttive di risposta Cache-Control alle cache HTTP/1.1. Ad esempio:
GET / HTTP/1.1
Host: www.example.com
Cache-Control: max-age=30
Pragma: no-cache
vincolerà le cache HTTP/1.1 a servire una risposta non più vecchia di 30 secondi, impedendo al contempo alle implementazioni che non comprendono Cache-Control di servire una risposta in cache.
Nota: Poiché il significato di "Pragma: no-cache" nelle risposte non è specificato, esso non fornisce in esse un sostituto affidabile di "Cache-Control: no-cache".
5.5. Warning
Il campo di intestazione "Warning" serve a trasportare informazioni aggiuntive sullo stato o sulla trasformazione di un messaggio che potrebbero non essere riflesse nel codice di stato. Queste informazioni sono tipicamente usate per avvertire di possibili inesattezze introdotte da operazioni di memorizzazione in cache o da trasformazioni applicate al payload del messaggio.
Gli avvisi possono essere usati per altri scopi, sia legati alla cache sia no. L'uso di un avviso, anziché di un codice di stato di errore, distingue queste risposte da veri fallimenti.
I campi di intestazione Warning possono in generale essere applicati a qualsiasi messaggio; tuttavia alcuni warn-code sono specifici delle cache e possono essere applicati solo ai messaggi di risposta.
Warning = 1#warning-value
warning-value = warn-code SP warn-agent SP warn-text
[ SP warn-date ]
warn-code = 3DIGIT
warn-agent = ( uri-host [ ":" port ] ) / pseudonym
; the name or pseudonym of the server adding
; the Warning header field, for use in debugging
; a single "-" is recommended when agent unknown
warn-text = quoted-string
warn-date = DQUOTE HTTP-date DQUOTE
In una risposta è possibile generare più avvisi (dal server di origine o da una cache), compresi più avvisi con lo stesso numero di warn-code che differiscono solo nel warn-text.
Uno user agent che riceve uno o più campi di intestazione Warning SHOULD informare l'utente del maggior numero possibile di essi, nell'ordine in cui appaiono nella risposta. I mittenti che generano più campi di intestazione Warning sono incoraggiati a ordinarli tenendo presente questo comportamento dello user agent. Un mittente che genera nuovi campi di intestazione Warning MUST aggiungerli dopo qualsiasi campo di intestazione Warning esistente.
Agli avvisi vengono assegnati warn-code di tre cifre. La prima cifra indica se l'avviso deve essere eliminato da una risposta archiviata dopo la validazione:
-
I warn-code 1xx descrivono lo stato di freschezza o di validazione della risposta, e quindi MUST essere eliminati da una cache dopo la validazione. Possono essere generati da una cache solo durante la validazione di una voce in cache, e MUST NOT essere generati in qualsiasi altra situazione.
-
I warn-code 2xx descrivono un aspetto della rappresentazione che non viene corretto da una validazione (ad esempio una compressione con perdita della rappresentazione) e MUST NOT essere eliminati da una cache dopo la validazione, a meno che non venga inviata una risposta completa, nel qual caso MUST esserlo.
Se un mittente genera uno o più warn-code 1xx in un messaggio da inviare a un destinatario noto per implementare solo HTTP/1.0, il mittente MUST includere in ogni corrispondente warning-value un warn-date che corrisponda al campo di intestazione Date nel messaggio. Ad esempio:
HTTP/1.1 200 OK
Date: Sat, 25 Aug 2012 23:34:45 GMT
Warning: 112 - "network down" "Sat, 25 Aug 2012 23:34:45 GMT"
Gli avvisi hanno un warn-text di accompagnamento che descrive l'errore, ad esempio per la registrazione nei log. È solo consultivo e il suo contenuto non influisce sull'interpretazione del warn-code.
Se un destinatario che usa, valuta o visualizza campi di intestazione Warning riceve un warn-date diverso dal valore Date nello stesso messaggio, il destinatario MUST escludere il warning-value contenente quel warn-date prima di archiviare, inoltrare o usare il messaggio. Ciò consente ai destinatari di escludere warning-value che sono stati conservati in modo improprio dopo una validazione della cache. Se tutti i warning-value sono esclusi, il destinatario MUST escludere anche il campo di intestazione Warning.
I seguenti warn-code sono definiti da questa specifica, ciascuno con un warn-text raccomandato in inglese e una descrizione del suo significato. La procedura per definire warn-code aggiuntivi è descritta nella sezione 7.2.1.
5.5.1. Warning: 110 - "Response is Stale"
Una cache SHOULD generarlo ogni volta che la risposta inviata è obsoleta.
5.5.2. Warning: 111 - "Revalidation Failed"
Una cache SHOULD generarlo quando invia una risposta obsoleta perché un tentativo di validare la risposta è fallito, a causa dell'impossibilità di raggiungere il server.
5.5.3. Warning: 112 - "Disconnected Operation"
Una cache SHOULD generarlo se è intenzionalmente disconnessa dal resto della rete per un certo periodo di tempo.
5.5.4. Warning: 113 - "Heuristic Expiration"
Una cache SHOULD generarlo se ha scelto euristicamente una durata di freschezza superiore a 24 ore e l'età della risposta è superiore a 24 ore.
5.5.5. Warning: 199 - "Miscellaneous Warning"
Il testo dell'avviso può includere informazioni arbitrarie da presentare a un utente umano o da registrare nei log. Un sistema che riceve questo avviso MUST NOT intraprendere alcuna azione automatizzata, oltre a presentare l'avviso all'utente.
5.5.6. Warning: 214 - "Transformation Applied"
Questo codice Warning MUST essere aggiunto da un proxy se applica qualsiasi trasformazione alla rappresentazione, come cambiare il content-coding, il media-type o modificare i dati della rappresentazione, a meno che questo codice Warning non appaia già nella risposta.
5.5.7. Warning: 299 - "Miscellaneous Persistent Warning"
Il testo dell'avviso può includere informazioni arbitrarie da presentare a un utente umano o da registrare nei log. Un sistema che riceve questo avviso MUST NOT intraprendere alcuna azione automatizzata.