{"id":835046,"date":"2026-02-26T13:54:29","date_gmt":"2026-02-26T13:54:29","guid":{"rendered":"https:\/\/www.knowband.com\/blog\/?p=835039\/"},"modified":"2026-03-10T13:18:45","modified_gmt":"2026-03-10T13:18:45","slug":"comment-utiliser-le-systeme-d-override-de-prestashop-sans-casser-le-core","status":"publish","type":"post","link":"https:\/\/www.knowband.com\/blog\/fr\/prestashop-blog-fr\/comment-utiliser-le-systeme-d-override-de-prestashop-sans-casser-le-core\/","title":{"rendered":"Comment utiliser le syst\u00e8me de remplacement de PrestaShop sans endommager le noyau ?"},"content":{"rendered":"

Le syst\u00e8me de remplacement de PrestaShop permet de personnaliser le comportement de base sans modifier les fichiers originaux. Cependant, mal utilis\u00e9, il cr\u00e9e des boutiques fragiles qui deviennent inutilisables lors des mises \u00e0 jour. Ce guide de Knowband explique le fonctionnement des remplacements, quand les utiliser et trois pi\u00e8ges importants que tout d\u00e9veloppeur devrait conna\u00eetre.<\/span><\/p>\n

Qu’est-ce que le syst\u00e8me de d\u00e9rogation\u00a0?<\/b><\/h2>\n

PrestaShop utilise l’h\u00e9ritage PHP pour vous permettre de remplacer n’importe quelle classe principale par votre propre version, sans modifier les originales. Chaque classe principale poss\u00e8de le suffixe \u00ab\u00a0Core\u00a0\u00bb, par exemple \u00ab\u00a0ProductCore\u00a0\u00bb. Si vous cr\u00e9ez le fichier `\/override\/classes\/Product.php` contenant une classe nomm\u00e9e `Product` qui \u00e9tend `ProductCore`, PrestaShop chargera votre version. Il en va de m\u00eame pour les contr\u00f4leurs.<\/span><\/p>\n

Ne modifiez que les m\u00e9thodes sp\u00e9cifiques que vous devez changer ; ne copiez jamais un fichier de classe entier. Cela permet de conserver des modifications plus concises et de r\u00e9duire consid\u00e9rablement les risques de conflits avec les mises \u00e0 jour ult\u00e9rieures.<\/span><\/p>\n

Exemple\u00a0: exposer le nom du contr\u00f4leur actuel dans votre mod\u00e8le d\u2019en-t\u00eate\u00a0:<\/span><\/p>\n

O\u00f9 placer vos fichiers de remplacement<\/b><\/h2>\n

Les param\u00e8tres de remplacement peuvent \u00eatre stock\u00e9s \u00e0 deux endroits. Le r\u00e9pertoire global `\/override\/` \u00e0 la racine de votre installation est actif imm\u00e9diatement apr\u00e8s la suppression du cache. Il est pr\u00e9f\u00e9rable de regrouper les param\u00e8tres de remplacement dans un module.<\/span><\/p>\n

Placer un fichier de surcharge dans un module (par exemple, \/modules\/mymodule\/override\/classes\/Product.php) permet \u00e0 PrestaShop de le copier dans \/override\/ lors de l’installation et de le supprimer proprement lors de la d\u00e9sinstallation. C’est la m\u00e9thode recommand\u00e9e.<\/span><\/p>\n

Voici un exemple rapide de surcharge de classe. Supposons que vous souhaitiez exposer le nom du contr\u00f4leur actuel dans votre mod\u00e8le d’en-t\u00eate\u00a0:<\/span><\/p>\n

\/\/ \/override\/classes\/controllers\/FrontController.php<\/span>\r\n\r\nclasse FrontController \u00e9tend FrontControllerCore {<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0fonction publique initHeader() {<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0self::$smarty->assign('currentController', get_class($this));<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0retourner parent::initHeader();<\/span>\r\n\r\n\u00a0\u00a0\u00a0\u00a0}}<\/span>\r\n\r\nAppelez toujours la m\u00e9thode parente, sauf raison valable de ne pas le faire. L'omettre perturbera silencieusement le fonctionnement de base.<\/span><\/pre>\n
Surcharge des classes et des contr\u00f4leurs de modules<\/b><\/h2>\n
Depuis PrestaShop 1.6, vous pouvez \u00e9galement surcharger les classes des modules. Ajoutez \u00ab\u00a0Override\u00a0\u00bb au nom de la classe (par exemple, BlockUserInfoOverride \u00e9tendant BlockUserInfo) et placez-la dans le r\u00e9pertoire \/override\/modules\/. La m\u00eame r\u00e8gle s’applique aux contr\u00f4leurs de modules. Apr\u00e8s toute surcharge, videz le cache, et plus pr\u00e9cis\u00e9ment supprimez le fichier \/cache\/class_index.php, sinon les modifications ne seront pas prises en compte.<\/span><\/p>\n
Quand NE PAS utiliser les substitutions<\/b><\/h2>\n
Les surcharges sont exclusives\u00a0: une seule est autoris\u00e9e par classe. Elles sont \u00e9galement interdites dans les modules de la marketplace et doivent \u00eatre r\u00e9serv\u00e9es aux personnalisations de boutiques priv\u00e9es. Avant d\u2019utiliser une surcharge, consid\u00e9rez l\u2019une des alternatives suivantes\u00a0:<\/span><\/p>\n