Кэш — самая дешёвая оптимизация: ответ вообще не доходит до сервера. Но у неё есть цена: если заголовки выставлены неверно, пользователь неделю видит старую цену, а после обновления сайта — сломанную вёрстку из локального кэша.

Кто и что кэширует

В цепочке участвуют браузер, промежуточный прокси, CDN и серверное приложение. У каждого свой срок жизни и свои правила. Заголовки — единственный способ договориться со всеми сразу.

Cache-Control важнее устаревших Expires и Pragma. Если они противоречат, современные клиенты слушают Cache-Control.

Основные директивы

  • max-age=3600 — браузер может хранить ответ час;
  • s-maxage=86400 — срок для общих кэшей и CDN;
  • public — ответ можно кэшировать всем;
  • private — только браузеру конкретного пользователя;
  • no-cache — хранить можно, но перед использованием проверить у сервера;
  • no-store — не хранить вообще;
  • must-revalidate — после истечения срока не отдавать устаревшее без проверки;
  • stale-while-revalidate=60 — отдать старое, пока фон обновляет копию.

no-cache часто понимают как «не кэшировать». На самом деле это «кэшируй, но спрашивай». Для секретных страниц нужен no-store.

ETag и 304

ETag — отпечаток версии ресурса. Клиент присылает его в If-None-Match, сервер сравнивает и вместо тела отвечает 304 Not Modified:

$etag = '"' . md5($content) . '"';

if ($request->headers->get('If-None-Match') === $etag) {
    return response('', 304);
}

return response($content)->setEtag(trim($etag, '"'));

Экономия — в трафике и разборе HTML, но запрос всё равно уходит на сервер. Для статики с длинным max-age 304 почти не нужен: браузер вообще не спрашивает.

Last-Modified работает похоже, но с точностью до секунды и хуже переносит быстрые изменения. Если есть возможность, используйте ETag.

Что кэшировать можно

  • CSS, JS, шрифты, картинки — надолго, но только с версией в имени или query: site.css?v=17.
  • Публичные страницы каталога — короткий max-age плюс s-maxage на CDN.
  • Личный кабинет — private, no-store или короткий срок с обязательной проверкой.
  • API-ответы — только если данные не зависят от пользователя; иначе добавьте Vary: Authorization.

Vary сообщает, по каким заголовкам различаются версии. Vary: Accept-Encoding — норма, Vary: Cookie почти всегда убивает кэш.

Ошибка: «обновите, у вас старая версия»

Классика — index.html и хэшированные ассеты. HTML кэшируется надолго, а новый файл ссылается на новые имена. Если HTML остался старым, браузер грузит старые ассеты, и сайт выглядит сломанным. Лечится так: HTML — no-cache, ассеты — immutable на год.

Cache-Control: no-cache
Cache-Control: public, max-age=31536000, immutable

В Laravel для статики это настраивается в конфиге nginx/Apache, а не в PHP. Проверьте ответ через curl -I: заголовки должны быть видны до тела.

Проверка

curl -I https://hello-site.ru/css/site.css?v=17
curl -I -H 'If-None-Match: "abc"' https://hello-site.ru/page/

Ожидайте 200 с нужными директивами и 304 при совпадении ETag. Если видите 200 и полный размер каждый раз — кэш не работает, ищите Set-Cookie или no-store выше по цепочке.

В Laravel заголовки удобно ставить в middleware или контроллере, но не в шаблоне: любой вывод до заголовков ломает отправку. Для статики правило лучше держать в nginx: PHP не должен обслуживать файлы, которые не меняются.

При обновлении сайта меняйте версию в имени файла, а не только дату в query. Некоторые прокси игнорируют query при кэшировании, и пользователь получает старый CSS с новым HTML. Хэш в имени — site.8f3a1c.css — исключает эту проблему.

Если используете CDN, после релиза очищайте только изменённые пути, а не весь кэш: полная очистка создаёт всплеск запросов к серверу. Проверить, как отдаются картинки и стили, помогает разметка изображений и конвертер.

Составьте таблицу: тип ресурса, срок, кто кэширует, как сбрасывается. Без неё через месяц никто не вспомнит, почему каталог живёт час, а карточка товара — минуту. И проверьте поведение после деплоя: откройте сайт в приватном окне и в обычном, чтобы увидеть разницу между пустым и прогретым кэшем.

Коротко

  • Cache-Control — основной инструмент, остальное устарело;
  • no-cache не равно no-store;
  • ETag экономит трафик, но не отменяет запрос;
  • статика — с версией в имени и долгим сроком;
  • личные страницы — private и без общего кэша.