Конструктор заголовка HTTP Cache-Control

Что такое HTTP Cache-Control Header Builder?

Cache-Control — это заголовок ответа HTTP, который говорит браузерам, CDN и прокси может ли ответ быть закеширован, на как долго и как его следует переvalidate когда он устаревает. Это также один из самых простых для ошибок заголовков: no-cache не означает «не кешировать», no-store молча переопределяет почти всё остальное что вы устанавливаете вместе с ним, и s-maxage имеет значение только для общих кешей в то время как max-age имеет значение для обоих. Этот инструмент собирает правильный заголовок из отдельных директив (или подобранной предустановки) и объясняет на простом языке что именно делает каждая активная директива — плюс отмечает комбинации которые противоречат или частично отменяют друг друга.

Как использовать

1. Выберите Context Preset для распространённого сценария — ответ API, статический ресурс, страница HTML или приватные данные — или оставьте в режиме Custom для переключения директив вручную.
2. В режиме Custom отметьте применимые директивы Cacheability (public, private, no-cache, no-store), установите сроки Freshness в секундах (max-age, s-maxage, stale-while-revalidate, stale-if-error), и включите нужные вам директивы Revalidation (must-revalidate, proxy-revalidate, immutable, no-transform, must-understand).
3. Поле Cache-Control Header обновляется автоматически — скопируйте его прямо в конфигурацию ответа сервера, правило CDN или код приложения.
4. Прочитайте What Each Directive Does для простого объяснения каждой включённой вами директивы, и проверьте Warnings на предмет чего-то что противоречит или молча отменяет другую установленную вами директиву.

Выбор предустановки

• API response — no-store. Динамические данные по запросу которые никогда не должны кешироваться никем.
• Static asset — public, max-age=31536000, immutable. Для файлов с хешированным или версионированным именем файла (app.a1b2c3.js) — сам URL меняется когда меняется содержимое, поэтому безопасно кешировать на год и полностью пропустить переvalidation.
• HTML page — no-cache. URL остаётся прежним но содержимое может меняться, так что кеши могут его хранить но должны проверять с источником перед повторной подачей.
• Private data — private, max-age=0, must-revalidate. Страницы аккаунтов, корзины или что-то специфичное пользователю: кешируется только браузером и всегда переvalidate.

FAQ

В чём разница между no-cache и no-store?

no-cache позволяет кешу хранить ответ но требует его переvalidation с источником перед повторной подачей — это директива «проверь сначала» а не «не кешируй». no-store — это строгая версия: кеш не может хранить ответ вообще. Смешивание no-store с директивами типа max-age или must-revalidate не инвалидно но эти директивы становятся бессмысленны — no-store уже предотвращает любое хранилище для применения к нему.

В чём разница между max-age и s-maxage?

max-age устанавливает срок freshness для каждого кеша — браузер и любой общий кеш (CDN, прокси) посередине. s-maxage переопределяет этот срок только для общих кешей позволяя вам кешировать ответ дольше (или короче) на CDN чем в браузере самого посетителя. s-maxage на приватном ответе не имеет эффекта т.к. общие кеши вообще не разрешено хранить приватные ответы.

Означает ли immutable что ответ никогда не переvalidate?

Только в пределах его окна freshness. immutable говорит браузеру что может полностью пропустить условные запросы переvalidation — включая при принудительной перезагрузке — пока max-age (или s-maxage) говорит что ответ свежий. После истечения этого окна обычные правила переvalidation применяются снова. Установка immutable без max-age/s-maxage не даёт ему окна freshness для применения.

Является ли Cache-Control единственным заголовком кеширования который мне нужен?

Это основной для управления freshness и хранилищем но валидаторы типа ETag и Last-Modified всё ещё важны для запросов переvalidation — это то что кеш отправляет обратно источнику чтобы спросить «изменилось ли это?» после истечения max-age. Чтобы преобразовать длительность в готовый к использованию max-age= без арифметики секунд используйте Cache TTL Calculator. Для эквивалентного рабочего процесса построения заголовка на кросс-origin запросах см. CORS Headers Builder.

Приватность

Этот инструмент работает полностью в вашем браузере. Директивы и значения которые вы устанавливаете никогда не отправляются на наши серверы и не хранятся там.