
В Bitrix папка html_pages служит хранилищем сгенерированных копий страниц сайта, которые система сохраняет для ускорения последующих обращений. Это часть механизма статического кеширования, который позволяет уменьшить нагрузку на сервер и сократить время загрузки страниц.
Каждый файл в html_pages – это сохранённая версия страницы, сформированная после первого запроса. При повторных обращениях Bitrix отдает эту копию без участия PHP и базы данных. Такой подход особенно заметен на сайтах с высокой посещаемостью, где каждое обращение к базе данных увеличивает время отклика.
Содержимое папки организовано по структуре, совпадающей с адресами страниц сайта. Например, файл, соответствующий адресу /catalog/, будет находиться в аналогичной папке внутри html_pages. Это облегчает поиск нужного кеша и позволяет быстро проверить, какие страницы были сохранены.
Понимание принципов работы html_pages помогает администратору управлять кешем вручную, находить устаревшие копии и контролировать объём хранимых данных. Это особенно важно при обновлении контента, когда требуется очистка кеша для корректного отображения изменений на сайте.
Назначение папки html_pages в структуре Bitrix

Папка html_pages используется системой Bitrix для хранения статически сгенерированных копий страниц сайта. Эти файлы создаются при первом обращении пользователя и позволяют отдавать содержимое напрямую с диска без повторных запросов к PHP и базе данных.
Такое решение снижает время отклика сервера и уменьшает нагрузку на процессор, особенно при высокой посещаемости. Папка включается в работу при активированном статическом кешировании и используется как часть механизма ускорения рендеринга страниц.
Bitrix автоматически создаёт внутри html_pages структуру каталогов, повторяющую структуру сайта. Каждый HTML-файл соответствует конкретному URL, включая параметры и язык интерфейса. При изменении контента система может перезаписать или удалить устаревший кеш.
| Элемент структуры | Описание |
|---|---|
| /html_pages/ | Корневая папка статического кеша |
| /html_pages/en/ | Кеш страниц на английском языке |
| /html_pages/catalog/ | Копии страниц каталога товаров |
| /html_pages/index.html | Закэшированная главная страница сайта |
Знание структуры и назначения папки html_pages позволяет администратору понимать, какие файлы можно безопасно удалить при обновлении контента и как контролировать поведение кеширования для разных разделов сайта.
Какие типы файлов сохраняются в html_pages

В папке html_pages Bitrix сохраняет статические версии страниц, представленные в виде файлов формата .html. Эти файлы содержат готовую разметку страницы, сформированную системой при первом обращении к ней. Благодаря этому повторные запросы обрабатываются без участия движка Bitrix.
Помимо HTML-файлов, внутри каталога могут встречаться вспомогательные файлы – например, .css и .js, если они были включены в кеш вместе со страницей. Это зависит от настроек кеширования и структуры шаблона сайта. В некоторых случаях создаются дополнительные служебные файлы, содержащие контрольные данные для обновления кеша.
Для систем с многоязычной структурой создаются отдельные версии HTML-файлов по языковым подкаталогам. Также Bitrix может сохранять разные копии одной страницы, если параметры URL отличаются. Это позволяет системе быстро отдавать точный вариант страницы без динамической генерации.
Файлы в html_pages не должны редактироваться вручную. При изменении контента Bitrix обновляет их автоматически. Если страница была изменена, но кеш не обновился, можно удалить соответствующий HTML-файл – система создаст новый при следующем запросе.
Роль html_pages при кешировании страниц сайта

Папка html_pages выполняет ключевую функцию в системе статического кеширования Bitrix. После первого запроса страница сохраняется в виде готового HTML-файла, который в дальнейшем отдается пользователю без запуска PHP и обращения к базе данных. Это позволяет сократить время генерации страницы до миллисекунд.
При активированном статическом кешировании Bitrix создаёт файл в html_pages сразу после полной загрузки страницы. Если пользователь повторно обращается к тому же URL, система проверяет наличие актуальной копии и, при её наличии, отправляет её напрямую с диска. Такой механизм существенно снижает нагрузку на сервер и ускоряет ответ при массовых запросах.
Bitrix поддерживает автоматическую актуализацию кеша. Когда обновляется контент, шаблон или модуль, связанные с конкретной страницей, система удаляет старую копию из html_pages и создаёт новую при следующем обращении. Это гарантирует соответствие сохранённых файлов реальному состоянию сайта.
При администрировании рекомендуется регулярно проверять размер папки html_pages и очищать устаревшие записи, если они не были удалены автоматически. Это особенно важно для крупных проектов, где кеш может занимать значительный объём диска.
Как Bitrix формирует и обновляет содержимое html_pages
Bitrix создаёт файлы в папке html_pages после полного рендеринга страницы. Когда пользователь впервые открывает страницу, система выполняет PHP-код, получает данные из базы и генерирует итоговую HTML-разметку. Затем этот результат сохраняется на диск как статический файл.
Формирование кеша происходит по определённой логике:
- Пользователь запрашивает страницу сайта.
- Bitrix генерирует страницу динамически и сохраняет итоговый HTML-файл в html_pages.
- При повторных запросах система проверяет наличие готового файла и отдаёт его напрямую с диска.
Содержимое кеша обновляется автоматически при изменении элементов, влияющих на страницу: компонентов, шаблонов, модулей или контента. Bitrix отслеживает события, связанные с изменением данных, и удаляет устаревший HTML-файл, чтобы при следующем запросе создать новый.
Администратор может принудительно очистить кеш несколькими способами:
- через административную панель, выбрав пункт Настройки → Производительность → Управление кешем;
- удалением конкретных файлов из папки /bitrix/html_pages/ вручную;
- с помощью консольной команды php bitrix/tools/clear_cache.php.
Регулярное обновление содержимого html_pages необходимо для корректного отображения новых данных и поддержания стабильной работы сайта при высокой нагрузке.
Где искать сохранённые версии страниц и как их читать
Все закэшированные версии страниц Bitrix сохраняет в папке /bitrix/html_pages/. Внутренняя структура повторяет дерево сайта, что позволяет легко найти нужный файл по его адресу. Например, страница /news/index.php будет храниться по пути /bitrix/html_pages/news/index.html.
Чтобы просмотреть сохранённую копию, достаточно открыть соответствующий HTML-файл через любой браузер или текстовый редактор. Файлы содержат полностью готовую разметку страницы, включая подключённые стили и скрипты, что позволяет увидеть, как страница выглядела при генерации кеша.
Основные пути расположения файлов:
- /bitrix/html_pages/ – основная директория кешированных страниц;
- /bitrix/html_pages/en/ – копии для англоязычной версии сайта;
- /bitrix/html_pages/catalog/ – сохранённые страницы каталога товаров;
- /bitrix/html_pages/index.html – кеш главной страницы.
Для поиска нужного файла удобно использовать системный поиск по имени URL или дате изменения. Если требуется проверить актуальность кеша, можно сравнить время последней модификации HTML-файла с датой обновления контента на сайте.
Редактировать файлы вручную не рекомендуется. При следующем запросе Bitrix может перезаписать их автоматически, поэтому любые изменения будут потеряны. Для обновления содержимого следует очистить кеш средствами панели управления или удалить конкретный файл из папки html_pages.
Очистка и обновление содержимого html_pages вручную
Для ручного управления кешем в папке html_pages необходимо знать точное расположение файлов. Основная директория находится по пути /bitrix/html_pages/, и внутри неё структура повторяет URL сайта.
Удаление устаревших файлов позволяет гарантировать, что при следующем запросе страницы будет сгенерирована новая версия. Для этого можно:
- Удалять отдельные HTML-файлы, соответствующие конкретным страницам, если необходимо обновить только их;
- Удалять содержимое подкаталогов для обновления разделов сайта целиком;
- Удалять все файлы в html_pages, чтобы принудительно перегенерировать кеш всего сайта.
После удаления файлов Bitrix автоматически создаёт новые HTML-копии при первом обращении к страницам. Рекомендуется выполнять очистку при изменении контента, шаблонов или компонентов, чтобы избежать показа устаревшей информации.
Дополнительно можно контролировать процесс через административную панель: Настройки → Производительность → Управление кешем. Это позволяет просматривать состояние кеша и выполнять очистку без прямого вмешательства в файловую систему.
Как контролировать размер и поведение папки html_pages через настройки

Размер и поведение папки html_pages можно регулировать через настройки кеширования Bitrix. В административной панели доступны параметры, влияющие на создание и удаление HTML-файлов.
Основные возможности контроля:
- Время жизни кеша – задаёт период, после которого файлы считаются устаревшими и автоматически удаляются;
- Глубина кеширования – определяет, какие разделы сайта сохраняются в папке, что помогает ограничивать объём данных;
- Автоматическая очистка – позволяет удалять устаревшие копии при обновлении компонентов или шаблонов;
- Мониторинг размеров – отображает текущий объём папки и количество файлов, что позволяет вовремя принять меры для предотвращения переполнения диска.
Рекомендуется устанавливать оптимальные значения времени жизни кеша для активно обновляемого контента, чтобы исключить показ устаревших страниц. Также полезно периодически проверять размер html_pages и при необходимости очищать отдельные разделы вручную или через панель управления.
Использование этих настроек позволяет поддерживать папку html_pages в упорядоченном состоянии, снижать нагрузку на сервер и обеспечивать корректное отображение актуального контента.
Вопрос-ответ:
Что именно хранится в папке html_pages в Bitrix?
В папке html_pages хранятся статические копии страниц сайта в формате HTML. Эти файлы создаются после первого обращения пользователя к странице и позволяют повторно отдавать готовую разметку без выполнения PHP-кода и обращений к базе данных. Дополнительно могут сохраняться связанные CSS и JavaScript-файлы, если они подключены к странице в момент генерации кеша.
Как файлы html_pages помогают ускорить работу сайта?
При использовании статического кеша Bitrix повторные запросы к страницам обрабатываются напрямую с диска. Это исключает повторную генерацию страницы, что снижает нагрузку на сервер и сокращает время загрузки. Особенно это заметно на сайтах с большим количеством посетителей, где каждый запрос к базе данных увеличивает задержку.
Можно ли вручную редактировать файлы в html_pages?
Редактирование HTML-файлов вручную не рекомендуется, так как Bitrix автоматически перезаписывает их при следующем обращении к странице. Любые изменения будут потеряны. Для обновления контента следует очищать кеш через панель управления или удалять конкретные файлы из html_pages, чтобы система сгенерировала новые версии.
Как найти нужный HTML-файл внутри html_pages?
Структура папки повторяет URL сайта. Например, страница /catalog/product1/ будет сохранена по пути /bitrix/html_pages/catalog/product1/index.html. Для многоязычных сайтов создаются отдельные подкаталоги по языкам. Можно использовать поиск по имени папки или дате изменения файла, чтобы быстро определить нужную копию.
Как контролировать размер папки html_pages и очистку кеша?
Размер папки можно контролировать через настройки кеширования Bitrix: задавать время жизни файлов, включать автоматическую очистку устаревших копий и ограничивать глубину кеширования. Также можно периодически удалять отдельные файлы или целые подкаталоги вручную, чтобы освободить место и заставить систему сгенерировать новые версии страниц при следующем обращении.
Для чего используется папка html_pages в Bitrix?
Папка html_pages хранит статические копии страниц сайта. При первом обращении к странице Bitrix создаёт HTML-файл с готовой разметкой, который при повторных запросах отдается напрямую с диска. Это сокращает нагрузку на сервер и ускоряет загрузку страниц, особенно на сайтах с большим количеством посетителей.
Как обновлять содержимое html_pages после изменения контента?
Обновление происходит автоматически при изменении компонентов, шаблонов или контента. Если необходимо обновить конкретную страницу вручную, можно удалить соответствующий HTML-файл в /bitrix/html_pages/. При следующем обращении Bitrix создаст новую версию страницы. Также очистку можно проводить через панель управления, выбрав раздел управления кешем.
