config\/xml\/<\/code><\/pre><\/div>Les plus importants d'entre eux sont :
- liste_modules_indispensables.xml<\/span> \u2013 liste des modules marqu\u00e9s comme \u201e incontournables \u201d par PrestaShop<\/li>
- modules_native_addons.xml<\/span> \u2013 liste des modules natifs disponibles dans les modules compl\u00e9mentaires<\/li>
- default_country_modules_list.xml<\/span> \u2013 modules sugg\u00e9r\u00e9s pour un pays sp\u00e9cifique<\/li>
- liste_modules_fiables.xml<\/span> \u2013 liste des modules de confiance v\u00e9rifi\u00e9s par PrestaShop<\/li><\/ul>Ces fichiers n'ont aucun impact sur le frontend de la boutique ni sur le traitement des commandes. Ils servent uniquement \u00e0 afficher des informations dans la section des modules du panneau d'administration.
Une erreur XML se pr\u00e9sente comme un message indiquant un probl\u00e8me dans la structure ou la syntaxe d'un fichier XML. Elle peut appara\u00eetre \u00e0 diff\u00e9rents endroits :\n\n* **Dans le navigateur web :** Si vous essayez d'ouvrir un fichier XML directement dans un navigateur et qu'il contient des erreurs, le navigateur affichera g\u00e9n\u00e9ralement un message d'erreur clair, indiquant la ligne et la colonne o\u00f9 le probl\u00e8me a \u00e9t\u00e9 d\u00e9tect\u00e9.\n* **Dans un \u00e9diteur XML ou un IDE :** Lorsque vous travaillez sur un fichier XML avec un outil d\u00e9di\u00e9 (comme Notepad++, VS Code avec un plugin XML, Oxygen XML Editor, etc.), l'\u00e9diteur peut surligner les erreurs, ajouter des ic\u00f4nes d'avertissement ou afficher des messages d'erreur dans un panneau d\u00e9di\u00e9.\n* **Lors du traitement par une application :** Si une application tente de lire, d'analyser ou de traiter un fichier XML qui contient des erreurs, elle \u00e9chouera et produira g\u00e9n\u00e9ralement une exception ou un message d'erreur d\u00e9crivant la nature du probl\u00e8me XML.\n* **Dans les logs d'erreurs :** Les erreurs li\u00e9es \u00e0 l'analyse XML sont souvent enregistr\u00e9es dans les fichiers journaux (logs) d'une application ou d'un serveur web pour \u00eatre examin\u00e9es ult\u00e9rieurement.\n\nLes erreurs XML courantes incluent :\n\n* **Balises non ferm\u00e9es :** Une balise d'ouverture (ex: ``) n'a pas sa balise de fermeture correspondante (ex: ``).\n* **Balises imbriqu\u00e9es incorrectement :** Les balises ne sont pas correctement hi\u00e9rarchis\u00e9es. Par exemple, `` est incorrect.\n* **Caract\u00e8res sp\u00e9ciaux non \u00e9chapp\u00e9s :** Les caract\u00e8res comme ``, `&`, `'`, `\"` doivent \u00eatre remplac\u00e9s par leurs entit\u00e9s XML (`<`, `>`, `&`, `'`, `"`) lorsqu'ils apparaissent dans du contenu texte, sauf s'ils font partie des balises elles-m\u00eames.\n* **Attributs mal form\u00e9s :** Les attributs doivent toujours \u00eatre entour\u00e9s de guillemets doubles ou simples (ex: `attribut=\"valeur\"`).\n* **Probl\u00e8mes d'encodage :** L'encodage d\u00e9clar\u00e9 dans le fichier XML (ex: ``) ne correspond pas \u00e0 l'encodage r\u00e9el du fichier.\n* **Non-respect de la structure d\u00e9finie par un DTD ou un sch\u00e9ma (XSD) :** Si le fichier XML est cens\u00e9 suivre une structure sp\u00e9cifique (sch\u00e9ma), une erreur peut survenir si cette structure n'est pas respect\u00e9e.<\/h6>L'erreur appara\u00eet le plus souvent directement dans le panneau d'administration \u2013 dans l'onglet Modules<\/strong> apr\u00e8s \u00eatre entr\u00e9 dans Gestionnaire de modules<\/strong>. Les communications peuvent se pr\u00e9senter comme suit :
Erreur trouv\u00e9e : balise de d\u00e9but attendue, '<' non trouv\u00e9 dans le fichier must_have_modules_list.xml\nErreur trouv\u00e9e : balise de d\u00e9but attendue, '<' non trouv\u00e9 dans le fichier modules_native_addons.xml\nErreur trouv\u00e9e : balise de d\u00e9but attendue, '<' non trouv\u00e9 dans le fichier default_country_modules_list.xml<\/code><\/pre><\/div>Note<\/div>Ces erreurs apparaissent dans PrestaShop 1.7 et PrestaShop 8.x. Dans les versions ant\u00e9rieures 1.6, le m\u00e9canisme fonctionne de mani\u00e8re similaire, bien que l'emplacement de certains fichiers puisse varier.<\/div><\/div>
D'o\u00f9 vient cette erreur ?<\/h6>PrestaShop envoie des requ\u00eates HTTP \u00e0 l'API PrestaShop Addons pour r\u00e9cup\u00e9rer les listes de modules actuelles. Un point de terminaison d'exemple ressemble \u00e0 ceci :
https:\/\/api.addons.prestashop.com\/?version=1.7.8.x&method=listing&action=must-have<\/code><\/pre><\/div>Le magasin attend une r\u00e9ponse au format XML. Le probl\u00e8me survient quand :- Les modules compl\u00e9mentaires d'API renvoient une r\u00e9ponse dans un format diff\u00e9rent (par exemple, JSON ou une page d'erreur HTML)<\/li>
- La connexion \u00e0 l'API est bloqu\u00e9e par un pare-feu ou une configuration du serveur<\/li>
- le serveur de la boutique n'a pas acc\u00e8s aux ressources externes (pas de trafic sortant HTTP\/HTTPS)<\/li>
- Les modules compl\u00e9mentaires de l'API sont temporairement indisponibles ou renvoient un d\u00e9lai d'attente d\u00e9pass\u00e9<\/li>
- La version de PrestaShop est trop ancienne et n'est plus prise en charge par l'API.<\/li><\/ul>Analyseur PHP simplexml_load_string()<\/span> lors de la tentative de traitement d'une mauvaise r\u00e9ponse, elle signale justement cette erreur \u2013 Balise de d\u00e9but attendue<\/em>.
Est-ce que le bug affecte le fonctionnement de la boutique ?<\/h6>Succ\u00e8s<\/div>Le frontend du magasin, le panier, les commandes, les paiements et tous les processus d'achat fonctionnent normalement. L'erreur ne concerne que le panneau d'administration \u2013 sp\u00e9cifiquement la section de gestion des modules.<\/div><\/div>Qu'est-ce qui peut cesser de fonctionner dans le panneau :- liste des modules recommand\u00e9s<\/li>
- section \u201e \u00e0 avoir \u201d dans le gestionnaire de modules<\/li>
- Compl\u00e9ments de march\u00e9 accessibles depuis l'administrateur<\/li>
- Suggestion de modules pour le pays<\/li>
- chargement plus lent de la page Modules (d\u00e9lai de connexion \u00e0 l'API observ\u00e9)<\/li><\/ul>
\u00c9tape 1 \u2013 V\u00e9rification du contenu des fichiers XML<\/h6>Avant d'apporter des modifications, il est conseill\u00e9 de v\u00e9rifier ce qui se trouve actuellement dans les fichiers. Par SSH<\/a> nous faisons :
cat config\/xml\/must_have_modules_list.xml<\/code><\/pre><\/div>Si le fichier est vide, contient du HTML (par exemple, une page d'erreur 503) ou du JSON au lieu d'XML, c'est la source du probl\u00e8me.
Conseil<\/div>Pour v\u00e9rifier le contenu du fichier, vous pouvez \u00e9galement utiliser le gestionnaire de fichiers du panneau d'h\u00e9bergement (par exemple, Hestia CP, cPanel) ou un client FTP \u2013 aucun acc\u00e8s SSH n'est requis.<\/div><\/div>
\u00c9tape 2 \u2013 Remplacement des fichiers par le XML correct<\/h6>La solution la plus rapide consiste \u00e0 remplacer le contenu des fichiers probl\u00e9matiques par un XML minimal et correct. Via SSH, nous ex\u00e9cutons\u00a0:
echo '' > config\/xml\/must_have_modules_list.xml\necho '' > config\/xml\/modules_native_addons.xml\necho '' > config\/xml\/default_country_modules_list.xml\necho '' > config\/xml\/trusted_modules_list.xml<\/code><\/pre><\/div>Vous pouvez \u00e9galement t\u00e9l\u00e9charger des fichiers manuellement via FTP. Chacun d'eux devrait ressembler \u00e0 ceci :
<\/code><\/pre><\/div>Avertissement<\/div>Seul le remplacement des fichiers r\u00e9soudra temporairement le probl\u00e8me. PrestaShop, lors du prochain rafra\u00eechissement de la page des modules, essaiera \u00e0 nouveau de r\u00e9cup\u00e9rer les donn\u00e9es de l'API et pourra \u00e9craser les fichiers avec une r\u00e9ponse erron\u00e9e.<\/div><\/div>
\u00c9tape 3 \u2013 solution permanente par surcharge de classe<\/h6>Pour bloquer d\u00e9finitivement les tentatives de t\u00e9l\u00e9chargement de XML depuis l'API des modules, nous cr\u00e9ons un override de classe Outils<\/span>. Nous cr\u00e9ons un fichier :
override\/classes\/Tools.php<\/code><\/pre><\/div>Sur le contenu suivant :
<?php\nclass Tools extends ToolsCore\n{\n protected static $is_addons_up = false;\n}<\/code><\/pre><\/div>Propri\u00e9t\u00e9 $is_addons_up = faux<\/span> cela PrestaShop \u00e0 ne pas essayer de se connecter \u00e0 l'API Addons \u2013 et par cons\u00e9quent, \u00e0 ne pas t\u00e9l\u00e9charger ni \u00e9craser les fichiers XML.
Apr\u00e8s avoir cr\u00e9\u00e9 le fichier de remplacement, nous vidons le cache. Pour PrestaShop 1.7 \/ 8.x<\/strong>:
rm -rf var\/cache\/dev\/*\nrm -rf var\/cache\/prod\/*<\/code><\/pre><\/div>Vous pouvez \u00e9galement vider le cache depuis le panneau d'administration : Avanc\u00e9 > Performance > Vider le cache<\/strong>.
Info<\/div>Apr\u00e8s avoir appliqu\u00e9 l'override, la section des modules continue de fonctionner pleinement : il est possible d'installer, d\u00e9sinstaller et mettre \u00e0 jour des modules depuis un fichier ZIP. Seule l'int\u00e9gration avec la marketplace Addons dans le panneau d'administration est d\u00e9sactiv\u00e9e.<\/div><\/div>
Alternative \u2013 blocage d'\u00e9criture dans des fichiers<\/h6>Si nous ne voulons pas utiliser de surcharge, il est possible de d\u00e9finir les fichiers XML en lecture seule. PrestaShop ne pourra ainsi pas les \u00e9craser :
chmod 444 config\/xml\/must_have_modules_list.xml\nchmod 444 config\/xml\/modules_native_addons.xml\nchmod 444 config\/xml\/default_country_modules_list.xml\nchmod 444 config\/xml\/trusted_modules_list.xml<\/code><\/pre><\/div>Note<\/div>La m\u00e9thode avec chmod est plus simple, mais elle n'\u00e9limine pas les tentatives de connexion \u00e0 l'API \u2013 PrestaShop continuera \u00e0 les ex\u00e9cuter, ce qui peut ralentir le chargement de la page des modules. Le override de la classe Tools est une solution techniquement plus propre.<\/div><\/div>
Qu'est-ce que nous ne perdons pas apr\u00e8s avoir d\u00e9sactiv\u00e9 l'API des modules compl\u00e9mentaires ?<\/h6>Il est bon de savoir que dans un environnement de production, la plupart de ces fonctionnalit\u00e9s ne sont de toute fa\u00e7on pas utilis\u00e9es au quotidien :