Praktische gidsen

Configureer HTTP-caching zonder privégegevens te tonen

Caching helpt alleen wanneer de hergebruikte reactie geschikt is voor de bezoeker en het tijdstip van toegang. Een enkel beleid voor elke bron kan een update verbergen of een gepersonaliseerd antwoord blootleggen.

Zie de methode

Illustratie — Configureer HTTP-caching zonder privégegevens te tonen
AI-gegenereerde illustratie

Classificeer reacties voordat u een leven lang kiest

Openbare inventarisatiepagina's, statische activa, API-antwoorden, accounts en bevestigingen. Noteer of elk verandert met de gebruiker, taal of een parameter. Identificeer browser-, intermediair- en CDN-caches. Een accountpagina mag het beleid van een openbare foto niet erven alleen omdat dat beleid gemakkelijk toe te passen is.

Verse frisheid onderscheiden van toestemming om een reactie op te slaan. MDN legt uit dat No-Cache revalidatie vereist, terwijl No-Store geen opslag vraagt. Privé beperkt de opslag tot privécaches. Een cookie alleen maakt een reactie niet automatisch privé.

Plan hoe een update zichtbaar wordt

Schrijf een updateregel voor elk gezin. Voor een versiebestand, bevestigt u dat de nieuwe pagina om de nieuwe URL vraagt. Beschrijf voor een openbare pagina met een stabiel adres revalidatie of zuivering. Een lange levensduur zonder vervangingsprocedure verplaatst het probleem alleen naar de volgende inhoudswijziging.

Kies een praktijkvoorbeeld: een prijscorrectie, openingstijden of een vervangen document. Noteer wanneer de oorsprong verandert en inspecteer een sessie die de pagina al heeft bezocht. Een nieuwe browser alleen dekt geen terugkerende bezoeker die een eerdere reactie behoudt.

Bij hervalidatie kan de browser de ETag van de bewaarde kopie in If-None-Match meesturen. Komt de representatie nog overeen, dan staat een 304-antwoord hergebruik van de bewaarde inhoud toe; het levert geen nieuwe pagina-inhoud. Is de representatie gewijzigd, dan kan een volledig 200-antwoord de inhoud en nieuwe validator leveren. Een losse statuscode beschrijft dus niet wat de bezoeker uiteindelijk ziet.

Bevat het eerste antwoord Last-Modified, kopieer die datum dan ongewijzigd naar If-Modified-Since in een tweede GET naar dezelfde URL. Een 304 betekent dat de wijzigingsdatum van de server niet recenter is dan de meegestuurde datum. Verschijnen twee versies binnen dezelfde seconde, dan kan de datum gelijk blijven terwijl de inhoud verandert. Gebruik een ETag die de versies onderscheidt als die precisie van belang is. Bevat het verzoek beide voorwaardelijke velden, dan krijgt If-None-Match voorrang.

De tabel gebruikt fictieve validators demo-v1 en demo-v2 om stappen te onderscheiden, zonder deze website te meten. Bewaar het voorwaardelijke verzoek, antwoord, hergebruikte kopie en zichtbare correctie samen. Een ETag is een ondoorzichtige serveridentificatie, niet noodzakelijk een hash of datum. Test ook Terug: geschiedenis kan een momentopname herstellen via een ander mechanisme dan de HTTP-cache.

Schuif de tabel horizontaal om alle kolommen te lezen. Zet met het toetsenbord de focus op de tabel en gebruik de pijltjestoetsen.

Fictief voorbeeld: hervalidatie volgen tot de getoonde inhoud
TestsituatieTe koppelen uitwisselingNuttig bewijs
Eerste lezing200 met inhoud en ETag demo-v1.De eerste kopie bevat de verwachte versie.
Hervalidatie zonder wijzigingIf-None-Match demo-v1, daarna 304.De bewaarde inhoud wordt hergebruikt; er wordt geen nieuwe inhoud ontvangen.
Gewijzigde representatieIf-None-Match demo-v1, daarna 200 met demo-v2.De nieuwe inhoud wordt ontvangen en de correctie is werkelijk zichtbaar.
Los waargenomen 304-antwoordHet antwoord moet aan de bewaarde kopie worden gekoppeld.De code alleen bewijst geen inhoudsherstel of weergave van de juiste variant.

Test verschillende identiteiten en toestanden

Vergelijk in een testomgeving een anoniem bezoek, twee verschillende accounts, uitloggen en achternavigatie. Inspecteer de weergegeven inhoud en ontvangen koppen in plaats van alleen de hostingconfiguratie. Gebruik synthetische testrecords in plaats van echte persoonlijke documenten.

Voeg relevante taal, apparaat, filter en foutstatussen toe. Bewaar de URL, de sessiestatus, de verwachte respons en het resultaat voor elke test. Wanneer personalisatie door een gedeelde cache gaat, laat de eigenaar van de infrastructuur de cachesleutels en uitsluitingen van de infrastructuur bekijken.

Houd een herstelprocedure aan

Documenteer wie de cache kan opschonen, het effect ervan kan verifiëren en een eerdere configuratie kan herstellen. Een brede zuivering kan tijdelijk caching-voordelen verminderen, dus bereid een controle van essentiële pagina's na de bewerking voor.

Bekijk het beleid wanneer klantaccounts, commercie, een taal of een CDN worden geïntroduceerd. Een nuttige deliverable is een matrix voor respons-beleid-test-eigenaars. Een prestatiescore alleen al vestigt noch versheid, noch isolatie tussen gebruikers.

Primaire documentatie: MDN : HTTP-caching.

Verkeerde varianten uit een gedeelde cache voorkomen.

Fictief geval: één URL geeft twee formaten op basis van een header. Test beide achter de echte cache en de variatiesleutel, waaronder Vary waar relevant. Redactionele edities kunnen aparte URL’s nodig hebben. Een expliciet gekozen variant moet bereikbaar blijven.

  • Elk verzoek krijgt de juiste variant, ook na de andere bij ingeschakelde cache.

Persoonlijke cacheantwoorden scheiden

Twee laptops met gekleurde markeringen naast een router
AI-gegenereerde illustratie · Bekijk de inhoud van twee testsessies afzonderlijk.

Voorgestelde situatie: een persoonlijke bevestiging loopt door een gedeelde cache. Het ontvangen antwoord moet per sessie worden bekeken.

Gebruik twee gescheiden testsessies. Vergelijk verzoeken, headers en inhoud; een algemene instelling bewijst de waargenomen scheiding niet vanzelf.

  • Twee gescheiden sessies openen
  • Headers en inhoud vergelijken
  • De scheiding vastleggen

Referentiedocumenten

Inhoud bijgewerkt

Gedocumenteerde referenties voor dit onderwerp

Gedocumenteerde referenties voor dit onderwerp
ReferentieWaarde of syntaxisToepassingsgebied
HTTP · 304
If-None-Match → 304Bij een GET- of HEAD-verzoek kan een ongewijzigde representatie worden hergebruikt zonder de inhoud opnieuw te verzenden.
MDN · Vary
Vary: Accept-LanguageAls één URL verschillende antwoorden geeft op basis van Accept-Language, vermeldt Vary dit selectiecriterium voor de cache. Houd de waarde gelijk bij 200- en 304-antwoorden. Afzonderlijke taal-URL’s vereisen deze header niet enkel omdat de website meertalig is.
HTTP · If-Match
If-Match: "r7" → 412If-Match vergelijkt een sterke validator vóór een schrijfactie. In dit contract krijgt een verouderde versie 412; bewaar het concept om wijzigingen te vergelijken.

De datums geven aan wanneer de bronnen zijn geraadpleegd. Deze gegevens vormen geen site-audit of algemene conformiteitsverklaring.

Een cachehervalidatie lezen

Vergelijk vervangen inhoud en een hergebruikte kopie. De fragmenten tonen validators en beschikbare inhoud naast de code.

De fragmenten zijn onvolledig en gebruiken demo-adressen. De proef maakt een Response in het geheugen: geen servercontact en geen simulatie van netwerk, cache of bedrijfsverwerking.

200Een nieuwe volledige representatie
Betekenis
In dit fragment beantwoordt de server een voorwaardelijke GET met JSON-inhoud en validator demo-v2.
Te controleren
Vergelijk If-None-Match, ETag en de revisie in de inhoud. De lokale proef leest het JSON van dit voorbeeld.
Let op
Status 200 garandeert geen geldig JSON of juiste bedrijfsgegevens. Succesvol ontleden hier valideert uw eigen gegevensschema niet.
Fragment van een fictieve uitwisseling
GET /demo/catalogue
If-None-Match: "demo-v1"

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

{"revision":"demo-v2"}

304Kopie hervalideerd, geen nieuwe inhoud
Betekenis
304 beantwoordt een voorwaardelijk verzoek: de opgeslagen representatie kan opnieuw worden gebruikt. Er komt geen nieuwe inhoud.
Te controleren
Vergelijk de verzonden validator met de aanwezige kopie demo-v2. De uitleg hangt ook van die opgeslagen kopie af.
Let op
De proef maakt een losse Response 304, geen HTTP-cache. Bij echte fetch kan de browser de opgeslagen respons leveren; netwerkstatus en scriptstatus kunnen verschillen.
Fragment van een fictieve uitwisseling
GET /demo/catalogue
If-None-Match: "demo-v2"

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

Technische bronnen : RFC 9110 §15 · MDN · Response.ok · MDN · Response.json() · WHATWG · Fetch · .

Functionele validatiematrix om zich aan het project aan te passen

Deze voorgestelde controles gebruiken fictieve gevallen. Bepaal welk gedrag er met het team wordt verwacht, noteer het resultaat en wijs onopgeloste discrepanties toe voor publicatie.

Schuif de tabel horizontaal om alle kolommen te lezen. Zet met het toetsenbord de focus op de tabel en gebruik de pijltjestoetsen.

Testgevallen, verwachte resultaten en nuttig bewijs
GevalVerwacht resultaatBewijs om te houden
Ongewijzigde openbare paginaGeadverteerd beleid en voorwaardelijke reactie blijven consistent voor alle verzoeken.Headers, validator en status van beide verzoeken, waarbij de browserstatus is opgenomen.
Gewijzigde openbare inhoudDe gecorrigeerde versie arriveert binnen de gedefinieerde versheidsvoorwaarden.Oude en nieuwe inhoud, vraag tijd en ontvangen headers.
Twee testaccountsEen gepersonaliseerde reactie voor het eerste account wordt nooit geleverd aan het tweede.Geïsoleerde verzoeken en inhoud die door elk synthetisch account worden ontvangen.
log uit en ga terugGedrag van gevoelig scherm komt overeen met de gedocumenteerde vertrouwelijkheidsvereiste.Volledige browservolgorde en expliciet opgenomen beperkingen.

Veel gestelde vragen

Zijn no-cache en geen winkelequivalent?

Nee. De eerste vereist validatie vóór hergebruik; De tweede verzoekt om het antwoord niet te bewaren. Kies op basis van de inhoud en caches en test vervolgens de getroffen reizen.

Moet elke bron één cache-levensduur delen?

Een enkele levensduur negeert verschillen tussen openbare activa van versies, redactionele pagina's, prijzen en gepersonaliseerde reacties. Classificeer reacties, definieer hun updateproces en test ingelogde statussen voordat u levenslang kiest.