/local: где живёт ваш код
Каталог /local/ — стандартное изолированное место для проектного кода, модулей, компонентов, шаблонов оформления и php_interface. Функция ядра getLocalPath() обеспечивает приоритетное подключение файлов из /local/ вместо системных аналогов из /bitrix/, что позволяет безопасно обновлять платформу.
Прогресс хранится в этом браузере. Войдите, чтобы сохранить его в аккаунте.
Что нужно понимать
-
1
/local/modules — кастомные модули
-
2
/local/components — кастомные компоненты
-
3
/local/templates — шаблоны сайта
-
4
/local/php_interface — init.php, события
-
5
/local/js — JavaScript расширения
-
6
/local/activities — действия бизнес-процессов
Материалы
Официальная документация
-
Расширения Новая дока
Проверь себя
Стандартный компонент перестал получать исправления после обновлений на одном из проектов. Что могли сделать в /local?
Скопировать компонент целиком в /local/components/bitrix/<имя>. getLocalPath() находит его первым, и системная версия больше не используется. Если нужен был только вид, достаточно копии шаблона в /local/templates/<шаблон>/components.
Заказчик жалуется, что на первом сайте обработчик работает, а на втором нет. Оба сайта на одном ядре.
Обработчик положили в /local/php_interface/<ID сайта>/init.php первого сайта. Общий для всех — /local/php_interface/init.php; файл сайта подключается после него и только на этом сайте.
Почему для /local/php_interface рекомендуют такие же права доступа, как для /bitrix/php_interface?
Там лежат init.php, dbconn.php и могут лежать .settings.php с паролями. Публичный доступ к этой папке — утечка настроек и точка внедрения кода.
Чем отличается /local/js от «положить скрипт в шаблон»?
В /local/js/<модуль>/<расширение>/ лежат расширения с config.php и сборкой в dist; их подключают по имени через Extension, ядро сам подтягивает зависимости и CSS. Скрипт в шаблоне — просто тег без версии и зависимостей.
Не сходится?
Спросите ассистента BXMax: он знает документацию и материалы сайта по этой теме.
Знаете материал лучше?
Предложите ссылку: после проверки она появится в этом разделе.
Войти, чтобы предложить