Pour passer une boutique PrestaShop 8 à la version 9, utilisez l’Update Assistant, le module dont le nom technique est « Autoupgrade ». Il s’installe depuis le Module Manager ou le Marketplace, se configure puis se lance depuis le back-office, en cinq étapes. Commencez toujours par une copie de la boutique : une mise à jour réelle ne se teste pas en production.
Avant de commencer
1. Faites une sauvegarde complète. L’assistant propose trois options : « Complete backup » (fichiers, base de données et images, option par défaut), « Partial backup » (sans les images) ou « No backup ». Ses sauvegardes sont stockées dans le dossier autoupgrade/backup de votre dossier d’administration. Si le module ne sauvegarde pas, la documentation indique qu’une sauvegarde faite par un autre moyen est alors impérative. Copiez aussi la base de données hors du serveur.
2. Testez sur une copie. Installez la boutique sur un environnement de test, avec les mêmes modules et le même thème, puis lancez la mise à jour. Les erreurs que vous y trouverez sont celles que vous rencontreriez en production.
3. Vérifiez PHP et le serveur. Les versions proposées dépendent de la version de PHP de votre serveur : le canal « recommended » propose celle qui lui est compatible. Pour le réglage du serveur, voyez notre article sur la configuration serveur de PrestaShop en 2026.
4. Préparez le retour arrière. Décidez à l’avance de la marche à suivre si la boutique ne fonctionne plus : restauration de la sauvegarde, à qui vous adresser, et combien de temps vous acceptez d’être hors ligne.
Vérifier les modules et les contrôles
L’assistant affiche deux niveaux d’alerte. Les erreurs bloquantes (croix rouge) empêchent de passer à l’étape suivante. Les avertissements (orange) ne bloquent pas, mais peuvent affecter la stabilité.
L’option « Deactivate non-native modules » est activée par défaut : les modules qui ne sont pas natifs sont désactivés pendant la mise à jour. Les modules compatibles sont mis à jour automatiquement, et ceux qui ne le sont pas sont désinstallés, selon la documentation.
Faites donc la liste de vos modules non natifs avant de commencer, avec leur version et leur éditeur. Pour chacun, vérifiez s’il existe une version compatible avec PrestaShop 9. Un module sans mise à jour depuis longtemps est un risque, même si l’assistant ne le signale pas.
Lancer la mise à jour
Le parcours comporte cinq étapes : « Version choice », « Update options », « Backup », « Update » et « Post-update checklist ».
- Version choice : trois canaux. « Recommended » propose la version compatible avec votre PHP, « latest » la plus récente compatible avec votre PHP, et « local » permet d’utiliser un fichier .zip et son .xml placés dans le dossier
autoupgrade/download. Dans ce dernier cas, les deux fichiers doivent correspondre à la version choisie. - Update options : « Regenerate email templates » est coché par défaut, et peut faire perdre vos modifications des modèles d’e-mails. Notez-les avant de valider. « Disable all overrides » est décoché par défaut.
- Update : la progression s’affiche avec des journaux. Le bouton « Start update » ouvre une fenêtre de confirmation.
Activez aussi le mode maintenance avant la mise à jour. Ce n’est pas une étape de l’assistant, mais c’est une précaution pour éviter qu’un client passe commande sur une boutique à moitié migrée.
Après la mise à jour
La documentation prévoit une checklist :
- rafraîchissez la page, puis reconnectez-vous au back-office ;
- réactivez les modules désactivés, un par un, et vérifiez à chaque fois que la boutique fonctionne ;
- testez le parcours complet, de la création d’un compte à la commande, sur une commande de test ;
- désactivez le mode maintenance dans Paramètres généraux > Maintenance ;
- contrôlez l’état de vos modules dans le Module Manager.
Si des images n’apparaissent plus sur le site, régénérez les miniatures dans Préférences > Images. La documentation ne prévoit pas de vidage de cache à cette étape.
En cas de problème
La documentation prévoit de restaurer une sauvegarde, depuis la rubrique « Restore from a backup » de l’assistant ou en ligne de commande. Les sauvegardes sont dans le dossier autoupgrade/backup. Si le back-office est inaccessible, activez à la main le mode debug dans config/defines.inc.php, comme dans notre guide de débogage PrestaShop 8 et 9. Si une erreur 500 apparaît après la mise à jour, suivez notre démarche de diagnostic des erreurs 500.
Questions fréquentes
Peut-on migrer sans tester sur une copie ?
Ce n’est pas recommandé. Une copie permet de repérer les modules incompatibles et les erreurs de thème sans toucher aux clients.
Faut-il réinstaller les modules après la mise à jour ?
Non, il faut les réactiver. Un module désinstallé par l’assistant doit être réinstallé dans une version compatible avec PrestaShop 9.
Que faire si la boutique ne répond plus ?
Restaurez la sauvegarde, puis consultez les journaux avant de relancer la mise à jour.
Sources
- Mise à jour depuis le back-office (prérequis, canaux, options, sauvegarde, restauration) : devdocs.prestashop-project.org
- Mise à jour en ligne de commande : devdocs.prestashop-project.org
- Checklist après mise à jour (modules, front office, maintenance, miniatures) : devdocs.prestashop-project.org
- Les étapes propres au passage de 8 à 9 ne figurent pas dans une documentation dédiée : la procédure ci-dessus vaut pour la mise à jour vers la version 9 et doit être vérifiée sur votre version.
