Файловая система Битрикс

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

Основные каталоги

/bitrix/                ядро, модули, стандартные компоненты и шаблоны
/bitrix/.settings.php   подключение к базе и настройки ядра
/bitrix/php_interface/  dbconn.php, init.php
/bitrix/cache/          кэш компонентов
/bitrix/managed_cache/  управляемый кэш
/bitrix/backup/         архивы штатного резервного копирования
/local/                 свои компоненты, шаблоны, модули, init.php
/upload/                файлы инфоблоков, медиабиблиотеки, форм
/                       публичные страницы и разделы сайта

Почему доработки живут в /local/

Всё внутри /bitrix/ принадлежит платформе, и обновления могут перезаписать любой файл. Поэтому собственный код — компоненты, шаблоны, модули, обработчики событий в /local/php_interface/init.php — кладут в /local/. Система ищет компоненты и шаблоны сначала там, затем в /bitrix/, так что копия стандартного компонента в /local/ подменяет оригинал без правки ядра.

Что копировать и что исключать

Для полной копии нужны все файлы и дамп базы. Каталоги кэша можно не копировать — они пересоздадутся. Папку /upload/ забывать нельзя: картинки товаров и документы лежат только там, а в базе — лишь ссылки на них. Каталог /bitrix/backup/ стоит закрыть от доступа извне и не копить в нём архивы годами. Подробнее — в статье о резервном копировании сайта.

Права на создаваемые файлы и папки задают константы BX_FILE_PERMISSIONS и BX_DIR_PERMISSIONS в dbconn.php. Если веб-сервер не может писать в /bitrix/cache/ и /upload/, ломаются кэш и загрузка картинок — общие принципы описаны в статье о правах файлов CHMOD. Как файлы соотносятся с адресами страниц, разобрано в материале о физической структуре сайта.