# Как обновить 1С-Битрикс без потери доработок

URL: https://chugunov.pro/obnovlenie-1s-bitriks-bez-poteri-dorabotok/
Обновлено: 04.10.2026.
Источник: chugunov.pro.

Создание сайтов25.07.2026Алексей Чугунов

## Остались вопросы?

Отправьте сообщение, и я свяжусь с вами в ближайшее время

Или звоните, обсудим детали.

[+7 915 016-99-88](tel:+79150169988)

## Коротко

Доработки «слетают» при обновлении 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С и в списке установленных обновлений. Чаще всего проблема связана с одной из трёх вещей: затёртой правкой ядра, копией компонента, несовместимой с новой версией модуля, или изменением события, на которое опирался обработчик.

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

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

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

Если сайт после неудачного обновления не открывается или данные повреждены, лучше не экспериментировать на боевой версии. В таких случаях помогает [восстановление сайта](https://chugunov.pro/uslugi/vosstanovlenie-sajta/) из резервной копии с последующим разбором причин на тестовой среде.

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

Отдельно стоит помнить о безопасности: устаревшее ядро — одна из частых причин взломов. Если сайт долго не обновлялся и уже ведёт себя подозрительно, начинать нужно с проверки и [лечения сайта от вирусов](https://chugunov.pro/uslugi/lechenie-sajta-ot-virusov/), а затем переходить к обновлению.

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

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

Код проекта из /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С-Битрикс](https://chugunov.pro/uslugi/dorabotka-sajta-1s-bitriks/). Работаю напрямую, без посредников.

- 25.07.2026

## Связанное на сайте

- Услуга [Перенос сайта на Битрикс](https://chugunov.pro/uslugi/perenos-sajta-na-bitriks/)
- Справочник API [Справочник API 1С-Битрикс](https://chugunov.pro/api-bitrix/)
- Глоссарий [Глоссарий: 1С-Битрикс](https://chugunov.pro/glossary/bitrix/)

Автор статьи [Чугунов Алексей](https://chugunov.pro/about/) Fullstack-разработчик: 1С-Битрикс, WordPress, PHP
[Обо мне](https://chugunov.pro/about/)
