Skip to main content

Diagnostic et dépannage

🩺 Chapitre 26 — Diagnostic et dépannage

Quand quelque chose ne va pas dans le module, ce chapitre vous donne la marche à suivre. La règle d'or : commencer par la page Diagnostic, lire les logs, et ne paniquer qu'en dernier recours.

1️⃣ Toujours commencer par la page Diagnostic

Outils → InfraSStudio → onglet Diagnostic. Le check-list visuel (vert / orange / rouge) couvre :

  • Versions Dolibarr et PHP, extensions PHP requises.
  • État du module et de sa dépendance Website.
  • Présence des 5 tables SQL du module.
  • Permissions d'écriture sur DOL_DATA_ROOT.
  • Hooks chargés, trigger présent, cron déclaré.
  • Pour chaque site managé : docroot résolu, mode média, dossier data.

✅ 80 % des problèmes rapportés sont en réalité une ligne rouge ou orange du diagnostic ignorée. Demandez systématiquement à toute personne qui rapporte un bug de coller le diagnostic d'abord.

📜 Lire les logs 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

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

💡 Activer les logs DEBUG — Si vous chassez un bug subtil, augmentez le niveau de log Dolibarr dans Configuration → Sécurité → Système → Niveau de log à LOG_DEBUG. Pensez à le redescendre après.

🐞 Problèmes fréquents et solutions

Le menu InfraS n'apparaît pas dans Outils

Cause probable

L'utilisateur n'a 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 en brouillon non publiées.

Solution

Cliquer sur

« Publier les modifications »

dans la toolbar de l'éditeur. Voir Chapitre 12.

L'aperçu affiche un 404

Cause probable

La page est en

type_container=other/menu/setup

et le filtre core la bloque.

Solution

Le module a un fix automatique depuis 1.8.7. Vérifier que vous êtes en version ≥ 1.8.7.

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

Cause probable

Session Dolibarr expirée, ou un warning PHP avant les headers.

Solution

Recharger la page Studio (F5). Si persiste, lire

dolibarr.log

pour voir l'erreur PHP réelle.

Les images uploadées ne s'affichent pas publiquement

Cause probable

Symlink

medias

manquant ou cassé en mode native.

Solution

Soit recréer le symlink (

ln -sfn ...

), soit 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.

Solution

Configurer les 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 via CLI :

php scripts/rescan_slots.php <ref-site>

.

🆘 Réinitialiser proprement

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

  1. Configuration → Modules → InfraSStudio → cliquer sur Désactiver.
  2. Le module sauvegarde toutes ses constantes en INFRASSTUDIOBKP_*.
  3. Cliquer 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, traductions sont conservées dans leurs tables. Le désactivation/réactivation ne touche qu'au descripteur et aux hooks.

🆘 Demander de l'aide

Si rien ne marche, préparez ces 3 informations avant de demander de l'aide :

  1. 📸 Capture d'écran de la page Diagnostic complète.
  2. 📜 Les 20 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 3 éléments, n'importe quel développeur connaissant le module peut diagnostiquer en quelques minutes.

📋 Récapitulatif

✅ Vous savez maintenant :

  • Lancer la page Diagnostic comme premier réflexe.
  • Lire et filtrer les logs Dolibarr.
  • Identifier les 7 problèmes fréquents et leur solution.
  • Réinitialiser le module proprement (désactiver/réactiver).
  • Préparer un rapport de bug efficace en 3 étapes.
Back to top