Skip to main content

Chapitre 8 — Vérifier l'installation avec la page Diagnostic

Le module dispose d'une page dédiée qui passe en revue l'ensemble de l'intégration et indique, point par point, si tout est en ordre.

C'est le premier réflexe à adopter après une installation, après une mise à jour ou en cas de comportement inattendu.

Accéder à la page Diagnostic

  1. Rendez-vous dans Outils → InfraS → InfraSStudio.
  2. Cliquez sur l'onglet Diagnostic dans le menu latéral.

La page se charge et exécute en direct une série de vérifications. Chaque ligne s'accompagne d'une pastille de couleur :

Couleur

Signification

Vert

Le point est correctement configuré. Aucune action n'est requise.

Orange

Avertissement non bloquant. Le module fonctionne mais une amélioration est possible.

Rouge

Anomalie bloquante. Une fonctionnalité importante ne fonctionne pas correctement.

Bleu

Information contextuelle, sans contrôle effectué.

Section 1 — Environnement

Cette section vérifie les versions de Dolibarr et de PHP, ainsi que la présence des extensions PHP requises.

Contrôle

Action en cas d'anomalie

Version Dolibarr

Mettez Dolibarr à jour (entre 18.0.0 et 24.x.x).

Version PHP

Demandez à votre hébergeur de basculer sur une version comprise entre 7.4 et 8.4.

Extensions PHP

Installez les extensions manquantes (par exemple

apt install php-mbstring php-gd

).

Module InfraSStudio activé

Activez le module dans Configuration → Modules.

Module Website (dépendance)

Activez le module Website dans Configuration → Modules.

Section 2 — Schéma SQL

Cette section vérifie la présence des cinq tables du module dans la base de données :

  • llx_infrasstudio_slot
  • llx_infrasstudio_media
  • llx_infrasstudio_media_alt
  • llx_infrasstudio_revision
  • llx_infrasstudio_product_translation

Conseil — En cas de table manquante, désactivez puis réactivez le module dans Configuration → Modules. Le module recrée les tables absentes lors de la réactivation.

Section 3 — Stockage

Cette section vérifie que les dossiers d'écriture sont accessibles à PHP :

  • DOL_DATA_ROOT : la racine des données Dolibarr.
  • Dossier de données du module : créé au premier téléversement.

Avertissement — Si un dossier n'est pas accessible en écriture, corrigez les permissions :
chown -R www-data:www-data /var/www/dolibarr/htdocs/documents/

Section 4 — Intégration Dolibarr

Cette section vérifie les hooks, le trigger et les tâches planifiées.

Contrôle

Description

Hooks

Quatre hooks sont attendus :

main

,

login

,

websitepage

,

websitenav

.

Trigger PRODUCT et CATEGORY

Le fichier

InterfaceInfrasstudiotrigger

doit être présent sur le disque.

Tâches planifiées

Au moins une tâche cron doit être déclarée pour le module.

Section 5 — Sites gérés

Pour chaque site activé, cette section contrôle :

  • la résolution du docroot (cascade : per-site → DOCROOT_PATTERN → fallback) ;
  • le bon fonctionnement du mode média (présence du lien symbolique en mode native) ;
  • l'accessibilité en écriture du dossier data du site.

« Aucun docroot résolu » — Définissez la constante INFRASSTUDIO_SITE_<id>_DOCROOT avec le chemin Apache absolu de ce site, ou utilisez le pattern INFRASSTUDIO_DOCROOT_PATTERN (par exemple /var/www/{ref}).

Section 6 — Catalogue produit dynamique (optionnel)

Cette section n'apparaît que si vous avez configuré INFRASSTUDIO_WEBSITE_KEY ou INFRASSTUDIO_PUBLIC_DOCROOT. Elle vérifie que ces deux constantes pointent vers des cibles valides.

Lecture du résultat global

Tous les voyants au vert — Vous pouvez passer à la Partie III (utilisateur final) ou à la Partie IV (développeur), selon votre rôle.

Quelques avertissements oranges — Le module fonctionne. Examinez les avertissements à tête reposée et décidez s'il convient de corriger immédiatement ou plus tard.

Au moins un voyant rouge — Interrompez votre installation et corrigez l'anomalie. Une fonctionnalité importante est inopérante et son symptôme apparaîtra plus tard de manière inattendue.

Quand relancer le diagnostic

  • Après une installation initiale du module.
  • Après chaque mise à jour.
  • Après une migration de serveur ou un changement d'hébergement.
  • Lorsqu'un comportement inattendu apparaît (slot non enregistré, médias absents, etc.).
  • Avant la transmission du projet à un nouveau collègue ou à un client.

Bonne pratique pour les équipes — Demandez à toute personne signalant un dysfonctionnement de joindre d'abord une capture d'écran de la page Diagnostic. La majorité des incidents trouvent leur explication dans une ligne orange ou rouge passée inaperçue.

Back to top