Как очистить кэш 1С-Битрикс: полная инструкция

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

В системе существует несколько независимых слоёв кэширования: управляемый кэш (managed cache), кэш компонентов и шаблонов, кэш меню, кэш статических страниц, композитный кэш и кешированные CSS/JS-файлы. У каждого слоя свой механизм очистки, и кнопка «очистить весь кэш» затрагивает не всё. Понимание структуры помогает чистить точечно, не просаживая производительность боевого сайта.

Ниже разобраны все рабочие способы: через административную панель, через файловую систему сервера и через командную строку, а также ограничения каждого подхода и типичные ошибки, из-за которых сайт после очистки начинает тормозить или показывать битые страницы.

Какие виды кэша есть в Битриксе и что именно нужно чистить

Управляемый кэш (managed cache) хранит результаты работы компонентов, запросы к инфоблокам и данные модулей. Физически он лежит в папке /bitrix/managed_cache/ либо в memcached/APCu, если настроено внешнее хранилище. Этот слой сбрасывается по тегам автоматически при изменении данных, но автоматика срабатывает не всегда — особенно при прямых правках в базе или файлах.

Неуправляемый (файловый) кэш — это закэшированные страницы, шаблоны компонентов, меню и прочие файлы в /bitrix/cache/. Он очищается по времени жизни (TTL) или вручную. Отдельно существует кэш HTML-композита в /bitrix/html_pages/ — статические слепки страниц для неавторизованных посетителей, который работает только при включённом композитном режиме.

Также браузерные и серверные оптимизации собирают объединённые CSS и JS в /bitrix/cache/ (подпапки css и js). Если после правки стилей изменения не видны даже после сброса основного кэша — причина почти всегда здесь либо в кэше браузера посетителя.

Очистка кэша через административную панель

Самый безопасный способ — встроенные инструменты. На любой странице админки в верхней служебной панели есть кнопка с иконкой очистки кэша: по клику открывается меню с вариантами «файловый кэш», «управляемый кэш», «только изображения», «весь кэш». Для точечной работы выбирайте конкретный тип, а не «весь».

Расширенное управление находится в разделе Настройки → Производительность → Панель производительности, вкладка «Очистка кэша». Здесь доступны отдельные действия: очистка управляемого кэша, неуправляемого, кэша статических страниц и сброс закэшированных CSS/JS. Для композитного режима очистка выполняется в Настройки → Композитный сайт кнопкой «Очистить кэш».

Если нужно сбросить кэш конкретного компонента, не трогая остальное, откройте публичную страницу под администратором, наведите на область компонента и в появившейся панели выберите «Очистить кэш компонента». Это самый щадящий вариант для боевого сайта.

1. 1
   Авторизуйтесь в административной панели с правами управления кэшем
2. 2
   Откройте Настройки → Производительность → Панель производительности
3. 3
   На вкладке «Очистка кэша» выберите нужный тип: управляемый, файловый или страницы
4. 4
   При включённом композите дополнительно очистите кэш в Настройки → Композитный сайт
5. 5
   Обновите публичную страницу с Ctrl+F5 и проверьте, что изменения появились

Очистка кэша через файловую систему и командную строку

Когда админка недоступна (например, сайт упал с ошибкой после обновления), кэш удаляют напрямую на сервере. Достаточно удалить содержимое трёх директорий — сами папки удалять не нужно, права на них должны сохраниться.

rm -rf /var/www/site.ru/bitrix/cache/<em>
rm -rf /var/www/site.ru/bitrix/managed_cache/</em>
rm -rf /var/www/site.ru/bitrix/html_pages/<em>
rm -rf /var/www/site.ru/bitrix/stack_cache/</em>

Путь /var/www/site.ru/ замените на корень вашей установки. Папка stack_cache есть не во всех версиях — если её нет, команда просто не найдёт файлов. После удаления убедитесь, что владельцем вновь создаваемых файлов будет пользователь веб-сервера, иначе сайт начнёт сыпать ошибками прав доступа.

Если в .settings.php кэш перенесён в memcached или Redis, удаление файлов не даст эффекта: управляемый кэш нужно сбрасывать через очистку самого хранилища (например, flushall для Redis или перезапуск memcached). Проверить тип хранилища можно в файле /bitrix/.settings.php в секции cache.

Точечная очистка: меню, компоненты, страницы, CSS и JS

Не всегда нужно сбрасывать всё. Кэш меню лежит в /bitrix/cache/menu/ и сбрасывается кнопкой «Сбросить кэш меню» в панели редактирования на публичной странице либо удалением содержимого этой подпапки. Кэш конкретного шаблона компонента — в /bitrix/cache/ по имени компонента, но проще использовать кнопку очистки в панели компонента.

Объединённые стили и скрипты пересобираются после очистки подпапок css и js внутри /bitrix/cache/ или через опцию «Сбросить закэшированные CSS/JS» в панели производительности. После этого попросите проверяющих обновить страницу с Ctrl+F5: браузерный кэш посетителей Битрикс не контролирует.

Для разработчиков доступен программный сброс по тегам: метод BXClearCache, функции CPageCache::CleanDir() и очистка тегированного кэша через $GLOBALS['CACHE_MANAGER']->ClearByTag('tag_name'). Это удобно в обработчиках после импорта данных, когда нужно сбросить только затронутые разделы.

Как проверить результат и не навредить производительности

Признак успешной очистки — изменения видны на публичных страницах при просмотре в режиме инкогнито или после Ctrl+F5. Если правки видны администратору, но не видны анонимным посетителям, почти наверняка не очищен композитный кэш: администраторам композитные страницы не отдаются, а гостям отдаются старые слепки.

Обратная сторона полной очистки — «холодный» сайт. Пока кэш не наполнится заново, каждая страница генерируется с нуля, и на слабом хостинге это может занимать секунды. Поэтому на боевых проектах полный сброс делают в часы минимальной посещаемости, а в обычной работе предпочитают точечную очистку.

Типичные ошибки и ограничения

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

Если очистка не помогает вообще, проверьте, не включено ли кэширование на уровне веб-сервера (nginx fastcgi_cache, varnish) или CDN. Битрикс этими слоями не управляет, и их нужно сбрасывать отдельно средствами хостинга.

Частые вопросы