CHAPITRE 26 — Diagnostic et résolution des incidents

Lorsqu'un comportement inattendu apparaît, ce chapitre vous guide dans la résolution. Le réflexe à adopter est simple : commencer par la page Diagnostic, lire les journaux, et n'envisager une action plus radicale qu'en dernier recours.

Toujours commencer par la page Diagnostic

Outils → InfraSStudio → onglet Diagnostic. Le contrôle visuel (vert, 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 cinq tables SQL du module.
• Permissions d'écriture sur DOL_DATA_ROOT.
• Hooks chargés, présence du trigger, déclaration des tâches planifiées.
• Pour chaque site géré : résolution du docroot, mode média, dossier de données.

À retenir — 80 % des incidents signalés sont en réalité une ligne rouge ou orange du Diagnostic ignorée. Demandez systématiquement à toute personne qui rapporte un dysfonctionnement de joindre d'abord cette capture.

Lire les journaux 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

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

Conseil — Activer le niveau DEBUG — Pour traquer un incident subtil, augmentez temporairement le niveau de journalisation Dolibarr (Configuration → Sécurité → Système) à LOG_DEBUG. Pensez à le rabaisser une fois le diagnostic terminé.

Incidents fréquents et solutions

Incident	Cause probable	Solution
Le menu InfraS n'apparaît pas dans Outils Cause probable L'utilisateur ne 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 sans être publiées. Solution Cliquer sur « Publier les modifications » dans la barre d'outils. Voir le Chapitre 12.
L'aperçu affiche une erreur 404 Cause probable La page possède un type_container other , menu ou setup , et le filtre du noyau la bloque. Solution Le module corrige automatiquement ce comportement depuis la version 1.8.7. Vérifiez que vous êtes en version 1.8.7 ou supérieure.
Erreur réseau dans l'éditeur (erreur AJAX) Cause probable Session Dolibarr expirée, ou avertissement PHP émis avant les en-têtes HTTP. Solution Recharger la page Studio (F5). Si le problème persiste, consultez dolibarr.log pour identifier l'erreur PHP réelle.
Les images téléversées ne s'affichent pas publiquement Cause probable Lien symbolique medias manquant ou cassé en mode native. Solution Recréer le lien symbolique avec ln -sfn ... , ou 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 configurées. Solution Configurer ces 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 en ligne de commande : php scripts/rescan_slots.php <ref-site> . Réinitialiser le module Si le module se trouve dans un état incohérent (utilisation impossible, erreurs SQL persistantes), vous pouvez le réinitialiser : Configuration → Modules → InfraSStudio → cliquer sur Désactiver. Le module sauvegarde toutes ses constantes sous le préfixe INFRASSTUDIOBKP_. Cliquer à nouveau sur Activer. Le module restaure ses constantes, recrée les tables manquantes et réenregistre les hooks. Aucune perte de données — Les valeurs de slot, les médias et les traductions sont conservés dans leurs tables respectives. La désactivation puis réactivation ne touche qu'au descripteur et aux hooks. Demander de l'aide Si rien ne fonctionne, préparez ces trois informations avant toute demande d'aide : Capture d'écran de la page Diagnostic complète. Les vingt dernières lignes de dolibarr.log filtrées sur infrasstudio. La version exacte du module et de Dolibarr (visibles en haut de la page Diagnostic). Avec ces trois éléments, n'importe quel développeur connaissant le module peut établir un diagnostic en quelques minutes. Récapitulatif Vous savez désormais : Lancer la page Diagnostic comme premier réflexe. Lire et filtrer les journaux Dolibarr. Identifier les sept incidents fréquents et leurs solutions. Réinitialiser le module proprement (désactivation et réactivation). Préparer un rapport d'incident efficace en trois étapes.