Корневые директории
Корень проекта разделен на системные зоны: ядро в /bitrix/, проектный код в /local/ и пользовательские файлы в /upload/. Платформа отдает приоритет файлам из /local/, а пути к загруженным медиафайлам необходимо получать через API по их ID, избегая прямых ссылок на файловую систему.
Прогресс хранится в этом браузере. Войдите, чтобы сохранить его в аккаунте.
Что нужно понимать
-
1
/bitrix — ядро системы
-
2
/local — кастомный код
-
3
/upload — загруженные файлы
-
4
/vendor — Composer-зависимости
Материалы
Официальная документация
-
Composer Новая дока
Проверь себя
Заказчик жалуется, что после обновления пропали правки предыдущего разработчика. Куда он их положил и как это найти?
В /bitrix: системная папка перезаписывается обновлениями. Найти изменённые файлы ядра поможет Монитор качества в админке; правки переносят в /local, где ядро ищет файлы в первую очередь через getLocalPath().
Почему в коде нельзя собирать путь к картинке как строку /upload/iblock/…?
Папку для загрузок можно переназначить в настройках Главного модуля, а внутри неё модули создают свои подпапки. Путь к файлу берут через API по его ID, а не по константе.
Где должны лежать composer.json и vendor и почему не в корне сайта?
Документация рекомендует держать composer.json за пределами DOCUMENT_ROOT, например в /home/bitrix/, и указать путь в секции composer файла .settings.php. vendor создаётся рядом с composer.json, и ядро само подключает vendor/autoload.php. Вариант внутри корня — /local/composer/ с закрытым доступом извне.
Что из корня проекта попадает в Git, а что нет?
В Git идут /local и публичные страницы. /bitrix — ядро из обновлений, /upload — пользовательские данные, кеш и vendor воспроизводятся. .settings.php с паролями — тоже вне репозитория.
Не сходится?
Спросите ассистента BXMax: он знает документацию и материалы сайта по этой теме.
Знаете материал лучше?
Предложите ссылку: после проверки она появится в этом разделе.
Войти, чтобы предложить