CHAPITRE 26 — Diagnostic et résolution des incidents

🩺

Lorsqu'un Chapitrecomportement 26inattendu — Diagnostic et dépannage

Quand quelque chose ne va pas dans le module,apparaît, ce chapitre vous donneguide dans la marcherésolution. Le réflexe à suivre.adopter Laest règle d'orsimple : commencer par la page Diagnostic,Diagnostic, lire les logs,journaux, et nen'envisager paniquerune action plus radicale qu'en dernier recours.

---

1️⃣

Toujours commencer par la page Diagnostic

Outils → InfraSStudio → onglet Diagnostic. Le check-listcontrôle visuel (vertvert, / orange /orange, rouge) couvre :

• Versions de Dolibarr et de PHP, présence des extensions PHP requises.
• État du module et de sa dépendance Website.
• Présence des 5cinq tables SQL du module.
• Permissions d'écriture sur DOL_DATA_ROOT.DOL_DATA_ROOT.
• Hooks chargés, triggerprésence présent,du crontrigger, déclaré.déclaration des tâches planifiées.
• Pour chaque site managégéré : docrootrésolution résolu,du docroot, mode média, dossier data.de données.

✅À retenir — 80 % des problèmesincidents rapportéssignalés sont en réalité une ligne rouge ou orange du diagnosticDiagnostic ignorée. Demandez systématiquement à toute personne qui rapporte un bugdysfonctionnement de coller le diagnosticjoindre d'abord.abord cette capture.

---

📜

Lire les logsjournaux Dolibarr

Le module utilise dol_syslog() pour tracer les opérations sensibles, avec le préfixe infrasstudio.

Emplacement

htdocs/documents/dolibarr.log

Filtrer les entrées du module

# Toutes les entrées du module
grep "infrasstudio" htdocs/documents/dolibarr.log

# Uniquement les erreurs
grep "infrasstudio.*LOG_ERR" htdocs/documents/dolibarr.log

# SuivreSuivi en temps réel pendant qu'un utilisateur reproduit le problème
tail -f htdocs/documents/dolibarr.log | grep infrasstudio

💡Conseil — Activer lesle logsniveau DEBUG — —Pour Si vous chasseztraquer un bugincident subtil, augmentez temporairement le niveau de logjournalisation Dolibarr dans (Configuration → Sécurité → Système → Niveau de logSystème) à LOG_DEBUG. Pensez à le redescendrerabaisser après.une fois le diagnostic terminé.

---

🐞 Problèmes

Incidents fréquents et solutions

Le menu InfraS n'apparaît pas dans Outils

Cause probable	L'utilisateur n'ane possède pas la permission paramMenu .
Solution	Onglet Permissions de l'utilisateur, cocher paramMenu dans la section InfraSStudio.

Les modifications ne sont pas visibles publiquement

Cause probable	Modifications restées en brouillon nonsans être publiées.
Solution	Cliquer sur « Publier les modifications » dans la toolbarbarre de l'éditeur.d'outils. Voir le Chapitre 12.

L'aperçu affiche unune erreur 404

Cause probable	La page estpossède enun type_container type_container=other/menu/setupother , menu  ou setup , et le filtre coredu noyau la bloque.
Solution	Le module acorrige unautomatiquement fixce automatiquecomportement depuis la version 1.8.7. VérifierVérifiez que vous êtes en version ≥ 1.8.7.7 ou supérieure.

Erreur réseau dans l'éditeur (Erreurerreur AJAX)

Cause probable	Session Dolibarr expirée, ou un warningavertissement PHP émis avant les headers.en-têtes HTTP.
Solution	Recharger la page Studio (F5). Si le problème persiste, lireconsultez dolibarr.log pour voiridentifier l'erreur PHP réelle.

Les images uploadéestéléversées ne s'affichent pas publiquement

Cause probable	SymlinkLien symbolique medias manquant ou cassé en mode native.
Solution	Soit recréerRecréer le symlinklien (symbolique avec ln -sfn ... ), soitou basculer le site en mode média module .

Les wrappers solution-*.php ne se génèrent pas

Cause probable	INFRASSTUDIO_WEBSITE_KEY ou INFRASSTUDIO_PUBLIC_DOCROOT non définies.configurées.
Solution	Configurer lesces deux constantes dans Outils → InfraSStudio → Configuration → Wrappers.

Les slots ne se mettent pas à jour après modification du tpl.php

Cause probable	Le scanner n'a pas été lancé.
Solution	Outils → InfraSStudio → Contenu → bouton « Rescanner » . Ou viaen CLIligne de commande : php scripts/rescan_slots.php <ref-site> .

---

🆘

Réinitialiser proprement

le module

Si le module estse trouve dans un état incohérent (impossibleutilisation de l'utiliser,impossible, erreurs SQL persistantes), vous pouvez le réinitialiser :

1. Configuration → Modules → InfraSStudio → cliquer sur Désactiver.
2. Le module sauvegarde toutes ses constantes ensous le préfixe INFRASSTUDIOBKP_*INFRASSTUDIOBKP_.
3. Cliquer à nouveau sur Activer à nouveau..
4. Le module restaure ses constantes, recrée les tables manquantes et réenregistre les hooks.

✅ Aucune perte de données — — Les valeurs de slot, médias,les médias et les traductions sont conservéesconservés dans leurs tables.tables Lerespectives. désactivation/La désactivation puis réactivation ne touche qu'au descripteur et aux hooks.

---

🆘

Demander de l'aide

Si rien ne marche,fonctionne, préparez ces 3trois informations avant detoute demanderdemande de l'd'aide :

1. 📸 Capture d'écran de la page Diagnostic complète.
2. 📜 Les 20vingt dernières lignes de dolibarr.log filtrées sur infrasstudio.
3. 🔢 La version exacte du module et de Dolibarr (visibles en haut de la page Diagnostic).

Avec ces 3trois éléments, n'importe quel développeur connaissant le module peut diagnostiquerétablir un diagnostic en quelques minutes.

---

📋

Récapitulatif

✅ Vous savez maintenantdésormais :

• Lancer la page Diagnostic comme premier réflexe.
• Lire et filtrer les logsjournaux Dolibarr.
• Identifier les 7sept problèmesincidents fréquents et leurleurs solution.solutions.
• Réinitialiser le module proprement (désactiver/réactiver)désactivation et réactivation).
• Préparer un rapport de bugd'incident efficace en 3trois étapes.