# 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__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.