Коротко

Доработки «слетают» при обновлении 1С-Битрикс только тогда, когда их вносили прямо в ядро (папку /bitrix/). Чтобы этого не происходило, весь кастом выносят в /local/, вместо правки компонентов используют обработчики событий и копируют компоненты в свою папку, а любое обновление сначала прогоняют на тестовой копии.

Золотое правило: никогда не редактируйте файлы в /bitrix/. Всё своё — в /local/.

Если доработки уже лежат в ядре, обновляться «как есть» нельзя: сначала их переносят, потом обновляют. Сводно это выглядит так:

Где лежит доработкаЧто будет при обновленииЧто делать
Правка файлов в /bitrix/Затрётся новой версией файлаПеренести в /local/ или оформить через события
Копия компонента в /local/components/СохранитсяПроверить совместимость на тестовой копии
Шаблон в /local/templates/СохранитсяПроверить вёрстку и вызовы компонентов
Обработчики событий в /local/php_interface/СохранятсяПроверить, что события не изменились

Основная мысль

Обновление 1С-Битрикс безопасно, если соблюдены два условия: собственный код не смешан с ядром и каждое обновление сначала проходит проверку на копии сайта — тогда доработки не теряются, а магазин не падает на глазах у клиентов.

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

Вторая частая причина проблем — обновление сразу на боевом сайте. Даже при идеально вынесенном коде новая версия модуля может изменить поведение, на которое опиралась доработка. Тестовая копия позволяет увидеть это заранее и исправить без спешки.

Третий момент — регулярность. Сайт, который обновляется планово небольшими шагами, почти не доставляет хлопот. Сайт, который не обновлялся годами, накапливает несовместимости, и каждое следующее обновление становится дороже и рискованнее.

Ниже разберём, как устроено обновление, как правильно хранить доработки, как готовиться к апдейту и что проверять после него.

Почему доработки слетают при обновлении

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

Обновление перезаписывает файлы ядра в /bitrix/. Если правки были внесены туда напрямую, они затираются новыми версиями файлов. Вынос кода в /local/ решает проблему: эта папка при обновлении не трогается.

Система обновлений не анализирует, менял ли кто-то файл: она просто кладёт новую версию поверх старой. Поэтому потеря правки происходит молча, без предупреждения, и обнаруживается уже по жалобам клиентов или по сломанному обмену.

Что считается правкой ядра

  • Изменение файлов стандартных компонентов в /bitrix/components/.
  • Правка шаблонов компонентов внутри системных папок.
  • Изменения в файлах модулей, например в логике корзины, доставки или обмена с 1С.
  • Правки системных шаблонов писем и административных страниц.

Все эти изменения работают до первого обновления соответствующего модуля. Причём обновление может прийти не сразу: правка живёт месяцами, о ней забывают, а потом она исчезает вместе с очередным апдейтом, и связать поломку с давней доработкой уже сложно.

Как понять, где лежат доработки

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

Результат такой проверки — список доработок с пометкой, где каждая лежит и что с ней делать. Без этого списка обновление превращается в лотерею.

Как правильно вносить доработки

Папка /local/ как основа

Всё проектное хранится в /local/. Платформа сначала ищет компоненты, шаблоны и настройки там, а затем в /bitrix/. Это позволяет переопределять стандартное поведение, не трогая системные файлы.

  • Кастомные компоненты и шаблоны — в /local/components/ и /local/templates/.
  • Логику подключайте через обработчики событий, а не правку файлов ядра.
  • Нужен изменённый компонент — копируйте его в свою папку и меняйте копию.
  • Свой код и классы — в /local/php_interface/ с автозагрузкой.

Обработчики событий вместо правки ядра

Большинство задач решаются через события: перед сохранением заказа, после добавления товара, при расчёте доставки, при импорте из 1С. Обработчик подключается из /local/php_interface/ и меняет поведение системы, не трогая её файлы. При обновлении модуля обработчик продолжает работать, если само событие сохранилось.

Копирование компонентов

Если стандартный компонент не подходит и изменить его поведение через параметры или шаблон нельзя, его копируют в /local/components/ под своим пространством имён и дорабатывают копию. Минус подхода — копия не получает исправлений из обновлений. Поэтому копировать стоит только то, что действительно требует изменения логики, а внешний вид менять через шаблон.

Шаблоны компонентов

Большая часть визуальных доработок делается в шаблонах компонентов внутри шаблона сайта в /local/templates/. Шаблон отвечает только за вывод, поэтому обновления его не затрагивают, а логика компонента продолжает получать исправления.

Собственные модули

Если доработок много и они связаны между собой, их удобно оформить собственным модулем в /local/modules/. Модуль устанавливается и удаляется как обычный, регистрирует свои обработчики событий и хранит настройки. Такой код проще переносить между копиями сайта, проверять и документировать, а обновления платформы его не затрагивают.

Настройки вместо кода

Часть задач, которые когда-то решали правкой файлов, сейчас закрывается настройками: правила работы с корзиной, свойства заказа, службы доставки, платёжные системы, шаблоны писем. Прежде чем писать код, стоит проверить, нельзя ли получить нужное поведение штатными средствами. Настройка переживает обновление без всяких усилий.

Сравнение подходов

ПодходКогда использоватьПолучает исправления из обновлений
Шаблон компонентаНужно изменить выводДа, логика обновляется
Обработчик событияНужно изменить поведениеДа, если событие сохранилось
Копия компонентаНужно изменить логику компонентаНет, копию поддерживают вручную
Правка ядраНикогдаПравка теряется

Подготовка к обновлению

Резервная копия

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

Тестовая копия

Тестовая копия — отдельная установка сайта с тем же кодом и базой, недоступная клиентам. На ней обновление проходит первым. Важно, чтобы копия не отправляла письма клиентам и не выгружала тестовые заказы в рабочую 1С: эти интеграции на копии отключают или перенаправляют.

Аудит доработок

Если при сравнении с эталоном нашлись правки в /bitrix/, их переносят до обновления: оформляют через события, выносят в копии компонентов или в шаблоны. Это стандартная задача рефакторинга перед апдейтом, и её стоит делать на тестовой копии вместе с самим обновлением.

Фиксация состояния до обновления

Перед обновлением записывают текущие версии ядра и модулей, версию PHP, список активных модулей и агентов, а также делают замеры скорости ключевых страниц. После обновления эти данные позволяют быстро понять, что изменилось. Если, например, после апдейта выросло время ответа, можно сравнить с исходными значениями и не гадать, было ли так раньше.

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

План работ

Перед обновлением полезно записать короткий план: что обновляется, в каком порядке, кто проверяет заказы и обмен с 1С, где лежит бэкап и как откатиться. План не обязан быть длинным, но он снимает спешку в момент, когда что-то пошло не по сценарию, и помогает не забыть важную проверку.

Проверка лицензии

Лицензия 1С-Битрикс бессрочная, но обновления и поддержка даются на год, дальше требуется продление. Если период истёк, обновления будут недоступны. Это стоит проверить заранее, чтобы не остановиться на середине работ.

Чек-лист безопасного обновления

Порядок действий, который подходит для большинства сайтов:

  1. Сделайте полную резервную копию файлов и базы данных.
  2. Разверните тестовую копию сайта и обновляйтесь сначала на ней.
  3. Проверьте, что все доработки лежат в /local/, а не в /bitrix/.
  4. Обновляйте модули пошагово через «Обновление системы», а не всё разом.
  5. После обновления прогоните проверку: заказы, обмен с 1С, формы, личный кабинет.
  6. Только после успешного теста повторите обновление на боевом сайте.

Почему пошагово

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

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

Когда обновлять боевой сайт

Боевой сайт обновляют в период минимальной нагрузки, заранее предупредив ответственных за заказы и обмен с 1С. На время работ полезно иметь план отката: какой бэкап восстанавливать и кто это делает.

Что проверить сразу после обновления

Базовый список

  • Оформление тестового заказа: корзина, доставка, оплата, письма.
  • Обмен с 1С: выгрузка каталога и заказов проходит без ошибок.
  • Формы обратной связи и заявки доходят до почты и CRM.
  • Личный кабинет, авторизация и регистрация работают.
  • Ключевые страницы открываются без ошибок и не «поехала» вёрстка.
  • Скорость и композитный кэш включены и работают.

Сценарии, которые часто забывают

  • Применение скидок и купонов, особенно с нестандартными правилами.
  • Расчёт доставки для разных регионов и способов.
  • Письма клиентам и менеджерам: шаблоны, подстановка данных.
  • Поиск по сайту и умный фильтр в каталоге.
  • Выгрузки для маркетплейсов и рекламных систем, если они есть.

Как проверять быстро

Чтобы проверка не растягивалась и не зависела от памяти конкретного человека, её оформляют как сценарий: список действий и ожидаемый результат для каждого. Например: добавить товар в корзину, применить купон, выбрать доставку в другой регион, оплатить тестовым способом, убедиться, что письмо пришло, а заказ появился в 1С. Такой сценарий проходят одинаково на тестовой копии и на боевом сайте после обновления.

Сценарий полезно дополнять после каждого найденного сбоя. Если однажды сломался расчёт доставки для крупногабаритных товаров, этот случай навсегда попадает в список проверок.

Пример сценария

Магазин обновил модуль продаж на тестовой копии. Витрина и корзина работали, но при проверке оказалось, что обработчик, пересчитывающий доставку для крупногабаритных товаров, перестал срабатывать: изменились данные, которые приходили в событие. Правку внесли на копии, повторили проверку и только потом обновили боевой сайт. Клиенты сбоя не заметили.

Если что-то пошло не так

Откат

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

Поиск причины

Причину ищут в журналах ошибок, в логах обмена с 1С и в списке установленных обновлений. Чаще всего проблема связана с одной из трёх вещей: затёртой правкой ядра, копией компонента, несовместимой с новой версией модуля, или изменением события, на которое опирался обработчик.

Как не повторить ошибку

После исправления стоит разобрать, почему проблема не была замечена на тестовой копии. Возможно, копия отличалась от боевого сайта, в сценарии проверки не было нужного случая или доработка лежала не там, где считалось. Каждый такой вывод делает следующее обновление спокойнее.

Когда нужна помощь

Если сайт после неудачного обновления не открывается или данные повреждены, лучше не экспериментировать на боевой версии. В таких случаях помогает восстановление сайта из резервной копии с последующим разбором причин на тестовой среде.

Если сайт уже взломан

Отдельно стоит помнить о безопасности: устаревшее ядро — одна из частых причин взломов. Если сайт долго не обновлялся и уже ведёт себя подозрительно, начинать нужно с проверки и лечения сайта от вирусов, а затем переходить к обновлению.

Как вести сайт, чтобы обновления стали рутиной

Система контроля версий

Код проекта из /local/ хранят в системе контроля версий. Тогда видно, кто, когда и зачем менял файл, а любую правку можно откатить. Это же защищает от ситуации, когда доработка существует только на боевом сервере и никто не помнит, откуда она взялась.

Документация доработок

Короткий список доработок с описанием, где лежит код и за что он отвечает, экономит часы при каждом обновлении. Новому разработчику не нужно заново изучать весь сайт, а проверку после обновления можно строить по этому списку: каждая доработка — отдельный пункт.

Регламент обновлений

Удобная схема — обновления безопасности по мере выхода, функциональные обновления планово, раз в несколько месяцев, с обязательной проверкой на копии. Когда обновления идут регулярно небольшими порциями, каждое из них проходит быстро и предсказуемо. Когда их откладывают, накапливается отставание, и очередное обновление превращается в отдельный проект.

Постоянная тестовая копия

Если тестовую копию держать постоянно и периодически синхронизировать с боевым сайтом, подготовка к обновлению сокращается до минимума. На этой же копии удобно проверять новые доработки перед выкладкой, а не только обновления платформы.

Типичные ошибки

  • Обновление сразу на боевом. Главная причина падений магазина.
  • Правки в /bitrix/ «на пять минут». Затираются при ближайшем обновлении.
  • Отсутствие проверенного бэкапа. Копия есть, но восстановиться из неё не получается.
  • Все модули одной пачкой. Сложно найти, что именно сломалось.
  • Тестовая копия с рабочими интеграциями. Клиенты получают тестовые письма, в 1С попадают тестовые заказы.
  • Отставание на годы. Чем дольше сайт не обновлялся, тем больше несовместимостей накапливается и тем дороже обновление.
  • Проверка только главной страницы. Ошибки чаще всего прячутся в заказе, обмене и личном кабинете.

Частые вопросы

Что делать, если доработки уже в /bitrix/?

Перед обновлением их нужно перенести в /local/ или оформить через события. Иначе ближайшее обновление их затрёт. Это стандартная задача рефакторинга перед апдейтом.

Обязательно ли тестовое окружение?

Да. Обновление сразу на боевом — главная причина падений магазина. Копия сайта позволяет поймать проблемы до того, как их увидят клиенты. Для небольшого сайта копию можно развернуть на том же хостинге в закрытом от посетителей разделе, главное — отключить на ней рассылки и обмен с рабочей 1С.

Можно ли не обновляться вообще?

Технически сайт продолжит работать, но устаревшее ядро — это риски безопасности и несовместимость с новыми возможностями и обменом с 1С. Обновления безопасности ставить нужно. Кроме того, со временем старое ядро перестаёт работать с актуальными версиями PHP, и хостинг может вынудить обновиться в самый неудобный момент.

Как часто нужно обновляться?

Обновления безопасности ставьте по мере выхода. Крупные функциональные обновления — планово, раз в несколько месяцев, обязательно через тестовую копию. Главное — не накапливать отставание на годы. Небольшие регулярные обновления проходят быстрее и дешевле, чем одно большое после долгого перерыва.

Сломает ли обновление обмен с 1С?

При корректных доработках — нет. Риск возникает, когда обмен «допилен» правкой ядра. Поэтому обмен всегда проверяют на тестовой копии до обновления боевого сайта.

Как узнать, есть ли на сайте правки ядра?

Сравнить файлы в /bitrix/ с эталонной версией той же редакции. Все отличия — это либо правки, которые нужно перенести, либо следы старых обновлений, которые стоит проверить.

Что будет, если закончился период обновлений по лицензии?

Сайт продолжит работать, но новые обновления, в том числе обновления безопасности, будут недоступны до продления. Лицензия при этом остаётся бессрочной.

Можно ли обновить сайт, который не обновлялся несколько лет?

Можно, но это отдельный проект: больше риск несовместимости доработок, больше проверок. Такое обновление делают поэтапно на тестовой копии и закладывают время на исправления.

Нужно ли обновлять PHP вместе с Битриксом?

Часто да: новые версии платформы рассчитаны на актуальный PHP. Но менять их одновременно не стоит — сначала один шаг, проверка, затем другой, иначе сложно понять причину ошибки.

Затронет ли обновление шаблон сайта?

Шаблон в /local/templates/ обновление не перезаписывает. Но если изменились стандартные компоненты, вывод в шаблоне может потребовать правок, поэтому вёрстку проверяют на тестовой копии. Особенно внимательно смотрят карточку товара, корзину и оформление заказа: там шаблоны чаще всего опираются на данные, которые передаёт компонент.

Можно ли обновлять Битрикс самостоятельно?

Если сайт небольшой, доработок почти нет и они лежат в /local/, обновление через «Обновление системы» вполне по силам администратору. Главное — не пропускать бэкап и тестовую копию. Если же на сайте магазин с обменом с 1С, нестандартными скидками и доставкой или неизвестно, где лежат правки, лучше доверить обновление разработчику, который сначала проверит код.

Сколько стоит обновление с переносом доработок?

Зависит от числа правок в ядре и давности последнего обновления. Такие работы обычно оцениваются почасово, от 2 000 ₽ в час, а объём становится понятен после сравнения с эталоном.

Итог

Обновление 1С-Битрикс не должно быть рискованным. Доработки теряются только тогда, когда их вносили в ядро, а магазин падает только тогда, когда обновление ставят сразу на боевой сайт без проверки.

Рабочая схема проста: весь проектный код в /local/, логика через события и копии компонентов, проверенный бэкап, тестовая копия, пошаговое обновление и проверка заказов, обмена с 1С, форм и личного кабинета. Если правки уже в /bitrix/, их переносят до апдейта, а не после.

Если нужно обновить сайт на 1С-Битрикс и сохранить все доработки, я как частный разработчик могу проверить код на правки ядра, перенести их в /local/, обновить сайт на тестовой копии и затем на боевом. Подробнее — на странице услуги доработка сайта на 1С-Битрикс. Работаю напрямую, без посредников.