Настройка импорта/экспорта товаров 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;"Полное описание куртки...";"Куртка зимняя";"куртка, зима, мужская";"Купить куртку зимнюю мужскую";"Куртка зимняя мужская — купить";"kurtka-zimnyaya-muzhskaya";"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
            );
        }
    }
    // Пауза между батчами для снижения нагрузки
    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 дней