Переезд с OpenServer на Omut: Битрикс на Windows без OSPanel
Как перенести сайт на 1С-Битрикс из OSPanel в Omut на Windows: дамп базы, папка проекта, домен .bitrix, версия PHP, агенты на cron и почта. И где при переезде обычно спотыкаются.
Кирилл Новожилов
автор Omut, BXMax
Сайт на Битриксе в OSPanel — это две вещи: папка проекта в home\ и база в модуле MySQL. Переезд в другое окружение сводится к тому, чтобы унести обе и не потерять по дороге пути, домен и кодировку. Ниже порядок переезда и места, где обычно спотыкаются.
Пишу на примере Omut под Windows 10 и 11, но первые два раздела годятся для любого окружения.
Что забрать из OSPanel
Папку проекта. В OSPanel 6 проекты лежат в C:\OSPanel\home\<домен>\, настройки проекта — в .osp\project.ini внутри папки. Посмотрите там web_root: если веб-корень указывает на подпапку, переносить нужно именно её — ту, где лежит bitrix\. В OSPanel 5 проекты жили в domains\, остальное так же.
Базу. Надёжнее всего mysqldump из командной строки OSPanel (она открывается из меню панели). Сначала подключите окружение нужного модуля, затем снимите дамп:
osp use MySQL-8.0
mysqldump -u root --single-transaction --routines --triggers --default-character-set=utf8mb4 shop > C:\dump\shop.sql
Имя модуля возьмите из своей панели. По умолчанию у MySQL в OSPanel пользователь root без пароля, но если вы его задавали — добавьте -p.
Через phpMyAdmin дамп тоже снимается, но на базе в несколько сотен мегабайт он упирается в лимиты PHP и обрывается без внятной ошибки. С mysqldump такого нет.
Если файлов много. Папка upload\ у живого магазина весит гигабайты. Её можно не копировать вовсе — ниже покажу, как подключить проект прямо из папки OSPanel.
Остановите OSPanel
OSPanel держит порты 80, 443 и 3306. Веб-сервер Omut при занятом 80-м уйдёт на запасной порт 8765, и адреса сайтов станут длиннее. С MySQL хуже: MySQL 8.4 в Omut тоже слушает 3306 и при занятом порте не запустится. Остановите OSPanel и уберите его из автозапуска.
Установка Omut
Установщик Omut-setup.exe без подписи издателя, поэтому SmartScreen покажет синее окно «Система Windows защитила ваш компьютер». Нажмите Подробнее → Выполнить в любом случае. Ставится Omut в профиль пользователя, права администратора нужны один раз — когда он прописывает правило для доменов .bitrix.
Если Защитник Windows отправил в карантин php-cgi.exe или mysqld.exe, окружение не запустится. Восстановите файл в журнале защиты и добавьте %LOCALAPPDATA%\Omut\ в исключения — подробнее в установке на Windows.
Подключите проект
Добавить сайт → Существующий проект. Имя сайта станет доменом: shop откроется как shop.bitrix. Папку можно указать прямо в C:\OSPanel\home\ — файлы останутся на месте.
Omut заведёт для сайта пустую базу omut_shop и переключит на неё bitrix\.settings.php. Прежний файл он сохранит рядом. Если решите вернуться в OSPanel, достаточно вернуть его.
Загрузите дамп
На странице сайта: База данных → Загрузить дамп, выберите файл .sql или .sql.gz. В поле «Домен на боевом сервере» укажите старый адрес — например, shop.local из OSPanel. Omut заменит его на shop.bitrix прямо при импорте и поправит адрес сайта в настройках Битрикса.
Дамп идёт напрямую в MySQL, мимо PHP, поэтому размер базы роли не играет. После импорта Omut показывает отчёт: сколько выполнено, что вырезано из дампа и почему.
Вырезает он то, что в чужом окружении либо ломает импорт, либо стреляет позже: DEFINER у представлений и триггеров (такого пользователя MySQL здесь нет), CREATE DATABASE и USE (дамп писал бы в базу с прежним именем), строгие режимы SQL_MODE (на датах 0000-00-00 из старых баз импорт падает). Если в отчёте пусто — дамп был чистый.
Что донастроить
Версия PHP. В OSPanel она задаётся в project.ini (php_engine), в Omut — на вкладке Настройки у сайта: 7.4 и 8.1–8.5. Разные версии на разных сайтах — возможность Pro. Если проект на старом ядре и не работает на PHP 8, ставьте 7.4: на Windows это официальная сборка 7.4.33.
Агенты. В OSPanel агенты Битрикса обычно выполнялись на хитах, потому что cron под Windows настраивать некому. В Omut на вкладке Настройки есть переключатель «Агенты на cron»: Omut запускает cron_events.php сам, и рассылки с обменом с 1С перестают зависеть от того, открыт ли сайт.
Почта. Письма из mail() Omut перехватывает и показывает в разделе «Почта», наружу они не уходят. На копии боевой базы это полезно: клиенты магазина не получат писем о заказах, которые вы оформляете при отладке. Почта этого компьютера — возможность Pro.
HTTPS. Переключатель на странице сайта. Сертификат Omut ставит в хранилище Windows для текущего пользователя, Chrome и Edge берут его оттуда.
Где спотыкаются
Абсолютные пути. Битрикс иногда хранит полный путь к сайту: в dbconn.php (BX_TEMPORARY_FILES_DIRECTORY), в настройках сайта (поле «Путь к корневой папке веб-сервера» у многосайтовых конфигураций), в настройках модулей. После переезда там остаётся C:\OSPanel\home\…. Поищите по проекту и по дампу строку OSPanel — обычно находится одно-два места.
Кэш. Кэш, собранный в OSPanel, ссылается на старые пути. После первого открытия сайта очистите его: Очистить кэш в меню «Ещё» на странице сайта. Omut заодно сбросит кэш PHP, который админка Битрикса не трогает.
Кодировка. Старые проекты бывают в windows-1251. Дамп снимайте с той кодировкой, в которой лежат данные, иначе кириллица в базе превратится в знаки вопроса. Если не уверены, посмотрите SHOW CREATE TABLE b_option в OSPanel.
Кириллица в имени пользователя Windows. Если папка профиля называется вроде C:\Users\Александр, Omut до v1.1.3 не запускал nginx. В текущих версиях это исправлено, но держите в голове, если читаете старые инструкции.
Свои правила веб-сервера. Если в OSPanel вы правили конфиг Apache или .htaccess с нестандартными правилами, nginx их не прочитает. Свои директивы для конкретного сайта в Omut пишутся в отдельном файле — см. раздел о сайтах.
Если команда на Windows и на Маке
OSPanel есть только под Windows. Omut работает на Windows, macOS и Linux одинаково: тот же домен shop.bitrix, те же версии PHP и MySQL, те же кнопки. Если в команде появился Mac, второй инструмент заводить не придётся.