Как очистить кеш в Битрикс на сервере: полное руководство

После внесения изменений на сайте иногда кажется, что Битрикс их просто не замечает. Вы обновили шаблон, изменили компонент, поправили CSS или PHP-код, а сайт продолжает отображать старую версию страницы.

Чаще всего причина заключается в работе системы кеширования. В этой статье рассмотрим, какие виды кеша существуют в 1С-Битрикс, когда их необходимо очищать и какие каталоги можно безопасно удалить на сервере.

Почему Битрикс показывает старые данные?

Для ускорения работы практически все данные в Битрикс кешируются:

• результаты компонентов;
• дерево разделов;
• настройки модулей;
• данные инфоблоков;
• композитные страницы;
• PHP-кеш (Opcache).

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

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

Самый простой способ — воспользоваться административной частью сайта.

Перейдите:

Настройки → Настройки продукта → Автокеширование → Очистить кеш.

Этот способ подходит большинству пользователей и не требует доступа к серверу.

Очистка кеша через SSH

Если имеется доступ к серверу по SSH, очистить кеш можно значительно быстрее.

Перейдите в корневую директорию сайта и выполните:

rm -rf bitrix/cache/*
rm -rf bitrix/managed_cache/*
rm -rf bitrix/stack_cache/*

После этого Битрикс автоматически создаст необходимые каталоги заново при первом обращении к сайту.

Очистка композитного кеша

Если используется технология Композитный сайт, необходимо также удалить соответствующий кеш:

rm -rf bitrix/html_pages/*

Именно этот каталог чаще всего становится причиной того, что пользователь продолжает видеть старую версию страницы.

Очистка временных файлов

Иногда полезно удалить временные файлы:

rm -rf upload/tmp/*
rm -rf bitrix/tmp/*

Особенно после обновлений системы или выполнения длительных операций импорта.

Очистка PHP Opcache

Даже после удаления файлов кеша изменения PHP-кода могут не отображаться.

Причиной может быть включенный PHP Opcache.

Проверить настройки можно командой:

php -i | grep opcache

Если используется PHP-FPM, обычно достаточно выполнить перезапуск службы:

systemctl restart php8.2-fpm

Версию PHP необходимо заменить на используемую на вашем сервере.

Какие папки можно удалять безопасно?

Какие каталоги удалять нельзя?

Не рекомендуется удалять следующие каталоги:

• bitrix/modules
• bitrix/components
• upload
• local
• bitrix/php_interface

Удаление этих директорий приведет к повреждению сайта или потере данных.

Как полностью очистить весь кеш одной командой

Если необходимо полностью удалить все основные виды кеша, можно воспользоваться следующими командами:

rm -rf bitrix/cache/*
rm -rf bitrix/managed_cache/*
rm -rf bitrix/stack_cache/*
rm -rf bitrix/html_pages/*
rm -rf bitrix/tmp/*
rm -rf upload/tmp/*

После выполнения команд достаточно открыть сайт в браузере. Битрикс автоматически создаст новые файлы кеша.

Когда стоит очищать кеш?

• после изменения шаблона сайта;
• после обновления компонентов;
• после изменения PHP-кода;
• после изменения CSS или JavaScript;
• после импорта большого количества данных;
• после обновления системы Битрикс;
• при появлении ошибок отображения.

Заключение

В большинстве случаев достаточно очистить каталоги bitrix/cache, bitrix/managed_cache и, если используется композитный режим, bitrix/html_pages. Это безопасная операция — Битрикс самостоятельно создаст кеш заново при следующих обращениях к сайту.

Если же изменения по-прежнему не отображаются, стоит проверить работу PHP Opcache, браузерный кеш и наличие внешнего CDN, которые также могут хранить старую версию файлов.