Міграція сайту з OpenCart 3 на OpenCart 4

Міграція сайту з OpenCart 3 на OpenCart 4

OpenCart 4 — значне оновлення: PHP 8.0+, Twig-шаблони (замість PHP), переробена система розширень, новий Storage API, оновлені таблиці БД. Прямий upgrade неможливий — потрібна міграція даних та повна переробка кастомного коду.

Що змінилося в OC4

Шаблони: PHP → Twig. Всі .tpl.php файли потрібно переписати на .twig.

Розширення: OCMOD замінений на Events System для модифікацій ядра без patching файлів.

Сховище: DIR_UPLOAD перенесений, структура storage змінилася.

Адміністративна панель: повністю переробена.

Підготовка

# Список розширень OC3
# Admin → Extensions → Installed extensions

# Перевірка PHP-сумісності
php -v  # OC4 вимагає PHP 8.0+

# Експорт даних з OC3
mysqldump -u root opencart3_db > oc3_backup.sql

Експорт даних для переносу

-- Товари
SELECT
    p.product_id, pd.name, pd.description, pd.meta_title, pd.meta_description,
    p.model, p.sku, p.price, p.quantity, p.status, p.sort_order,
    GROUP_CONCAT(DISTINCT pic.category_id) as categories,
    GROUP_CONCAT(DISTINCT pi.image) as images
FROM oc_product p
JOIN oc_product_description pd ON pd.product_id = p.product_id AND pd.language_id = 1
LEFT JOIN oc_product_to_category pic ON pic.product_id = p.product_id
LEFT JOIN oc_product_image pi ON pi.product_id = p.product_id
GROUP BY p.product_id;

-- Заказы (історія)
SELECT o.*, os.name as status_name
FROM oc_order o
JOIN oc_order_status os ON os.order_status_id = o.order_status_id AND os.language_id = 1
WHERE o.order_status_id > 0;

-- Покупатели
SELECT c.*, ca.*
FROM oc_customer c
JOIN oc_address ca ON ca.customer_id = c.customer_id AND ca.default = 1;

Установка OC4 та базова налаштування

# Установити OpenCart 4
composer create-project opencart/opencart shop.com 4.x-dev
# або скачати zip з GitHub releases

# Налаштувати Nginx
# OC4 використовує public/ як web-root

Перенос даних через OC4 Import

OC4 має розширені можливості імпорту через Admin → Catalog → Products → Import.

Формат CSV для імпорту:

product_id,name(en-gb),description(en-gb),model,sku,price,quantity,status,category_id(0),category_id(1)
1,"Назва товара","Опис","MODEL-001","SKU-001",1500.00,10,1,5,7

Перенос зображень

# Структура image/ папки однакова в OC3 та OC4
rsync -avz /var/www/oc3-shop/image/ /var/www/oc4-shop/image/

Міграція шаблону OC3 → OC4 Twig

// OC3 шаблон (catalog/view/theme/default/template/product/product.tpl.php)
<?php foreach ($products as $product) { ?>
<div class="product-thumb">
    <a href="<?php echo $product['href']; ?>"><?php echo $product['name']; ?></a>
    <span><?php echo $product['price']; ?></span>
</div>
<?php } ?>

{# OC4 шаблон (catalog/view/template/product/product.twig) #}
{% for product in products %}
<div class="product-thumb">
    <a href="{{ product.href }}">{{ product.name }}</a>
    <span>{{ product.price }}</span>
</div>
{% endfor %}

OCMOD → Events (OC4)

// OC3 OCMOD модифікація (XML-патчинг файлів)
// <modification>
//   <file path="catalog/view/theme/*/template/product/product.twig">
//     <operation>...

// OC4 Event (без патчингу)
class ExtensionMyExtensionEventProductList {
    public function index(&$route, &$data): void {
        // Модифікація даних перед передачею в шаблон
        foreach ($data['products'] as &$product) {
            $product['custom_badge'] = 'Акція';
        }
    }
}

Строк виконання