Кэш — самая дешёвая оптимизация: ответ вообще не доходит до сервера. Но у неё есть цена: если заголовки выставлены неверно, пользователь неделю видит старую цену, а после обновления сайта — сломанную вёрстку из локального кэша.
Кто и что кэширует
В цепочке участвуют браузер, промежуточный прокси, 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и без общего кэша.