Як оновити ядро і модулі OpenCart без зайвого головного болю
Чому оновлення OpenCart — головний біль для власника?
Клієнт оновив OpenCart 2 до 3 — і зламався платіжний шлюз: API order_status змінився, замовлення перестали потрапляти в систему. Без досвіду ви втратите тижні. Ми ж розібрали проблему за пару годин. У нас за плечима 5+ років і 30+ проектів з оновлення OpenCart. При правильному підході апдейт пройде без простоїв, а ви отримаєте безпечний та швидкий магазин. Економія на підтримці після своєчасного оновлення може сягати 30%, а вартість оновлення в рази менша за відновлення після злому на застарілій версії.
Підготовка та ризики
Чому бекап критичний?
Без повного бекапу ви ризикуєте втратити дані клієнтів та історію замовлень. Ми використовуємо rsync для файлів і mysqldump для бази, зберігаємо снапшоти на окремому сервері. Це дозволяє відкотитися за 15 хвилин. Виконайте команди на сервері:
# Бекап файлів і БД tar czf /backups/opencart-$(date +%Y%m%d).tar.gz /var/www/shop.com mysqldump -u root opencart_db > /backups/opencart-db-$(date +%Y%m%d).sql Два головні ризики — втрата кастомізацій та несумісність модулів. OpenCart використовує модифікації OCMOD, які зберігаються окремо від ядра. Якщо просто скопіювати нову версію поверх, OCMOD не злетять, але можуть виникнути конфлікти. Другий ризик — база даних: міграція може обірватися через таймаут. Наш інженер завжди перевіряє лог помилок SQL.
Як оновити ядро: порівняння методів
| Критерій | Вбудований (OC 3.0.3+) | Ручний |
|---|---|---|
| Зручність | Так, 2 кліки | Потребує SSH-доступу |
| Конфігурація | Не затирає config.php | Потрібно налаштувати винятки |
| OCMOD | Автоматично refresh | Вручну Refresh в адмінці |
| Міграція БД | Вбудований скрипт | cli_install.php upgrade |
Ручне оновлення дає більше контролю, але вбудоване швидше. Для стандартних конфігурацій підійде вбудований механізм.
Вбудоване оновлення: Admin → Extensions → Installer → вкладка Updates. Ручне оновлення:
# Завантажити нову версію wget https://github.com/opencart/opencart/releases/download/4.x.x/opencart-4.x.x.zip unzip opencart-4.x.x.zip # Скопіювати лише файли ядра (не затираючи config.php та модифікації) rsync -avz --exclude='config.php' \ --exclude='admin/config.php' \ --exclude='image/' \ --exclude='system/storage/upload/' \ opencart-4.x.x/upload/ \ /var/www/shop.com/ # Запустити міграцію БД php /var/www/shop.com/install/cli_install.php upgrade Як оновити модулі та OCMOD?
OCMOD дозволяє встановлювати модифікації не змінюючи файли ядра. При оновленні ядра модифікації застосовуються заново: Admin → Extensions → Modifications → Refresh. Модифікації зберігаються окремо — вони не перезаписуються при оновленні ядра.
Оновлення платних розширень: Admin → Extensions → Marketplace → Install, або вручну через Extension Installer (Upload .zip). Після встановлення: Refresh модифікацій та очищення кешу. Проблема: платні модулі часто прив'язані до версії ядра. Перед оновленням ядра перевірте сумісність кожного модуля на сайті розробника. Якщо модуль не оновлюється, зв'яжіться з нами — можливо, знадобиться адаптація коду.
Міграція з OC3 на OC4
Прямого upgrade немає — структура БД змінилася значно. Рекомендований шлях:
- Встановити OpenCart 4 на новий сервер
- Мігрувати контент (товари, категорії, замовлення) через export/import
- Знайти OC4-сумісні версії всіх розширень
- Перенести кастомні шаблони (OC4 використовує Twig замість PHP-шаблонів)
-- Експорт товарів з OC3 SELECT p.product_id, pd.name, p.model, p.sku, p.price, p.quantity, p.status FROM oc_product p JOIN oc_product_description pd ON p.product_id = pd.product_id AND pd.language_id = 1 INTO OUTFILE '/tmp/products_export.csv' FIELDS TERMINATED BY ',' ENCLOSED BY '"' LINES TERMINATED BY '\n'; | Параметр | OpenCart 3 | OpenCart 4 |
|---|---|---|
| Шаблони | PHP | Twig |
| API | застарілий | RESTful API |
| Підтримка PHP | до 7.4 | 8.0+ |
| Продуктивність | середня | вища за рахунок кешування |
Що робити, якщо після оновлення модуль перестав працювати?
Перевірте сумісність модуля: відкрийте його сторінку на Marketplace або зв'яжіться з розробником. Якщо модуль платний, запитайте оновлену версію. Тимчасово вимкніть модуль в адмінці (Extensions → Extensions → виберіть тип і натисніть Disable). Якщо проблема в OCMOD, відредагуйте файл модифікації вручну або видаліть його через Modifications. Не забудьте очистити кеш.
Перевірка та усунення помилок
Після оновлення виконайте:
# Помилки PHP tail -f /var/log/php/error.log # Очистити всі кеші rm -rf /var/www/shop.com/system/storage/cache/* Після очищення кешу перевірте роботу кошика, оформлення замовлення та платіжного шлюзу. Якщо щось пішло не так — поверніться до бекапу.
Що входить в роботу з оновлення
Ми надаємо повний комплекс послуг:
- Повний бекап файлів і бази даних
- Перевірка сумісності всіх встановлених модулів та розширень
- Оновлення ядра зі збереженням OCMOD-модифікацій
- Тестування оформлення замовлення, платежів, логістики
- Усунення конфліктів (якщо виникли)
- Документація змін та консультація щодо подальшої підтримки
- Гарантія 30 днів на коректну роботу після оновлення
Терміни та вартість
Оновлення в межах однієї мажорної версії — від 2 до 4 годин. Перехід з OC3 на OC4 — від 2 тижнів, включаючи перенесення даних та адаптацію шаблонів. Ціна розраховується індивідуально, залежить від кількості модулів та кастомізацій. Залиште заявку — отримайте консультацію інженера та оцінку проекту під ключ.