Миграция сайта с 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 template (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 template (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'] = 'Акция';
        }
    }
}

Сроки