Une page blanche sur PrestaShop est une erreur PHP que le serveur n'affiche pas : le code de la boutique, écrit en PHP, s'est arrêté net, et le serveur masque le message par prudence. C'est sérieux tant que la boutique ne vend plus, mais rien n'est effacé. Si Chrome affiche « Ce site est inaccessible », c'est une autre panne.
Faire apparaître l'erreur
Le message caché nomme souvent le fichier en cause : nous commençons toujours par le lire.
Le moyen le plus discret est le journal d'erreurs de l'hébergeur, dans l'espace client, rubrique des journaux ou « logs ». La dernière ligne contenant « PHP Fatal error » est en général la bonne.
L'autre moyen, à confier de préférence à votre prestataire, est le mode débogage, qui affiche les erreurs à l'écran. Si l'administration répond, il s'active dans Paramètres avancés > Performances. Sinon, ouvrez par FTP (l'accès aux fichiers du site) le fichier config/defines.inc.php et, sur la ligne define('_PS_MODE_DEV_', false);, remplacez false par true. Rechargez la page : si le chemin affiché contient /modules/, le nom qui suit désigne un suspect.
Copiez le message, puis refermez aussitôt (false, ou Non dans l'administration).
Le dernier module ou thème modifié
Ensuite, nous cherchons ce qui a changé juste avant la panne : un module installé ou mis à jour, un fichier du thème retouché.
Si l'administration répond, l'écran Performances propose « Désactiver les modules non natifs », ceux qui ne sont pas fournis avec PrestaShop. Passez-le sur Oui, rechargez la boutique : si elle revient, un module ajouté est en cause. Remettez Non, puis désactivez les modules ajoutés un par un depuis le menu Modules, le plus récent d'abord.
Sinon, renommez par FTP le dossier du module suspect, dans modules/ : nomdumodule devient nomdumodule-off. PrestaShop ne le charge plus ; lui rendre son nom annule tout. Pour le thème, remettez la version précédente du fichier modifié. Si la panne suit une mise à jour de PrestaShop lui-même, lisez plutôt la page sur l'erreur 500 après mise à jour.
La version de PHP changée par l'hébergeur
La boutique peut tomber sans que personne n'y touche, si l'hébergeur change la version de PHP du serveur. Or PrestaShop 1.7 s'arrête à PHP 7.4 : passée en PHP 8, une boutique 1.7 affiche le plus souvent une page blanche. Un vieux module peut aussi refuser la nouvelle version.
Regardez la version active dans l'espace client de l'hébergeur, et cherchez dans vos e-mails une annonce de changement. Si l'ancienne version est encore proposée, y revenir remet en général la boutique en ligne, en attendant de la mettre à jour.
Mémoire, cache et disque plein
La mémoire PHP
Si le journal contient « Allowed memory size of … bytes exhausted », la mémoire accordée à chaque page ne suffit plus : augmentez memory_limit dans les réglages PHP de l'espace client.
Le cache
Le cache, ce sont des copies toutes prêtes que PrestaShop garde pour aller plus vite ; une copie abîmée peut bloquer l'affichage. Si l'administration répond, cliquez sur « Vider le cache », en haut à droite de l'écran Performances. Sinon, videz par FTP le contenu de var/cache/prod et var/cache/dev (en 1.6, cache/smarty/compile et cache/smarty/cache) : PrestaShop le reconstruit seul. Si rien ne change, la cause est ailleurs, ou c'est un autre cache qui répond.
L'espace disque
Un hébergement plein empêche PrestaShop d'écrire ses fichiers, cache compris. Cette cause fréquente se voit dans l'espace client, qui affiche l'espace utilisé. Le disque se remplit le plus souvent de sauvegardes empilées (celles de 1-Click Upgrade, par exemple) ou de journaux qui enflent depuis des mois.
Boutique, administration ou les deux
- La boutique seule : thème ou module qui s'affiche sur les pages.
- Une seule page, comme la fiche produit ou le panier : un module qui intervient sur cette page. Notez son adresse.
- L'administration seule : un module qui ajoute des écrans à l'administration, le cache ou la mémoire. La boutique continue de vendre.
- Les deux : une cause commune, souvent côté serveur (version de PHP, mémoire, disque) ou un module chargé partout. C'est le cas le plus urgent.
À éviter, et quand nous écrire
Ne supprimez rien au hasard : un dossier renommé se remet en place, un dossier supprimé ne revient pas sans sauvegarde. Sur un disque plein, gardez au moins la sauvegarde la plus récente.
Ne laissez pas le mode débogage ouvert sur la boutique en ligne : il montre le détail technique de votre installation à tous les visiteurs, robots compris.
Écrivez-nous si l'erreur reste introuvable, si elle désigne un fichier de PrestaShop lui-même (dossiers classes, src ou vendor), ou si vous n'avez pas d'accès FTP. Trois demandes sur quatre reçoivent une réponse en moins de 24 heures. Joignez à votre message :
- l'adresse de la boutique et sa version de PrestaShop
- où apparaît la page blanche, et depuis quand
- la dernière action faite sur le site, ou le dernier e-mail de l'hébergeur
- le message d'erreur, copié ou en capture
- les accès (FTP, espace client, administration) : nous vous les demandons ensuite par un canal chiffré, jamais dans le message