PrestaShop 9 : pages blanches sur « Modules » et « Traductions » après mise à jour retour d’expérience et solution

PrestaShop 9 : pages blanches sur « Modules » et « Traductions » après mise à jour retour d’expérience et solution

Lors du passage d’une boutique PrestaShop 8.x vers PrestaShop 9, je me suis retrouvé face à un problème bloquant : les pages Modules et Traductions du back-office affichaient une page blanche ou une erreur 500, alors que le reste de l’administration fonctionnait correctement.

En cherchant, je me suis rendu compte que je n’étais pas le seul. Plusieurs utilisateurs ont rencontré exactement le même souci sur les forums officiels PrestaShop, souvent sans solution claire ou définitive.

Voici donc un retour d’expérience concret, avec la cause réelle du problème et la solution qui a fonctionné dans mon cas.

---

Le symptôme

Après la mise à jour vers PrestaShop 9 :

• Le back-office est accessible
• Le tableau de bord s’affiche
• Le front-office fonctionne
• Mais :
  • la page Modules est blanche
  • la page Traductions est blanche ou retourne une erreur 500
  • aucun message explicite dans les logs PHP ou PrestaShop

Ce comportement est déroutant, car il donne l’impression d’un bug PHP, Symfony ou serveur… alors que ce n’est pas le cas.

---

Ce que disent les forums PrestaShop

Sur les forums PrestaShop, plusieurs utilisateurs décrivent exactement le même scénario :

• upgrade 1.7 → 8.x → 9.x
• pages Modules / Traductions inaccessibles
• parfois lié au module autoupgrade
• parfois lié à des modules pourtant désactivés

La difficulté est que désactiver un module dans le BO ne suffit pas toujours : PrestaShop 9 scanne physiquement le dossier modules/ lors de la compilation du container Symfony.

---

La vraie cause (dans mon cas)

Le problème venait d’un désalignement entre :

• les modules présents en base de données
• et les modules présents physiquement sur le disque

Concrètement :

• PrestaShop pensait que certains modules existaient
• mais leurs dossiers étaient absents, incomplets ou incompatibles
• le kernel Symfony échouait silencieusement lors du scan des modules
• résultat : pages BO blanches, sans message clair

---

La solution qui a fonctionné

Voici la méthode qui m’a permis de récupérer immédiatement l’accès aux pages Modules et Traductions.

1. Neutraliser temporairement tous les modules

Sur le serveur :

mv modules _modules
mkdir modules

À ce stade, PrestaShop ne « voit » plus aucun ancien module.

---

2. Créer un module autoupgrade vide

mkdir modules/autoupgrade

Même vide, ce dossier suffit à éviter certaines erreurs liées à un module encore référencé en base.

---

3. Accéder de nouveau au back-office

À ce moment-là :

• les pages Modules et Traductions redeviennent accessibles
• le back-office ne plante plus
• la compilation Symfony se fait correctement

---

4. Réinstaller les modules officiels PrestaShop 9

J’ai ensuite :

• téléchargé l’archive officielle de PrestaShop 9 depuis le site PrestaShop
• récupéré le dossier modules/ fourni
• réinstallé uniquement les modules de base compatibles PS9

Cela permet de repartir sur une base saine, sans modules hérités de PS8.

---

Pourquoi cette solution fonctionne

• PrestaShop 9 est beaucoup plus strict sur la structure des modules
• un module manquant ou incompatible peut bloquer tout le back-office
• même désactivé, un module peut être scanné par Symfony
• renommer le dossier modules empêche ce scan
• repartir avec des modules officiels PS9 évite les conflits

---

À retenir avant une migration PrestaShop 9

Avant ou après un upgrade vers PrestaShop 9 :

• ne jamais garder des modules PS8 non compatibles
• vérifier que chaque module en base existe bien sur le disque
• privilégier une réinstallation propre des modules officiels
• éviter de tester trop de correctifs serveur tant que la couche applicative n’est pas saine

---

Conclusion

Ce problème de pages blanches sur Modules et Traductions n’est ni un bug serveur, ni un bug PHP, ni un bug Symfony à proprement parler. C’est un problème de cohérence entre les modules et PrestaShop 9, que beaucoup d’utilisateurs rencontrent actuellement.

Dans mon cas, la solution a été :

• isoler les modules existants
• repartir sur des modules PrestaShop 9 propres (voir ci-dessous).
• puis réinstaller progressivement uniquement ce qui est compatible

Si cet article peut éviter à d’autres de perdre plusieurs heures (ou une nuit blanche) de debug, alors mission accomplie. N’hésite pas à laisser un commentaire 😉

🧩 Bonus : modules natifs PrestaShop 9 (CORE)

Voici la liste la plus complète et fidèle possible des modules présents dans l’archive officielle de PrestaShop 9.x (package standard téléchargé sur le site PrestaShop, hors modules optionnels Addons).

👉 C’est LA référence pour repartir proprement après une migration PS8 → PS9.

---

🔧 Modules cœur / back-office

• ps_accounts
• ps_adminnotifications
• ps_banner
• ps_contactinfo
• ps_customtext
• ps_customeraccountlinks
• ps_emailalerts
• ps_emailsubscription
• ps_eventbus
• ps_metrics
• ps_mbo
• ps_themecusto

---

🧭 Navigation / structure

• ps_mainmenu
• ps_linklist
• ps_searchbar
• ps_facetedsearch
• ps_languageselector
• ps_currencyselector
• ps_socialfollow

---

🛒 Catalogue & merchandising

• ps_featuredproducts
• ps_newproducts
• ps_bestsellers
• ps_specials
• ps_categoryproducts
• ps_crossselling
• ps_viewedproduct

---

🖼️ Contenu & affichage

• ps_imageslider
• ps_contactform

---

💳 Paiements natifs

(présents dans l’archive mais souvent désactivés par défaut)

• ps_wirepayment
• ps_checkpayment
• ps_cashondelivery

---

🚚 Livraison / utilitaires

• ps_carriercomparison

---

⚠️ Modules ABSENTS de l’archive PS9 (important)

Ces modules ne font plus partie du core et ne doivent pas être copiés depuis PS8 :

• blockrss
• productscategory (ancienne version)
• anciens modules block*
• autoupgrade (désormais Update Assistant, à installer séparément)
• modules legacy non préfixés ps_

👉 Leur présence est une cause directe de pages blanches sur PS9.

---

🧠 Points clés à retenir

• Tous les modules PS9 natifs commencent par ps_
• Aucun module legacy n’est inclus
• Le module autoupgrade n’est PAS dans l’archive
• PS9 est strict sur la cohérence DB ↔ filesystem
• Un module manquant physiquement mais présent en DB peut casser le BO

---

✅ Bonne pratique après migration

1. Supprimer/mettre de côté tous les anciens modules
2. Installer uniquement cette liste
3. Vérifier :
   • Modules
   • Traductions
4. Ajouter les modules tiers un par un