Типовая картина: файлы залиты, база импортирована, вводите домен и видите белый экран. Или открывается главная, но без единой картинки, а админка выдаёт ошибку 500. Сам процесс переноса OpenCart несложный, магазин состоит из файлов и одной базы MySQL. Проблемы почти всегда прячутся в двух конфигах и в мелочах, о которых вспоминают уже после переезда.
Что именно переносим
Две вещи: все файлы из корня сайта и дамп базы данных. Больше ничего. Лицензий, привязок к серверу или скрытых зависимостей в стандартном OpenCart нет. Другое дело платные модули: каждый лицензируется по-своему, где-то привязка к домену, где-то к серверу, а где-то её нет вообще. Если такие модули у вас установлены, напишите разработчику каждого ещё до переезда и уточните, нужно ли переоформить лицензию. Это индивидуально для каждого модуля, универсального правила здесь нет.
Перед стартом зафиксируйте версии на старом сервере: версию OpenCart (видно в футере админки) и версию PHP (просто файл с phpinfo()). Вторая цифра критична: переезд, скажем, с PHP 7.4 на 8.1 вместе со сменой хостинга превращает поиск проблемы в лотерею. Вы не поймёте, что сломалось: сервер, конфиг или несовместимый модуль. Сначала переезжайте на ту же версию PHP, а уже потом, на новом месте, экспериментируйте с повышением.
Шаг 1. Резервные копии
Файлы удобнее упаковать архивом на сервере, а не тянуть 40 тысяч мелких файлов по FTP. Если есть SSH:
tar -czf shop-files.tar.gz -C /var/www/mysite/public_html . mysqldump -u db_user -p db_name > shop-db.sql
Без SSH подойдёт phpMyAdmin для базы и архиватор в файловом менеджере панели. На большой базе phpMyAdmin может обрезать экспорт по таймауту, тогда попросите техподдержку хостинга сделать дамп или воспользуйтесь скриптом вроде Sypex Dumper.
Копии сделайте до любых действий и не удаляйте старый сайт, пока новый не проработает хотя бы неделю.
Шаг 2. Файлы и база на новом сервере
Распакуйте архив в корень сайта, создайте в панели новую базу и пользователя, импортируйте дамп. Здесь одна ловушка: кодировка. Если старая база была в utf8, а новая создана как utf8mb4 (или наоборот), после импорта кириллица может превратиться в знаки вопроса. Проверьте кодировку дампа в первых строках файла и создавайте базу с той же.
Шаг 3. config.php и admin/config.php
Именно здесь спрятано большинство белых экранов. В корне лежит config.php, в папке админки второй такой же, и править нужно оба. Внутри два блока: пути к папкам и доступы к базе.
Неправильно (пути остались от старого сервера):
define('DIR_APPLICATION', '/home/olduser/public_html/catalog/');
define('DB_USERNAME', 'olduser_shop');
Правильно (актуальный путь и новые доступы):
define('DIR_APPLICATION', '/var/www/mysite/public_html/catalog/');
define('DB_USERNAME', 'newuser_shop');
Полный путь к корню на новом сервере подскажет панель или команда pwd в нужной папке. В admin/config.phpпутей больше, там отдельно прописаны DIR_CATALOG и HTTP_CATALOG, не пропустите их. В OpenCart 3.x обратите внимание ещё на DIR_STORAGE: если на старом сервере папку storage выносили за пределы public_html (движок сам это предлагает), на новом её нужно положить так же и указать корректный путь.
Если после правки конфигов сайт молчит, не гадайте. Откройте system/storage/logs/error.log или лог PHP в панели: там будет точный файл и строка, обычно это недописанный путь или старый пароль базы.
Шаг 4. Права доступа и PHP
На большинстве хостингов достаточно 755 для папок и 644 для файлов; выставлять 777 не нужно, это не лечит проблему, а лишь открывает дыру.
Проверьте в панели версию PHP и лимиты: max_input_vars от 10000 (иначе не сохранятся большие модули и меню), memory_limit от 256M, upload_max_filesize под ваши импорты. Если магазин жил на Apache с .htaccess, а новый сервер на NGINX, правила ЧПУ придётся переписать под формат NGINX, иначе все SEO-адреса будут отдавать 404, при том что главная работает как ни в чём не бывало.
Шаг 5. После переезда
Зайдите в админку и обновите кеш модификаторов: Расширения → Модификаторы → кнопка «Обновить». Без этого OCMOD-правки могут подхватиться из старого кеша с чужими путями. В OpenCart 3.x дополнительно очистите кеш темы и SASS через значок шестерёнки на главной странице админки.
Далее пройдитесь по живому магазину: категория, карточка товара, поиск, добавление в корзину, оформление заказа до конца. Отдельно проверьте почту: если стоял SMTP старого хостинга, письма о заказах тихо перестанут доходить, и вы узнаете об этом от клиента через неделю. И посмотрите в error.log в ближайшие несколько дней, мелкие недоперенесённые вещи всплывают именно там.
Домен переключайте на новый сервер после всех проверок (тестировать можно через файл hosts на своём компьютере). TTL DNS-записи лучше заранее снизить до 300–600 секунд, тогда переключение пройдёт за минуты, а не за сутки.
Чек-лист переноса
- Зафиксирована версия OpenCart и версия PHP старого сервера
- Написано разработчикам платных модулей о переоформлении лицензий
- Сделан архив файлов и дамп базы, копии сохранены локально
- База создана с той же кодировкой, что и дамп
- Исправлены пути и доступы в
config.phpиadmin/config.php - Для OC 3.x: проверены
DIR_STORAGEи расположение папки storage - Права: 755 на папки, 644 на файлы
- PHP той же версии,
max_input_vars≥ 10000 - Переписаны правила ЧПУ, если сменился веб-сервер (Apache → NGINX)
- Обновлён кеш модификаторов, для OC 3.x очищен кеш темы
- Пройден путь покупателя до оформления заказа, проверена почта
- Снижен TTL, домен переключён, старый сервер живёт ещё неделю про запас