Votre boutique tourne sous PrestaShop 9.0 ou 9.1 et vous voulez passer à la 9.2 ? Depuis PrestaShop 9, la mise à jour passe par un seul outil officiel : le module Update Assistant (anciennement « 1-Click Upgrade », nom technique autoupgrade). Voici la marche à suivre, étape par étape, et les vérifications qui évitent les mauvaises surprises.
Vous êtes encore en PrestaShop 1.6 ou 1.7 ? Ce guide ne suffira pas : il s’agit d’une migration, pas d’une simple mise à jour. Lisez plutôt notre article Migration PrestaShop 1.6 ou 1.7 vers PS 8 et PS 9.
Avant de commencer : sauvegarde et vérifications
- Faites votre propre sauvegarde complète (fichiers et base de données), en plus de celle proposée par le module. La documentation officielle recommande une sauvegarde manuelle pour garder la main sur la restauration.
- Vérifiez votre version de PHP. PrestaShop 9.2 demande PHP 8.1 au minimum et fonctionne jusqu’à PHP 8.5. Si la nouvelle version n’apparaît pas dans le module, c’est souvent que votre PHP est hors de cette plage.
- Testez d’abord sur une copie de la boutique si vous en avez la possibilité, surtout si vous utilisez beaucoup de modules ou un thème sur mesure.
- Choisissez un moment calme : la boutique passe en maintenance pendant l’opération.
- Si vous avez modifié les e-mails de commande, notez-le : une option du module les régénère (voir plus bas).
Étape 1 : installer Update Assistant
Le module se télécharge sur PrestaShop Addons, depuis la Marketplace du back-office ou sur la page GitHub du projet. Installez-le depuis le Gestionnaire de modules, puis cliquez sur Configurer. Pour passer en 9.2 depuis 9.0 ou 9.1, utilisez au moins la version 7.6.6 du module, qui prend entièrement en charge cette mise à jour.
L’écran d’accueil propose deux choix : mettre à jour la boutique ou restaurer une sauvegarde (ce second choix n’est actif que si une sauvegarde existe).
Étape 2 : choisir la version cible
Le module affiche jusqu’à trois options :
- Recommandée : la version la plus stable compatible avec votre PHP. C’est le bon choix dans la plupart des cas.
- Dernière : la version la plus récente compatible avec votre PHP.
- Locale : une archive que vous avez déposée vous-même dans le dossier
autoupgrade/downloadde votre dossier d’administration. Le fichier .zip et son fichier .xml doivent correspondre exactement à la même version.
Les prérequis techniques sont vérifiés à ce moment-là. Une croix rouge bloque la suite : il faut corriger le problème. Un avertissement orange laisse continuer, mais signale un risque à prendre au sérieux.
Étape 3 : régler les options de mise à jour
- Désactiver les modules non natifs (activé par défaut) : recommandé, car ce sont souvent eux qui posent problème. Vous les réactiverez ensuite un par un.
- Régénérer les modèles d’e-mails (activé par défaut) : attention, vos e-mails personnalisés peuvent être perdus. Désactivez cette option si vous les avez modifiés.
- Désactiver toutes les surcharges (désactivé par défaut) : utile si votre boutique contient des overrides, pour éviter les conflits.
Étape 4 : la sauvegarde
Trois choix : sauvegarde complète (fichiers, base de données et images, par défaut), sauvegarde partielle (sans les images) ou aucune sauvegarde. Gardez la sauvegarde complète : c’est elle qui permettra un retour arrière en quelques clics. Elle est enregistrée dans le dossier autoupgrade/backup de votre dossier d’administration.
Si la sauvegarde échoue, les journaux indiquent pourquoi. Corrigez et relancez plutôt que de continuer sans filet.
Étape 5 : lancer la mise à jour
Cliquez sur Démarrer la mise à jour et confirmez. Une barre de progression et les journaux défilent : ne fermez pas la fenêtre. Une fois terminé, le module affiche une liste de vérifications et vous permet de télécharger les journaux. Gardez-les : ils serviront en cas de problème.
Les administrateurs à l’aise avec la ligne de commande peuvent aussi lancer la mise à jour en mode CLI, depuis le dossier modules/autoupgrade de la boutique : pratique sur les grosses boutiques où le navigateur risque d’expirer.
Après la mise à jour : la check-list
- Reconnectez-vous au back-office (la session est fermée).
- Ouvrez le Gestionnaire de modules : les modules compatibles ont été mis à jour, les incompatibles désinstallés. Réactivez un par un ceux qui avaient été désactivés, en testant la boutique entre chaque.
- Testez le front-office : création de compte, ajout au panier, commande complète avec chaque moyen de paiement et chaque transporteur.
- Désactivez le mode maintenance dans Paramètres généraux > Maintenance.
- Si des images manquent, régénérez les miniatures dans Préférences > Images.
Profitez-en pour découvrir ce qui a changé : paiement en une page, assistant IA, champs personnalisés… Nous avons détaillé les 10 nouveautés phares de PrestaShop 9.2.
Que faire en cas d’erreur ?
- La mise à jour échoue en cours de route : consultez les journaux, puis utilisez Restaurer une sauvegarde depuis l’écran d’accueil du module. Sans sauvegarde du module, restaurez la vôtre.
- Le message « version mismatch » (la version enregistrée en base ne correspond pas au code) : la structure de la base n’est pas à jour. Ne forcez pas, faites-vous accompagner.
- Le back-office ne s’affiche plus : activez le mode débogage (constante
_PS_MODE_DEV_àtruedansconfig/defines.inc.php) pour voir l’erreur exacte. - Certaines pages du back-office sont refusées : les droits d’accès du profil employé sont à vérifier en base de données.
Questions fréquentes
Pourquoi la nouvelle version n’apparaît-elle pas dans Update Assistant ?
Soit la version n’est pas encore proposée à la mise à jour par PrestaShop, soit votre version de PHP est trop ancienne ou trop récente pour elle. Vérifiez les prérequis de la version visée.
Peut-on mettre à jour PrestaShop sans le module ?
La documentation officielle indique qu’une mise à jour manuelle sans le module n’est pas possible à ce jour. Pour automatiser, utilisez le mode ligne de commande du même module.
Mon thème et mes modules sont-ils conservés ?
Oui, les données, les modules et le thème de la boutique sont conservés. En revanche, les modules incompatibles avec la nouvelle version sont désinstallés : vérifiez la liste après la mise à jour.
Sources : documentation officielle PrestaShop 9 — Update from the back office, Post-update checklist, Update FAQ ; annonce PrestaShop 9.2 is available.
