Битрикс: почему ваши доработки исчезают после обновления и при чём тут /local/

История повторяется на каждом втором корпоративном Битриксе: заказали доработку, всё работало, через полгода поставили обновление — доработка исчезла. Подрядчик разводит руками, деньги уплачены дважды. Причина почти всегда одна, и она не в «кривом Битриксе», а в том, куда положили код.

Как обновляется Битрикс

Обновление приезжает через маркетплейс и перезаписывает файлы в папке /bitrix/ штатными версиями. Это документированное поведение: папка ядра принадлежит платформе, и платформа распоряжается ею как хочет. Всё, что разработчик положил туда «потому что так быстрее», живёт ровно до следующего апдейта. Ошибки не будет, предупреждения не будет — файлы просто заменятся.

Куда класть доработки

Для кастомного кода в Битриксе есть папка /local/: компоненты, шаблоны, модули, обработчики событий. Обновления её не трогают — это официальный, описанный в документации механизм. Правило простое: в /bitrix/ не пишем никогда, всё своё — в /local/. Если унаследованный проект уже полон правок в ядре, их переносят: работа разовая, объём зависит от накопленного, зато после неё обновляться можно без сюрпризов.

Как понять, что у вас всё плохо

Три признака. Сайт давно не обновляется, потому что «после обновления что-то отваливается» — почти наверняка правки в ядре. Разработчик не может внятно ответить, где лежат доработки. И третий, самый тревожный: лицензия просрочена, обновления не приходят вовсе — значит, не приходят и патчи безопасности, а дыры в Битриксе эксплуатируются так же бодро, как в WordPress.

Что делать

Инвентаризация: найти все правки в /bitrix/ сравнением с чистой поставкой той же версии. Перенос в /local/. Продление лицензии, если просрочена. Дальше — обновления на тестовой копии и только потом на боевом. Звучит как проект, и первый раз это действительно проект; дальше — обычная регулярная работа, которую мы ведём в рамках поддержки сайтов на 1С-Битрикс.