Mettre à jour PrestaShop sans casser sa boutique : la méthode pas à pas

Une mise à jour PrestaShop qui tourne mal ne prévient pas : le back-office s'ouvre, l'accueil s'affiche, et c'est la page de paiement qui renvoie une erreur, ou un module de livraison qui ne calcule plus rien. La méthode qui suit est celle que j'applique à chaque montée de version, de la 1.6 à la 9. Elle tient en une idée : on ne met jamais à jour une boutique qui vend, on met à jour une copie, et on ne bascule qu'une fois la copie vérifiée.

D'abord, savoir ce que l'on met à jour

« Mettre à jour PrestaShop » recouvre quatre opérations qui n'ont ni le même risque ni le même coût :

• Un correctif dans la même branche, par exemple de 8.1.5 à 8.1.7. Il corrige des failles et des bugs sans changer le fonctionnement. Le risque est faible, et il faut le faire vite quand il touche à la sécurité.
• Une version majeure, par exemple de 1.7 à 8, ou de 8 à 9. Le cœur du logiciel change, des fonctions disparaissent, et une partie des modules et du thème doit suivre.
• Les modules et le thème, qui ont leurs propres versions et leurs propres incompatibilités.
• La version de PHP du serveur, que l'hébergeur fait évoluer et qui peut, à elle seule, casser une boutique restée trop longtemps sans mise à jour.

Le bon ordre dépend de votre point de départ. Une boutique en 1.7.8 qui tourne en PHP 7.4 ne se traite pas comme une boutique en 8.1 qui doit simplement recevoir un correctif.

Vérifier la version de PHP avant tout

Chaque version de PrestaShop accepte une plage de versions de PHP, et c'est souvent elle qui impose le calendrier :

• PrestaShop 1.6 ne fonctionne pas au-delà de PHP 7.1.
• PrestaShop 1.7.8 demande PHP 7.1 à 7.4.
• PrestaShop 8 demande PHP 7.2 à 8.1.
• PrestaShop 9 demande au minimum PHP 8.1, 512 Mo de mémoire par script, et MySQL 5.7 ou MariaDB 10.2.

Si votre hébergeur annonce la fin de PHP 7.4, une boutique en 1.7 n'a plus le choix : il faut passer en 8 avant la date. La version de PHP se lit dans le back-office, dans Paramètres avancés > Informations.

Sauvegarder, et vérifier que la sauvegarde se restaure

Une sauvegarde complète, ce sont deux choses : les fichiers du site, et la base de données. L'outil de mise à jour de PrestaShop propose d'en faire une, mais je ne m'en contente jamais : je fais ma propre copie des fichiers et un export de la base, que je range hors du serveur.

Une sauvegarde qui n'a jamais été restaurée n'est qu'un espoir. Le test le plus simple consiste justement à s'en servir pour monter la copie de travail décrite plus bas : si la copie fonctionne, la sauvegarde est bonne.

Travailler sur une copie, jamais sur la boutique en ligne

La copie de test (on parle de préproduction) est une seconde boutique, identique à la vraie, installée sur un sous-domaine protégé par mot de passe et invisible pour Google. C'est sur elle que se fait toute la mise à jour. Deux précautions avant de commencer :

• Couper les e-mails clients de la copie, sinon vos clients reçoivent des messages envoyés par la boutique de test.
• Passer les paiements en mode test, pour que les commandes d'essai ne débitent personne.

Pendant ce temps, la vraie boutique continue de vendre. Rien ne presse, et c'est exactement ce qu'on cherche.

Faire l'inventaire des modules et du thème

La plupart des mises à jour ratées viennent d'un module, pas du cœur de PrestaShop. Avant de lancer quoi que ce soit, je liste les modules installés et, pour chacun, je vérifie qu'une version compatible avec la version cible existe chez son éditeur. Trois cas reviennent sans cesse :

• Le module n'est plus maintenu. Il faut le remplacer, ou le désactiver si personne ne s'en sert vraiment.
• Le module a été modifié à la main par un ancien prestataire. Sa mise à jour efface ces modifications : il faut les retrouver avant.
• Le thème contient des surcharges, des fichiers qui remplacent le comportement d'origine de PrestaShop. Elles cessent souvent de fonctionner après une version majeure.

Lancer l'outil officiel de mise à jour

PrestaShop fournit un module dédié, l'Assistant de mise à jour (anciennement « 1-Click Upgrade », ou « autoupgrade »). Il vérifie les prérequis, sauvegarde, remplace les fichiers et met à jour la base. Sur la copie de test :

1. installez ou mettez à jour l'Assistant de mise à jour dans sa dernière version ;
2. lisez sa liste de vérifications et corrigez tout ce qui est signalé en rouge avant de continuer ;
3. choisissez la version cible ;
4. lancez la mise à jour et laissez-la aller jusqu'au bout sans fermer la page ;
5. videz le cache, puis contrôlez le journal d'erreurs.

Sur une grosse boutique, l'outil peut aussi se lancer en ligne de commande sur le serveur, ce qui évite qu'une page du navigateur s'interrompe en plein milieu.

Pour les grands sauts, procéder par étapes

Passer d'une 1.6 à une 9 d'un seul coup est le meilleur moyen de ne plus savoir d'où vient une erreur. Je procède par étapes, en contrôlant la boutique à chaque palier : 1.7, puis 8, puis 9.

Pour une boutique encore en 1.6, une montée de version sur place est rarement le bon choix. Le thème et les modules de cette génération ne passent pas en 8 ou en 9. On reconstruit alors une boutique neuve dans la version actuelle, puis on y importe le catalogue, les clients et les commandes, en conservant les adresses des pages pour ne pas perdre la place acquise sur Google. Je détaille cette démarche dans le guide sur la migration vers PrestaShop 8.

Tout tester avant de basculer

Une fois la copie à jour, je la parcours comme un client, puis comme le marchand. La liste ne change pas d'une boutique à l'autre :

• passer une commande complète, avec chaque moyen de paiement en mode test ;
• vérifier les frais de port de chaque transporteur, en France et à l'étranger ;
• contrôler la réception des e-mails de commande, côté client et côté boutique ;
• faire une recherche, filtrer une catégorie, ajouter au panier depuis une fiche produit ;
• dans le back-office, ouvrir une commande, changer son statut, imprimer la facture ;
• relire le journal d'erreurs du serveur après tous ces tests.

Si tout est propre, la bascule se fait à un moment calme : sauvegarde de la boutique en ligne, application de la même mise à jour, ou remplacement par la copie validée, puis les mêmes tests, en vrai cette fois.

Si quelque chose casse

La règle est simple : on ne répare pas à chaud sur une boutique qui vend. Si une erreur apparaît après la bascule, on restaure la sauvegarde, la boutique repart dans son état d'avant, et on cherche la cause tranquillement sur la copie. C'est précisément pour pouvoir le faire en quelques minutes qu'on a vérifié la sauvegarde au début. Si vous êtes déjà dans cette situation, voici comment j'interviens sur une boutique PrestaShop en panne.

À quel rythme mettre à jour ?

Les correctifs de sécurité s'appliquent dès leur publication, après un passage rapide sur la copie de test. Les versions majeures se planifient, une fois que les modules dont vous dépendez sont prêts. Entre les deux, le plus coûteux est de ne rien faire pendant des années : on finit par cumuler trois versions de retard et une version de PHP que l'hébergeur ne fournit plus, et la mise à jour devient une reconstruction.

Si vous préférez déléguer ce travail, je prends en charge les mises à jour PrestaShop de bout en bout, sur une copie de votre boutique, avec la même méthode. Pour un suivi dans la durée, la maintenance mensuelle inclut les correctifs de sécurité.