Prestashop : comment corriger back office page blanche ?

Prestashop : Activer le mode debug pour identifier l’erreur

Une page blanche dans le back office est souvent causée par une erreur fatale qui n’est pas affichée par défaut. Pour la révéler, activez le mode debug en modifiant le fichier config/defines.inc.php et en remplaçant false par true.

Une fois activé, rechargez la page. Vous verrez apparaître le message d’erreur détaillé, qui vous permettra de savoir si le problème vient d’un module, d’un fichier manquant ou d’un conflit de version PHP.

Prestashop : Vider le cache de Prestashop

Un cache corrompu ou obsolète peut empêcher le chargement correct des pages du back office, provoquant une page blanche. Connectez-vous à votre FTP et supprimez le contenu des dossiers /var/cache/prod et /var/cache/dev.

Cela force Prestashop à reconstruire ses fichiers temporaires, ce qui corrige souvent les problèmes d’affichage. Un cache mal géré peut bloquer l’accès à des fonctions essentielles ou à des interfaces d'administration critiques.

Prestashop : Vérifier les erreurs PHP dans les logs serveur

Si le mode debug n’affiche rien, les fichiers logs du serveur peuvent contenir les détails de l’erreur. Accédez à votre hébergement et consultez les logs PHP dans /var/log/, ou via le panneau de gestion de votre hébergeur.

Recherchez les erreurs liées à admin, employee, ou controller. Un fichier corrompu ou une fonction obsolète y sera probablement mentionné, ce qui vous permettra de corriger rapidement la source du bug.

Prestashop : Désactiver les modules récents

L’installation ou la mise à jour d’un module peut provoquer une erreur fatale et faire apparaître une page blanche. Pour tester, allez dans /modules via FTP et renommez le dossier du module récemment ajouté ou modifié.

Cela désactive son chargement sans supprimer ses données. Si le back office se recharge après cette manipulation, vous avez trouvé le module fautif. Il faudra le désinstaller proprement ou utiliser une version compatible.

Prestashop : Corriger les overrides corrompus

Les overrides sont des fichiers personnalisés qui remplacent les comportements natifs de Prestashop. Un override mal écrit dans /override/controllers/admin/ peut causer une page blanche dans le back office.

Essayez de renommer temporairement le dossier /override pour voir si la situation s’améliore. Si c’est le cas, supprimez ou corrigez les fichiers concernés. Les surcharges doivent toujours être testées dans un environnement de développement avant d’être mises en ligne.

Prestashop : Vérifier la version de PHP

Une incompatibilité PHP peut bloquer totalement l’accès au back office. Par exemple, Prestashop 1.7.8 n’est pas compatible avec PHP 8.1. Vérifiez la version PHP active sur votre serveur et comparez-la avec la documentation officielle.

Utilisez un fichier phpinfo() ou consultez la configuration via votre hébergeur. Si nécessaire, rétrogradez vers une version PHP compatible (comme PHP 7.4 ou 8.0) pour restaurer le fonctionnement normal de l’interface d’administration.

Prestashop : Réparer les fichiers du dossier /admin

Si vous avez modifié ou supprimé un fichier dans le dossier /admin, cela peut entraîner une page blanche dans le back office. Téléversez à nouveau une version propre de ce dossier en prenant soin de conserver son nom personnalisé.

Ne remplacez que les fichiers, pas le dossier complet, pour ne pas casser les chemins. Une erreur dans le contrôleur d’administration ou un fichier index.php endommagé peut bloquer l’affichage sans message d’erreur visible.

Prestashop : Réinitialiser les modules natifs

Certains modules natifs liés au back office, comme dashproducts, dashtrends, ou statsmodule, peuvent provoquer des erreurs s’ils sont corrompus. Allez dans Modules > Gestion des modules (si accessible) et cliquez sur réinitialiser.

Sinon, désactivez-les temporairement via FTP pour voir si l’accès redevient possible. Ces modules ajoutent des blocs à l’accueil du back office, donc une erreur dans l’un d’eux peut figer complètement l’affichage de l’interface.

Prestashop : Supprimer les cookies et sessions du navigateur

Des cookies corrompus ou des sessions expirées peuvent provoquer des comportements anormaux dans le back office, notamment des pages blanches après connexion. Supprimez les cookies de votre domaine dans les paramètres du navigateur.

Essayez aussi d’ouvrir le back office dans un autre navigateur ou en navigation privée. Cette manipulation permet de repartir sur une session propre et peut résoudre certains problèmes liés au stockage local ou au cache navigateur.

Prestashop : Restaurer une version stable

Si aucune solution ne fonctionne, restaurez une sauvegarde complète (fichiers + base de données) fonctionnelle. Assurez-vous de sauvegarder l’état actuel avant restauration pour pouvoir comparer et comprendre la source du problème.

Une page blanche persistante peut signaler une corruption profonde du système. Revenir à une version connue et stable est parfois la solution la plus rapide, en particulier après une mise à jour ratée ou une intervention manuelle risquée.