README

This plugin provides a complete migration solution from PrestaShop to Sylius 2.x, handling all major entities including products, customers, orders, and configurations.

Features

Complete data migration from PrestaShop to Sylius
Support for Sylius 2.x and Symfony 7
Automatic duplicate detection and handling
Dry-run mode for safe testing
Migration status checking
Translatable entities support
Image migration for products
Extensible architecture with decorators

Installation

1. Add the plugin to your Sylius project

composer require acseo/sylius2-prestashop-migration-plugin

2. Enable the plugin

Add the plugin to your config/bundles.php:

return [
    // ...
    ACSEO\PrestashopMigrationPlugin\PrestashopMigrationPlugin::class => ['all' => true],
];

3. Configure the PrestaShop database connection

Create or update config/packages/doctrine.yaml:

doctrine:
    dbal:
        connections:
            default:
                # Your Sylius database configuration
                url: '%env(resolve:DATABASE_URL)%'

            prestashop:
                url: '%env(resolve:PRESTASHOP_DATABASE_URL)%'
                driver: 'pdo_mysql'

Add the PrestaShop database URL to your .env file:

PRESTASHOP_DATABASE_URL="mysql://user:password@localhost:3306/prestashop_db?serverVersion=8.0"

4. Configure the plugin

Create config/packages/prestashop_migration.yaml:

parameters:
    prestashop.prefix: 'ps_'
    prestashop.public_directory: '%kernel.project_dir%/public/prestashop'
    prestashop.tmp_directory: '%kernel.project_dir%/var/tmp/prestashop'

Adjust the prestashop.prefix parameter according to your PrestaShop table prefix.

Configuration

Add PrestashopTrait to your entities

For each entity you want to migrate, add the PrestashopTrait to track the PrestaShop ID:

<?php

namespace App\Entity\Product;

use Doctrine\ORM\Mapping as ORM;
use Sylius\Component\Core\Model\Product as BaseProduct;
use ACSEO\PrestashopMigrationPlugin\Entity\PrestashopTrait;

#[ORM\Entity]
#[ORM\Table(name: 'sylius_product')]
class Product extends BaseProduct
{
    use PrestashopTrait;
}

Apply this trait to the following entities:

App\Entity\Product\Product
App\Entity\Product\ProductVariant
App\Entity\Product\ProductOption
App\Entity\Product\ProductOptionValue
App\Entity\Taxonomy\Taxon
App\Entity\Customer\Customer
App\Entity\Customer\CustomerGroup
App\Entity\Payment\PaymentMethod
App\Entity\Shipping\ShippingMethod
App\Entity\Customer\CustomerGroup
App\Entity\Addressing\Address
App\Entity\Addressing\Country
App\Entity\Addressing\Zone
App\Entity\Currency\Currency
App\Entity\Locale\Locale
App\Entity\Channel\Channel
App\Entity\Taxation\TaxCategory
App\Entity\Taxation\TaxRate
App\Entity\User\AdminUser
App\Entity\Order\Order
App\Entity\Order\OrderItem
App\Entity\Customer\CustomerGroup
App\Entity\Payment\PaymentMethod
App\Entity\Shipping\ShippingMethod

Implement ProductVariantInterface (for Product Variants only)

<?php

namespace App\Entity\Product;

use Doctrine\ORM\Mapping as ORM;
use Sylius\Component\Core\Model\ProductVariant as BaseProductVariant;
use ACSEO\PrestashopMigrationPlugin\Entity\PrestashopTrait;
use ACSEO\PrestashopMigrationPlugin\Entity\Product\ProductVariantInterface as PrestashopProductVariantInterface;

#[ORM\Entity]
#[ORM\Table(name: 'sylius_product_variant')]
class ProductVariant extends BaseProductVariant implements PrestashopProductVariantInterface
{
    use PrestashopTrait;

    public function hasProduct(): bool
    {
        return $this->product !== null;
    }
}

Generate and run migrations

# Generate the migration for the new fields
php bin/console doctrine:migrations:diff

# Review the generated migration, then execute it
php bin/console doctrine:migrations:migrate

Usage

Check Migration Status

Before running any migration, check the current status:

php bin/console prestashop:migration:check

This command displays:

Number of entities in PrestaShop
Number of entities in Sylius
Number of migrated entities (with prestashop_id)
Migration status for each entity type
Recommended commands to run

Example output:

PrestaShop to Sylius Migration Status Check
===========================================

+-----------------------+------------+--------------+----------+--------+-------------------------------------+
| Entity Type           | PrestaShop | Sylius Total | Migrated | Status | Command to Run                      |
+-----------------------+------------+--------------+----------+--------+-------------------------------------+
| Locales/Languages     | 2          | 8            | 0        | MISSING| php bin/console prestashop:migration:locale |
| Currencies            | 3          | 9            | 0        | MISSING| php bin/console prestashop:migration:currency |
| Countries             | 241        | 241          | 241      | OK     | -                                   |
| Customer Groups       | 3          | 3            | 3        | OK     | -                                   |
| Products              | 150        | 106          | 0        | MISSING| php bin/console prestashop:migration:product |
| Customers             | 50         | 50           | 50       | OK     | -                                   |
| Orders                | 125        | 125          | 125      | OK     | -                                   |
+-----------------------+------------+--------------+----------+--------+-------------------------------------+

Dry-Run Mode

Test any migration command without writing to the database:

php bin/console prestashop:migration:locale --dry-run
php bin/console prestashop:migration:currency --dry-run
php bin/console prestashop:migration:customer_group --dry-run
php bin/console prestashop:migration:product --dry-run
php bin/console prestashop:migration:order --dry-run

Dry-run mode will:

Execute all validation logic
Show what would be migrated
Display any validation errors
Report statistics
NOT write anything to the database

Run Individual Migrations

Migrate entities in the recommended order:

# 1. Base configuration
php bin/console prestashop:migration:locale
php bin/console prestashop:migration:currency
php bin/console prestashop:migration:country
php bin/console prestashop:migration:zone
php bin/console prestashop:migration:channel

# 2. Taxation
php bin/console prestashop:migration:tax_category
php bin/console prestashop:migration:tax_rate

# 3. Products
php bin/console prestashop:migration:taxon
php bin/console prestashop:migration:product_option
php bin/console prestashop:migration:product_option_value
php bin/console prestashop:migration:product
php bin/console prestashop:migration:product_variant

# 4. Customer groups (before customers)
php bin/console prestashop:migration:customer_group

# 5. Customers and users
php bin/console prestashop:migration:customer
php bin/console prestashop:migration:address
php bin/console prestashop:migration:admin_user

# 6. Shipping methods (before orders)
php bin/console prestashop:migration:shipping_method

# 7. Payment methods (before orders)
php bin/console prestashop:migration:payment_method

# 8. Orders
php bin/console prestashop:migration:order

# 9. Product images (optional, can take time)
php bin/console prestashop:migration:product:images

Run Complete Migration

To migrate everything in one command:

php bin/console prestashop:migration:all

This command runs all migrations in the correct order (by priority). It includes:

Locales, Currencies, Countries, Zones, Channel
Tax categories and tax rates
Taxons, product options, product option values, products, product variants
Customer groups (before customers)
Customers, addresses, admin users
Shipping methods (before orders)
Payment methods (before orders)
Orders
Product images (optional, see below)

Customer groups are migrated automatically before customers so that each customer can be assigned to the correct group.

Force Mode - DANGER: DATA LOSS

The prestashop:migration:all command supports a --force option that completely erases and recreates your Sylius database before migration.

WARNING: THIS WILL PERMANENTLY DELETE ALL DATA IN YOUR SYLIUS DATABASE

# DANGER: This will erase your entire Sylius database
php bin/console prestashop:migration:all --force

What the --force option does:

Drops the entire Sylius database (doctrine:database:drop --force)
Recreates an empty database (doctrine:database:create)
Recreates all database tables (doctrine:schema:update --force)
Runs all migrations from PrestaShop to the fresh database

When to use --force:

Fresh installation only: When setting up Sylius for the first time with PrestaShop data
Development/testing: On development or staging environments for clean tests
Complete restart: When you want to completely restart the migration process

When NOT to use --force:

Production environments: NEVER use this on a live production site
Existing Sylius data: If you have any Sylius data you want to keep
Partial migrations: If you want to update or add data without losing existing content
Customer orders: If you have any order history or customer data in Sylius

Safety measures:

The command will ask for confirmation before proceeding:

The database will be erase before the migration. Are you sure you want continue ? (N/y)

You must explicitly type "y" to proceed. The default answer is "No" to prevent accidental data loss.

Recommended alternative:

Instead of using --force, use the standard migration process which:

Preserves existing Sylius data
Handles duplicates intelligently
Updates entities instead of replacing them
Allows incremental migrations

# Recommended: Safe migration that preserves existing data
php bin/console prestashop:migration:all

IMPORTANT: Always backup your database before running any migration, especially with the --force option.

Duplicate Detection

The plugin automatically handles duplicate entities to prevent unique constraint violations.

How it works

When migrating entities like Locales, Currencies, or Countries, the plugin:

Checks if an entity with the same prestashop_id already exists
If not found, checks if an entity with the same unique identifier (code, ISO code, etc.) exists
If an existing entity is found, it reuses it instead of creating a duplicate
The prestashop_id is set on the existing entity to track the migration

Example: Country Migration

Scenario: Your Sylius installation already has 241 countries, and PrestaShop also has 241 countries.

Without duplicate detection:

Migration would fail with "Duplicate entry" errors
You would need to manually delete or map entities

With duplicate detection:

The plugin finds existing countries by ISO code
Reuses existing Sylius countries
Sets the prestashop_id on matched countries
Creates only truly new countries
Result: No duplicates, clean migration

Supported duplicate detection

The following entities have smart duplicate detection:

Locale: Matches by locale code (with automatic transformation, e.g., fr_FR → fr-fr)
Currency: Matches by currency code (e.g., EUR, USD)
Country: Matches by ISO country code (e.g., FR, US)
Customer Group: Matches by generated code (slug from name + id) to avoid duplicates on re-run
Shipping Method: Matches by generated code (slug + carrier id + zone suffix) to avoid duplicates on re-run
Payment Method: Matches by prestashop_id (module id) or generated code (slug from module name)

Shipping Methods

Shipping methods are migrated from PrestaShop ps_carrier and ps_carrier_lang to Sylius sylius_shipping_method.

Mapping

PrestaShop (ps_carrier)	Sylius (shipping_method)
id_carrier	prestashopId (trait)
name (carrier_lang)	code (slugified, unique)
name (carrier_lang)	name (translation)
delay (carrier_lang)	description (translation)
active && !deleted	enabled
is_free	configuration amount (0 or default)
shipping_method (0/1/2)	calculator: flat_rate

Behaviour

Calculator: All carriers are migrated with the flat_rate calculator. Tariff grids (weight/price) from PrestaShop are not migrated; a default amount (or 0 if free) is set per channel.
Zone: The first zone from ps_carrier_zone is assigned. Sylius uses one zone per shipping method.
Channels: Channels are taken from ps_carrier_shop; if none, the method is attached to all channels.
Category: An existing shipping category (code standard or default, or the first one) is assigned. Ensure at least one shipping category exists in Sylius before migrating.

Limitations

Tariff grids: PrestaShop range_price and range_weight are not migrated. Reconfigure rates in Sylius after migration if needed.
Multiple zones: One Sylius method = one zone; the first carrier zone is used. For multiple zones, consider creating additional methods manually.

Customer Groups

Customer groups are migrated from PrestaShop ps_group and ps_group_lang to Sylius sylius_customer_group.

Mapping

PrestaShop (ps_group)	Sylius (customer_group)
id_group	prestashopId (trait)
name (ps_group_lang)	code (slugified, unique)
name (ps_group_lang)	name

Behaviour

One group per customer: In PrestaShop a customer can belong to several groups; in Sylius a customer has a single group. The migration uses the default group (id_default_group) when assigning a group to each customer.
Translations: Group names from ps_group_lang are used; the first available locale is used for the Sylius name and to generate the code.

Limitations

Group reductions: PrestaShop group discounts (reduction, price_display_method, show_prices) are not migrated. Sylius handles this via Promotions. Groups that had a reduction in PrestaShop are logged during migration so you can recreate equivalent promotions in Sylius if needed.

Payment Methods

Payment methods are migrated from PrestaShop payment modules to Sylius sylius_payment_method.

Source

Unlike other entities, PrestaShop doesn't have a dedicated table for payment methods. Payment methods are modules that hook into the paymentOptions hook. The migration uses:

SELECT m.id_module, m.name, m.active, GROUP_CONCAT(c.iso_code) as currencies
FROM ps_hook_module h
JOIN ps_module m ON m.id_module = h.id_module
LEFT JOIN ps_module_currency mc ON mc.id_module = m.id_module
LEFT JOIN ps_currency c ON c.id_currency = mc.id_currency
WHERE h.id_hook IN (SELECT id_hook FROM ps_hook WHERE name = 'paymentOptions')
  AND m.active = 1
GROUP BY m.id_module

This approach ensures we migrate only the configured and active payment modules, not just the payment methods that have been used in orders.

Mapping

PrestaShop Module	Sylius PaymentMethod	Display Name
ps_wirepayment	prestashopId: id_module code: ps-wirepayment	Bank Wire Payment
ps_checkpayment	code: ps-checkpayment	Payment by Check
ps_cashondelivery	code: ps-cashondelivery	Cash on Delivery
paypal	code: paypal gateway: paypal	PayPal
stripe / stripe_official	code: stripe gateway: stripe	Stripe
other modules	code: slugified name gateway: offline	Auto-generated name

Gateway Configuration

Each payment method is automatically configured with a GatewayConfig:

Offline modules (default): factory_name = 'offline'
PayPal modules: Automatically detected and set to factory_name = 'paypal'
Stripe modules: Automatically detected and set to factory_name = 'stripe'

Behaviour

Active status: Respects the PrestaShop module's active status
Translations: Display names are created for all Sylius locales
Channels: Methods are associated with all Sylius channels
Currencies: Supported currencies information is logged but not directly applied (configure manually if needed)

Limitations

Gateway configuration: Only basic gateway configuration is created. For real payment gateways (Stripe, PayPal configured, etc.), you need to manually configure the gateway credentials and settings in Sylius after migration.
Complex module settings: PrestaShop-specific module configurations are not migrated.

Post-Migration Steps

After migrating payment methods:

Go to Sylius Admin → Configuration → Payment Methods
For each real gateway (PayPal, Stripe, etc.):
- Edit the payment method
- Configure the gateway settings (API keys, credentials, etc.)
- Test the payment flow
Disable or delete any unwanted offline methods

Order State Mapping

When migrating orders from PrestaShop to Sylius, order states are automatically converted to match Sylius's multi-dimensional state system.

Sylius Order States

Unlike PrestaShop which uses a single order state, Sylius tracks orders using four independent state dimensions:

Order State (state): The overall order lifecycle (cart, new, cancelled, fulfilled)
Checkout State (checkout_state): The checkout process state (cart, addressed, shipping_selected, payment_selected, completed)
Payment State (payment_state): Payment status (cart, awaiting_payment, authorized, partially_paid, paid, partially_refunded, refunded, cancelled)
Shipping State (shipping_state): Shipping status (cart, ready, partially_shipped, shipped, cancelled)

Default State Mapping

The plugin includes a comprehensive default mapping from PrestaShop order states to Sylius states:

PrestaShop State ID	PrestaShop State Name	Order State	Checkout State	Payment State	Shipping State
1	Awaiting check payment	new	completed	awaiting_payment	ready
2	Payment accepted	new	completed	paid	ready
3	Processing in progress	new	completed	paid	ready
4	Shipped	fulfilled	completed	paid	shipped
5	Delivered	fulfilled	completed	paid	shipped
6	Canceled	cancelled	completed	cancelled	cancelled
7	Refunded	cancelled	completed	refunded	cancelled
8	Payment error	cancelled	completed	cancelled	cancelled
9	On backorder (paid)	new	completed	paid	ready
10	Awaiting bank wire payment	new	completed	awaiting_payment	ready
11	Remote payment accepted	new	completed	paid	ready
12	On backorder (not paid)	new	completed	awaiting_payment	ready
13	Awaiting Cash On Delivery validation	new	completed	awaiting_payment	ready
14	Waiting for payment	new	completed	awaiting_payment	ready
15	Partial refund	new	completed	partially_refunded	ready
16	Partial payment	new	completed	partially_paid	ready
17	Authorized. To be captured by merchant	new	completed	authorized	ready

Customizing State Mapping

You can customize the state mapping in your config/packages/prestashop_migration.yaml:

prestashop_migration:
    # ... other configuration

    order_state_mapping:
        # Override specific PrestaShop states
        4:  # Shipped
            order_state: fulfilled
            checkout_state: completed
            payment_state: paid
            shipping_state: shipped

        # Add custom state mappings
        18:  # Custom PrestaShop state
            order_state: new
            checkout_state: completed
            payment_state: awaiting_payment
            shipping_state: ready

Important Notes:

The mapping uses PrestaShop's current_state (order state ID) as the key
All four state dimensions must be specified for each mapping
Only override states you need to customize; others will use default values
After migration, orders can be managed through Sylius's normal state machine workflows

Advanced Customization

Creating Custom Providers

You can create custom providers to handle entity resolution:

<?php

namespace App\Provider;

use ACSEO\PrestashopMigrationPlugin\Model\ModelInterface;
use ACSEO\PrestashopMigrationPlugin\Provider\ResourceProviderInterface;
use Sylius\Component\Resource\Model\ResourceInterface;
use Sylius\Component\Resource\Repository\RepositoryInterface;

final class CustomResourceProvider implements ResourceProviderInterface
{
    private ResourceProviderInterface $decorated;
    private RepositoryInterface $repository;

    public function __construct(
        ResourceProviderInterface $decorated,
        RepositoryInterface $repository
    ) {
        $this->decorated = $decorated;
        $this->repository = $repository;
    }

    public function getResource(ModelInterface $model): ResourceInterface
    {
        // Try default behavior first
        $resource = $this->decorated->getResource($model);

        // Add custom logic here
        if ($resource->getId() === null) {
            // Try to find existing entity by custom criteria
            $existing = $this->repository->findOneBy(['customField' => $model->customValue]);

            if ($existing !== null) {
                return $existing;
            }
        }

        return $resource;
    }
}

services:
    App\Provider\CustomResourceProvider:
        decorates: 'prestashop.provider.your_entity'
        arguments:
            - '@.inner'
            - '@sylius.repository.your_entity'

Creating Custom Transformers

Transform PrestaShop data to Sylius format:

<?php

namespace App\DataTransformer;

use ACSEO\PrestashopMigrationPlugin\DataTransformer\Resource\ResourceTransformerInterface;
use ACSEO\PrestashopMigrationPlugin\Model\ModelInterface;
use Sylius\Component\Resource\Model\ResourceInterface;

final class CustomResourceTransformer implements ResourceTransformerInterface
{
    private ResourceTransformerInterface $decorated;

    public function __construct(ResourceTransformerInterface $decorated)
    {
        $this->decorated = $decorated;
    }

    public function transform(ModelInterface $model, ResourceInterface $resource): void
    {
        // Call the original transformer
        $this->decorated->transform($model, $resource);

        // Add your custom transformations
        // Example: Set additional fields, modify data, etc.
    }
}

Creating Custom Validators

Add custom validation logic:

<?php

namespace App\Validator;

use ACSEO\PrestashopMigrationPlugin\Validator\ValidatorInterface;
use Sylius\Component\Resource\Model\ResourceInterface;

final class CustomValidator implements ValidatorInterface
{
    private ValidatorInterface $decorated;

    public function __construct(ValidatorInterface $decorated)
    {
        $this->decorated = $decorated;
    }

    public function validate(ResourceInterface $resource): bool
    {
        // Skip validation for existing entities
        if ($resource->getId() !== null) {
            return true;
        }

        // Call the original validator
        return $this->decorated->validate($resource);
    }
}

Troubleshooting

Unique Constraint Violations

If you encounter unique constraint errors:

Check if you have existing data in Sylius
The plugin should handle duplicates automatically for Locales, Currencies, and Countries
For other entities, you may need to create custom providers

Memory Issues

For large datasets:

The migration processes data in batches (default: 100 items)
Increase PHP memory limit if needed: php -d memory_limit=2G bin/console prestashop:migration:all
Run migrations individually instead of using migration:all

Migration Fails Midway

Check the error message for specific issues
Fix the data or code issue
Re-run the migration command - it will skip already migrated entities (those with prestashop_id)

Images Not Migrating

Ensure prestashop.public_directory points to your PrestaShop installation
Check file permissions on both PrestaShop and Sylius directories
Verify that the PrestaShop images directory is accessible

Testing

The plugin includes a comprehensive test suite using PHPUnit.

Running Tests

# Install dependencies
composer install

# Run all tests
vendor/bin/phpunit

# Run tests with coverage
vendor/bin/phpunit --coverage-html coverage

# Run specific test file
vendor/bin/phpunit tests/Provider/Locale/LocaleResourceProviderTest.php

Test Coverage

The test suite covers:

Resource Providers (Locale, Currency, Country)
Validators (Locale, Currency, Country)
Entity Traits (PrestashopTrait)
Data Collectors (EntityCollector)
Persisters (TaxonPersister)
Model Services (LocaleFetcher)

For more details, see tests/README.md.

Requirements

PHP 8.0 or higher
Sylius 2.x
Symfony 7.x
PrestaShop 1.7+ or 8.x (as source)
MySQL/MariaDB

License

MIT License

Credits

Original package by Quentin Briais (Jgrasp)
Maintained and updated by ACSEO for Sylius 2.x compatibility

acseo / sylius2-prestashop-migration-plugin

Maintainers

Package info

Statistics

Security

README

Features

Installation

1. Add the plugin to your Sylius project

2. Enable the plugin

3. Configure the PrestaShop database connection

4. Configure the plugin

Configuration

Add PrestashopTrait to your entities

Implement ProductVariantInterface (for Product Variants only)

Generate and run migrations

Usage

Check Migration Status

Dry-Run Mode

Run Individual Migrations

Run Complete Migration

Force Mode - DANGER: DATA LOSS

What the --force option does:

When to use --force:

When NOT to use --force:

Safety measures:

Recommended alternative:

Duplicate Detection

How it works

Example: Country Migration

Supported duplicate detection

Shipping Methods

Mapping

Behaviour

Limitations

Customer Groups

Mapping

Behaviour

Limitations

Payment Methods

Source

Mapping

Gateway Configuration

Behaviour

Limitations

Post-Migration Steps

Order State Mapping

Sylius Order States

Default State Mapping

Customizing State Mapping

Advanced Customization

Creating Custom Providers

Creating Custom Transformers

Creating Custom Validators

Troubleshooting

Unique Constraint Violations

Memory Issues

Migration Fails Midway

Images Not Migrating

Testing

Running Tests

Test Coverage

Requirements

License

Credits