Comment corriger message erreur controller not found sur Prestashop ?

1. Comment corriger l’erreur "Controller not found" sur PrestaShop après l’installation d’un module

L’erreur « Controller not found » peut apparaître après l’installation d’un module qui tente de charger un contrôleur inexistant ou mal déclaré. Cela se produit souvent si le module est incompatible avec votre version de PrestaShop.

Pour résoudre ce problème, commencez par désactiver le module fautif via FTP ou en renommant son dossier dans /modules/. Ensuite, videz le cache et vérifiez les fichiers controllers/front/ ou controllers/admin/ du module. Assurez-vous que le nom du contrôleur est bien conforme à la norme de PrestaShop (Majuscule et suffixe « Controller.php »).

2. Résoudre une erreur "Controller not found" après modification des routes personnalisées dans PrestaShop

Si vous avez récemment modifié les routes personnalisées dans PrestaShop (via le fichier routes.yml ou le back-office), une erreur « Controller not found » peut apparaître si la route pointe vers un contrôleur inexistant.

Revérifiez la configuration de vos routes, notamment le nom du contrôleur et son emplacement. Supprimez les caches dans /var/cache/ (ou /cache/ selon la version) pour que les modifications prennent effet. Une route mal configurée peut facilement faire échouer une page, donc chaque détail compte.

3. Corriger l’erreur "Controller not found" sur PrestaShop après une mise à jour de version

Une mise à jour de PrestaShop peut rendre obsolètes certains contrôleurs de modules ou de thèmes personnalisés. L’erreur « Controller not found » survient alors car le contrôleur appelé n’est plus reconnu par le système.

Vérifiez si le contrôleur est toujours présent dans le bon répertoire, et qu’il respecte la nouvelle structure de PrestaShop. Dans les dernières versions, certaines conventions ont évolué. Il peut être nécessaire d’adapter le code du module ou de mettre à jour celui-ci vers une version compatible avec votre PrestaShop actuel.

4. Activer le mode debug pour identifier l’origine de l’erreur "Controller not found" sur PrestaShop

Activer le mode debug vous permet de mieux comprendre pourquoi l’erreur « Controller not found » survient. Cela affiche des messages d’erreur complets au lieu d’une simple page blanche ou d’un code 404.

Pour cela, ouvrez le fichier config/defines.inc.php et remplacez define('_PS_MODE_DEV_', false); par true. Rechargez ensuite la page où l’erreur apparaît. Vous verrez alors le nom du contrôleur attendu, ce qui vous aidera à savoir s’il manque un fichier, une classe, ou si le nom est mal orthographié.

5. Vérifier la casse et le nommage du fichier contrôleur pour corriger l’erreur sur PrestaShop

PrestaShop est sensible à la casse des fichiers et des noms de classes. Un simple écart de majuscule ou un nom de fichier mal formé peut déclencher l’erreur « Controller not found ».

Assurez-vous que votre fichier s’appelle bien, par exemple, MycustomController.php et que la classe contenue porte exactement le même nom avec le suffixe « Controller » (ex. class MycustomController extends ModuleFrontController). Toute différence entre nom de fichier, nom de classe et déclaration dans le routeur peut faire échouer le chargement.

6. Corriger une erreur "Controller not found" liée à un override mal supprimé dans PrestaShop

Si vous avez récemment supprimé un fichier d’override sans bien nettoyer le cache, PrestaShop peut encore tenter de charger ce contrôleur, provoquant l’erreur « Controller not found ».

Rendez-vous dans /override/controllers/ et vérifiez qu’il ne reste pas de références inutilisées. Ensuite, allez dans le back-office > Paramètres Avancés > Performances, et cliquez sur « Recompiler les fichiers ». Supprimez également le cache manuellement si besoin. Cela permet à PrestaShop de réinitialiser ses chemins et d’arrêter de chercher un contrôleur supprimé.

7. Corriger une erreur "Controller not found" causée par un thème personnalisé mal configuré dans PrestaShop

Un thème personnalisé peut appeler un contrôleur inexistant dans ses fichiers TPL ou ses fichiers PHP. Si ce contrôleur n’existe pas, l’erreur « Controller not found » apparaîtra lorsque l'utilisateur accède à une page concernée.

Inspectez les fichiers du thème (notamment header.tpl, footer.tpl, ou page.tpl) et recherchez tout appel à une route personnalisée ou à un contrôleur. Assurez-vous que ceux-ci correspondent bien à des fichiers valides. Sinon, remplacez temporairement votre thème par le thème « Classic » pour tester.

8. Supprimer le cache de PrestaShop pour résoudre une erreur "Controller not found" persistante

Le cache de PrestaShop peut contenir d’anciennes informations sur les contrôleurs, en particulier après des suppressions ou des changements de nom. Même si le fichier est présent, l’erreur peut persister à cause d’un cache obsolète.

Supprimez manuellement les fichiers contenus dans /var/cache/prod/ ou /var/cache/dev/, selon que vous êtes en mode production ou développement. Ensuite, rechargez la page. Pensez également à désactiver la mise en cache temporairement pendant la résolution du problème.

9. Rechercher un conflit de module pouvant provoquer une erreur "Controller not found" sur PrestaShop

Deux modules peuvent tenter de déclarer un contrôleur avec le même nom, ce qui entraîne un conflit interne. L’un écrase alors l’autre, provoquant l’erreur « Controller not found » lorsqu’un module ne trouve plus son contrôleur initial.

Désactivez les modules un par un pour identifier le conflit, puis vérifiez leur déclaration dans config.xml ou routes.yml. Si nécessaire, renommez le contrôleur de l’un des modules pour éviter toute collision. Cette étape est essentielle dans les boutiques avec de nombreux modules installés.

10. Faire appel à un développeur PrestaShop pour corriger une erreur "Controller not found" complexe

Si l’erreur persiste malgré toutes vos vérifications, il peut être utile de faire appel à un développeur spécialisé PrestaShop. Il pourra diagnostiquer précisément la source du problème et corriger le code du contrôleur ou du module défectueux.

Les développeurs peuvent également vous aider à mettre à jour vos modules, corriger les routes ou refactorer le code mal structuré. Vous trouverez des professionnels qualifiés sur des plateformes comme Codeur.com, Malt ou sur la communauté officielle PrestaShop. Cela garantit une résolution rapide et durable.