Налаштування імпорту/експорту товарів PrestaShop

Настройка імпорту/експорту товарів PrestaShop

PrestaShop має вбудований імпортер в розділі Advanced Parameters → Import. Для production-задач з обсягом від 5 000 товарів вбудований інструмент потребує тонкого налаштування або замісту на користувацький розв'язок з пакетною обробкою та управлінням пам'яттю.

Структура CSV для імпорту товарів

PrestaShop-імпортер очікує фіксований набір полів. Роздільник та кодування настроюються при завантаженні:

ID;Active (0/1);Name *;Categories;Price tax excl.;Tax rules ID;Wholesale price;On sale (0/1);Discount amount;Discount percent;Discount from (yyyy-mm-dd);Discount to (yyyy-mm-dd);Reference #;Supplier reference #;Supplier;Brand;EAN13;UPC;MPN;Ecotax;Weight;Quantity;Description;Short description;Tags (x,y,z...);Meta title;Meta description;URL rewritten;Image URLs (x,y,z...);Image alt texts (x,y,z...);Feature (Name:Value:Position:Customized);Available for order;Available date;Show price;Visibility;Additional shipping cost;Unity;Unit price;Summary;Shop (for multi-shop only)
;1;Зимова чоловіча куртка;Верхній одяг,Чоловічий одяг;2999.00;1;0;0;0;0;;;ART-001;;Бренд;КуртаБренд;4607167430120;;;0;1.5;50;"Повний опис куртки...";"Зимова куртка";"куртка, зима, чоловіча";"Купити зимову чоловічу куртку";"Зимова чоловіча куртка — купити";"zimova-chоlovichа-kurtka";"https://cdn.example.com/img1.jpg,https://cdn.example.com/img2.jpg";"Куртка вид 1,Куртка вид 2";"Колір:Чорний:1:0;Розмір:L:2:0";1;;;1;everywhere;0;;;

Конфігурація для масового імпорту

За замовчуванням PHP-процес імпорту натикається на memory_limit та max_execution_time. Для файлів від 10 000 рядків:

// override/controllers/admin/AdminImportController.php
class AdminImportControllerCore extends AdminImportController
{
    public function __construct()
    {
        parent::__construct();
        @ini_set('memory_limit', '512M');
        @ini_set('max_execution_time', '3600');
    }

    // Зменшення розміру batch для економії пам'яті
    const MAX_LINE_SIZE = 4096;  // байт на рядок
}

Або через настройку PHP-FPM пула для процесів імпорту:

; /etc/php/8.1/fpm/pool.d/prestashop-import.conf
[prestashop-import]
pm = static
pm.max_children = 2
php_value[memory_limit] = 1G
php_value[max_execution_time] = 7200

Програмний імпорт через ObjectModel

Для інтеграції з ERP/1С рекомендується обходити веб-імпортер та працювати прямо через API PrestaShop:

// Імпорт товара з атрибутами
class ProductImporter
{
    private int $defaultLangId;
    private int $shopId;

    public function importProduct(array $data): int
    {
        $product = new Product();
        $product->name[$this->defaultLangId]              = $data['name'];
        $product->description[$this->defaultLangId]       = $data['description'];
        $product->description_short[$this->defaultLangId] = $data['short_description'];
        $product->link_rewrite[$this->defaultLangId]      = Tools::link_rewrite($data['name']);
        $product->reference    = $data['sku'];
        $product->price        = (float) $data['price'];
        $product->weight       = (float) ($data['weight'] ?? 0);
        $product->active       = 1;
        $product->id_category_default = $data['category_id'];
        $product->id_shop_default     = $this->shopId;

        if (!$product->add()) {
            throw new \RuntimeException('Failed to add product: ' . $data['sku']);
        }

        // Прив'язка до категорій
        $product->addToCategories($data['category_ids']);

        // Оновлення залишків
        StockAvailable::setQuantity($product->id, 0, (int) $data['qty']);

        // Індексація після додавання
        Search::indexation(false, $product->id);

        return (int) $product->id;
    }

    public function importImage(int $productId, string $imageUrl, string $legend = ''): void
    {
        $image = new Image();
        $image->id_product  = $productId;
        $image->position    = Image::getHighestPosition($productId) + 1;
        $image->cover       = !Image::getCover($productId);
        $image->add();

        $imageFile = _PS_PRODUCT_IMG_DIR_ . $image->getImgPath() . '.jpg';
        Tools::copy($imageUrl, $imageFile);
        $imageObj = new ImageManager();
        $imageObj->resize($imageFile, $imageFile, null, null, 'jpg', false, $error, null, 95, true);
        Image::generateImgSize($imageFile, $image->id_product, $image->id);
    }
}

Експорт через WebService API

PrestaShop WebService надає REST API для експорту:

# Отримання списку товарів через WebService
curl "https://example.com/api/products?ws_key=YOUR_API_KEY&output_format=JSON&limit=100&page=1&display=full"

# Фільтрація за датою змінення
curl "https://example.com/api/products?ws_key=KEY&output_format=JSON&filter[date_upd]=[2024-01-01,2024-12-31]&date=1"

PHP-клієнт для систематичного експорту:

$client = new PrestaShopWebservice('https://example.com', 'YOUR_API_KEY', false);

$params = [
    'resource' => 'products',
    'display'  => '[id,reference,name,price,quantity]',
    'sort'     => '[id_ASC]',
    'limit'    => '100,100', // offset=100, limit=100
];

$xml = $client->get($params);
$products = $xml->products->product;

Настройка модуля імпорту для cron

Для регулярного оновлення каталогу з зовнішнього джерела:

// modules/erpimport/cron.php
define('_PS_ADMIN_DIR_', getcwd());
include(dirname(__FILE__) . '/../../config/config.inc.php');

$importer = new ErpProductImporter();
$products = $importer->fetchFromErp(strtotime('-1 hour')); // змінені за годину

foreach (array_chunk($products, 100) as $batch) {
    foreach ($batch as $productData) {
        try {
            $importer->upsert($productData);
        } catch (Exception $e) {
            PrestaShopLogger::addLog(
                'ERP import error: ' . $e->getMessage(),
                3, // severity: error
                null, 'Product', $productData['id'] ?? 0
            );
        }
    }
    // Пауза між batch'ами для зменшення навантаження
    usleep(100000); // 100ms
}

# Cron запис
*/30 * * * * www-data php /var/www/prestashop/modules/erpimport/cron.php >> /var/log/prestashop/erp-import.log 2>&1

Графік проекту

• Настройка вбудованого імпортера + тестовий імпорт: 4–8 годин
• Розробка користувацького імпортера з ERP-інтеграцією: 3–7 днів
• Настройка регулярної синхронізації з моніторингом помилок: 2–3 дні
• Міграція каталогу 10 000+ SKU з зображеннями: 3–7 днів