Структура файлов Битрикс: где что лежит и что не трогать

За 20-30 минут вы научитесь находить в установленном Битриксе нужный файл: шаблон сайта, шаблон компонента, настройки подключения к базе, загруженные картинки. И отличать папки, которые можно править, от тех, которые обновление перезапишет. Речь о коробочной редакции «1С-Битрикс: Управление сайтом». У облачного Битрикс24 файловой системы для владельца нет.

Что нужно до начала

• Доступ к файлам сайта: SSH, SFTP или файловый менеджер хостинга. Для просмотра хватит прав на чтение, для правок нужна запись.
• Вход в административный раздел с правами администратора.
• Свежая резервная копия. В админке она делается на странице /bitrix/admin/dump.php. Для обхода папок копия не нужна, но первая же правка без неё может обернуться часами восстановления.
• Путь к корню сайта. В виртуальной машине BitrixVM это обычно /home/bitrix/www, на обычном хостинге чаще public_html или папка с именем домена.
• Версия платформы. Материал описывает структуру современных редакций «Управление сайтом». Каталог /local есть не во всех старых сборках, поэтому версию проверьте на шаге 2.

Карта папок: три зоны

Корень сайта делится на три зоны: ядро в /bitrix, ваш код в /local и пользовательские данные в /upload. Правило одно: всё, что лежит в ядре, считайте чужим. Обновление платформы может перезаписать изменённые файлы, и правки пропадут.

Пояснение к терминам. Корень сайта (document root) - папка на сервере, которую веб-сервер отдаёт по адресу домена. Компонент - готовый PHP-блок, который выводит данные (список новостей, каталог, форму). Шаблон компонента - его HTML-оформление. Шаблон сайта - общий каркас страницы: шапка, подвал, стили.

Если вы правите файл в /bitrix/modules или /bitrix/components, вы правите чужой код. Следующее обновление может его переписать, а вы узнаете об этом по пропавшему поведению сайта.

Пошаговый обход

1. Откройте корень сайта. Подключитесь по SSH и посмотрите содержимое папки. Почему так: все остальные пути в статье отсчитываются отсюда.

   # Путь замените на свой: для BitrixVM это /home/bitrix/www
   cd /home/bitrix/www
   # Показать все файлы, включая скрытые (например, .htaccess)
   ls -la

   Проверка: в списке есть каталоги bitrix и upload, а также файлы index.php, .htaccess и urlrewrite.php. Каталога local может не быть, его создают вручную.

2. Узнайте версию платформы. Откройте в браузере /bitrix/admin/update_system.php на своём домене. От версии зависит, какие возможности вам доступны.

   Проверка: страница показывает установленные версии модулей, среди них модуль main. Запишите её.

3. Найдите шаблон сайта. В админке откройте раздел шаблонов сайтов (/bitrix/admin/template_admin.php) и запомните идентификатор шаблона, назначенного вашему сайту. Затем откройте /bitrix/templates/ИДЕНТИФИКАТОР (или /local/templates/ИДЕНТИФИКАТОР, если шаблон лежит там). Каркас страницы собирается из header.php и footer.php, стили лежат рядом.

   Проверка: в header.php виден код от начала страницы до места, где выводится её содержимое, а в footer.php продолжение до конца разметки.

4. Найдите шаблон компонента. Оригиналы лежат в /bitrix/components/bitrix/ИМЯ_КОМПОНЕНТА/templates/.default/. Рабочая копия живёт в шаблоне сайта: /bitrix/templates/ИДЕНТИФИКАТОР/components/bitrix/ИМЯ_КОМПОНЕНТА/ИМЯ_ШАБЛОНА/. Если копия есть, сайт берёт её, а не оригинал. Скопировать шаблон можно из админки: в режиме правки страницы у компонента есть действие копирования шаблона (название зависит от версии).

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

5. Подготовьте папку для своего кода. Создайте каталоги в /local. Для компонентов и шаблонов ядро смотрит сюда раньше, чем в /bitrix.

   cd /home/bitrix/www
   # Три стандартные подпапки для собственного кода
   mkdir -p local/components local/templates local/php_interface
   ls local

   Проверка: ls local выводит components, php_interface и templates. Файл init.php с вашей логикой можно класть в /local/php_interface.

6. Найдите настройки подключения к базе. Они в /bitrix/.settings.php (блок connections) и частично в /bitrix/php_interface/dbconn.php. Откройте файл в редакторе, не выводя его в общий чат или трекер: пароль лежит открытым текстом.

   Проверка: в блоке connections видны хост, имя базы и логин. Этот файл не должен попадать в git и в публичные архивы.

7. Найдите загрузки. Всё, что вы добавляете через админку, оказывается в /upload. Файлы инфоблоков лежат в /upload/iblock, уменьшенные копии картинок в /upload/resize_cache, они пересоздаются при обращении к страницам.

   Проверка: в /upload/iblock вложенные папки с короткими хешами в названиях, внутри ваши картинки и документы.

Если не получилось

• Белый экран или «500 Internal Server Error» после правки. Чаще всего опечатка в PHP. В логе веб-сервера будет строка вида PHP Parse error: syntax error, unexpected. Верните файл из копии и поправьте. Для диагностики временно включите отладку: в /bitrix/.settings.php блок exception_handling, параметр debug. На боевом сайте после этого верните прежнее значение.
• Правка в шаблоне есть, а на сайте её не видно. Либо страница отдаётся из кеша компонента, тогда сбросьте кеш из панели администратора. Либо вы правите оригинал в /bitrix/components, а сайт берёт копию из шаблона сайта. Проверьте путь из шага 4.
• «Permission denied» при сохранении по SFTP или «mkdir: cannot create directory» в консоли. Владелец файлов не совпадает с вашим пользователем. Уточните в панели хостинга или документации виртуальной машины, под кем работает веб-сервер, и попросите выдать права или смените владельца каталога.
• «No such file or directory» при переходе в корень. Путь неверный. На обычном хостинге найдите папку, где рядом лежат index.php и каталог bitrix, это и есть корень.
• Шаблон из /local/templates не виден в админке. Проверьте регистр в имени папки (Linux различает регистр), наличие header.php и footer.php и права на чтение для пользователя веб-сервера.

Что делать дальше

Первое: перенесите свои правки в /local и подключите репозиторий. В git не кладите /upload, /bitrix/cache, /bitrix/managed_cache, /bitrix/backup и файлы с паролями. Второе: раз в месяц смотрите, сколько места занимают тяжёлые каталоги.

# Размер загрузок, кеша и резервных копий
du -sh /home/bitrix/www/upload /home/bitrix/www/bitrix/cache /home/bitrix/www/bitrix/backup

Если бэкапы растут быстрее, чем вы их скачиваете, диск закончится раньше, чем вы заметите проблему. Порядок подключения init.php и событий ядра - отдельная тема, здесь мы её не разворачиваем.