Migrer de PrestaShop 1.7 à 9 étape par étape : le plan qui évite les surprises

Une migration de PrestaShop 1.7 à 9 réussit quand le jour de la bascule est ennuyeux. Pour cela, tout ce qui est difficile doit avoir été réglé avant, sur une copie, avec le temps de se tromper. Voici le plan que nous suivons, avec les pièges que nous rencontrons habituellement à chaque phase.

1. Inventaire : ce que fait votre boutique

Avant de toucher à quoi que ce soit, faites deux listes :

• Les modules installés, avec leur version, leur auteur et leur état (actif ou non). Extrayez la liste de la base de données pour qu'aucun ne vous échappe.
• Les fonctions de la boutique : comment on encaisse, comment on expédie, comment on facture, à quoi elle est connectée (ERP, marketplaces, transporteurs), ce qu'il y a pour le SEO, quelles automatisations d'e-mails.

Pour chaque fonction, décidez ce qui s'en chargera dans PrestaShop 9 : le même module mis à jour, un remplaçant, quelque chose déjà intégré au cœur ou rien, parce qu'elle ne sert plus. Il est fréquent qu'une boutique qui a des années derrière elle découvre qu'une partie de ses modules est inutile.

Examinez aussi le dossier override/. Chaque override est du code qui modifie le cœur, et dans PrestaShop 9 beaucoup de classes ont changé. Tout ce qui dépend d'un override doit être refait, de préférence avec des hooks.

2. La copie en local

Rapatriez une copie complète de la boutique actuelle (fichiers et base de données) dans un environnement de test qui ne soit pas sur le même serveur que la boutique réelle et qui ne puisse pas envoyer d'e-mails aux clients. Ce dernier point est important : une copie avec la vraie base de données et l'e-mail configuré peut écrire à un vrai client sur un simple changement d'état de commande.

Anonymisez les données personnelles si d'autres personnes vont manipuler la copie, et désactivez ou passez en mode test les passerelles de paiement, les connexions à l'ERP et tout cron qui communique avec l'extérieur.

3. Choisir le chemin : mettre à jour ou migrer les données

Il y a deux façons d'arriver à PrestaShop 9 :

• Mettre à jour l'installation existante avec l'assistant officiel. Tout est conservé, mais on traîne aussi les restes de plusieurs années : tables de modules désinstallés, ancienne configuration, overrides.
• Une installation propre de PrestaShop 9 et la migration des données : catalogue, clients, commandes, adresses, CMS. Plus de travail au départ, mais la nouvelle boutique ne contient que ce que l'on a décidé d'y mettre.

Avec une 1.7 qui a beaucoup de modules tiers, des overrides et un thème très modifié, la seconde pose généralement moins de problèmes à moyen terme. Avec une 1.7.8 soignée et peu de modules, la mise à jour peut suffire. Décidez sur la copie, pas sur la théorie.

4. Les données

Lors de la migration des données, vérifiez chaque type par des chiffres, pas à l'œil :

• Produits, déclinaisons, prix spécifiques, stock et images : le même nombre à l'origine et à la destination.
• Clients, adresses et groupes, avec leurs réductions.
• Commandes, avec leurs états, factures et avoirs. La numérotation des factures doit continuer, pas repartir de zéro.
• Règles panier et bons de réduction en cours.
• Pages CMS, catégories avec leurs descriptions et métadonnées SEO.
• Traductions de toutes les langues.

Conservez les identifiants des produits et des catégories chaque fois que possible : ils facilitent les redirections, les intégrations et les rapports.

5. Le thème

Un thème 1.7 fonctionne rarement tel quel dans PrestaShop 9. Les options habituelles sont de l'adapter, de créer un thème enfant du thème par défaut de PrestaShop 9 avec votre design ou de choisir un thème commercial compatible. Gardez à l'esprit que le thème n'est pas seulement du design : il contient aussi des modèles d'e-mails, des textes traduits et parfois ses propres modules. Vérifiez la boutique sur mobile et sur ordinateur, page par page.

6. URL et redirections 301

Si les URL changent, Google doit le savoir. L'idéal est de conserver la même structure d'URL ; si ce n'est pas possible, chaque ancienne URL qui a du trafic ou des liens doit rediriger en 301 vers son équivalent nouveau, pas vers la page d'accueil. Extrayez la liste des anciennes URL du sitemap, de la Search Console et des journaux du serveur, et vérifiez les redirections par un crawl avant le jour de la bascule.

7. Les paiements en mode test

Chaque moyen de paiement se teste de bout en bout en mode sandbox : paiement réussi, paiement refusé, paiement annulé, remboursement et, si vous l'utilisez, paiement avec authentification forte. Vérifiez que la commande est créée avec le bon état et que la notification de la passerelle arrive. Dans PrestaShop 9, les modules qui recevaient ces notifications sur un .php appelé directement dans modules/ peuvent se heurter à un 403, car le .htaccess par défaut refuse ces requêtes. C'est l'une des causes les plus fréquentes de « le client a payé et il n'y a pas de commande » après une migration.

8. La répétition générale

Une fois tout prêt, refaites la migration complète à partir d'une nouvelle copie de la boutique réelle, en chronométrant chaque étape. La répétition sert à trois choses : confirmer que le processus est reproductible, savoir combien de temps la boutique restera en maintenance et découvrir ce qui a changé dans la boutique réelle depuis la première copie.

9. Le jour de la bascule

1. Prévenez à l'avance s'il doit y avoir une fenêtre de maintenance.
2. Mettez l'ancienne boutique en maintenance et arrêtez ses crons et ses intégrations.
3. Migrez les commandes, les clients et les modifications du catalogue depuis la dernière copie.
4. Activez dans la nouvelle boutique les passerelles en mode réel, les connexions à l'ERP et les crons.
5. Pointez le domaine vers la nouvelle boutique et vérifiez le certificat.
6. Passez une vraie commande avec chaque moyen de paiement et remboursez-la.
7. Envoyez le nouveau sitemap à la Search Console et surveillez les erreurs 404 les jours suivants.
8. Conservez l'ancienne boutique arrêtée et sans accès public pendant un certain temps, au cas où il faudrait consulter quelque chose.

Ce qui casse le plus souvent

• Des overrides qui ne correspondent plus aux classes du cœur.
• Des modules qui ne s'installent pas ou n'affichent pas leur configuration dans PrestaShop 9.
• Des crons qui pointaient vers des fichiers .php de modules et reçoivent désormais un 403 sans que personne ne s'en aperçoive.
• Des modèles d'e-mails qui reviennent à ceux par défaut ou perdent leurs traductions.
• Une numérotation des factures qui repart de zéro.
• Des images qu'il faut régénérer avec les nouveaux formats et tailles.
• L'analytics et les pixels restés sur l'ancienne boutique.

Et un avantage que l'on oublie : à la fin, votre boutique est sur une version supportée, avec un PHP actuel et des modules à jour. À partir de là, la maintenir à jour demande beaucoup moins de travail que de sauter à nouveau plusieurs versions d'un coup.

Comment le résoudre dans PrestaShop

Les migrations de 1.6 et 1.7 vers PrestaShop 9 représentent une part importante de notre travail chez Rekire. Avec nos forfaits d'heures de support (20, 50 ou 100 heures, selon la taille de la boutique), nous prenons en charge le projet entier ou la partie dont vous avez besoin : inventaire des modules et des fonctions, copie dans un environnement de test sans e-mail sortant, migration des données vérifiée par les chiffres, adaptation du thème, redirections, tests des paiements, répétition et accompagnement le jour de la bascule. Les heures sont décomptées selon le travail réel.