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

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 :

1. Configuration → Modules → InfraSStudio → cliquer sur Désactiver.
2. Le module sauvegarde toutes ses constantes sous le préfixe INFRASSTUDIOBKP_.
3. Cliquer à nouveau sur Activer.
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, 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 :

1. Capture d'écran de la page Diagnostic complète.
2. Les vingt 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 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.