# Chapitre 5 — Prérequis et compatibilité

<span style="white-space: pre-wrap;">Avant l'installation du module, il convient de vérifier que votre environnement répond aux conditions techniques requises. Cette page liste l'ensemble des prérequis. </span>**Aucun n'est facultatif**.

#### <span style="color: rgb(35, 111, 161);">Côté Dolibarr</span>

<table id="bkmrk-%C3%89l%C3%A9mentexigenceversi" style="width: 100%; border-collapse: collapse; margin: 1rem 0px; font-size: 0.95em;"><colgroup><col></col><col></col></colgroup><tbody><tr style="background: rgb(25, 5, 45); color: rgb(254, 252, 232);"><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Élément

</th><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Exigence

</th></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Version Dolibarr**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">18.0.0 minimum, 24.x.x maximum

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Module Website**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Activé. Cette dépendance est obligatoire ; sans elle, l'installation du module échoue.

</td></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Au moins un site Website**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Créé avec une référence et un virtualhost

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Module Categories**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Recommandé. Utile pour la catégorisation des contenus.

</td></tr></tbody></table>

<p class="callout info">**Conseil —**<span style="white-space: pre-wrap;"> La version de votre Dolibarr est consultable depuis Accueil → À propos. La liste des modules activés est disponible dans Configuration → Modules.</span></p>

#### <span style="color: rgb(35, 111, 161);">Côté serveur (PHP et système)</span>

<table id="bkmrk-%C3%89l%C3%A9mentexigenceversi-1" style="width: 100%; border-collapse: collapse; margin: 1rem 0px; font-size: 0.95em;"><colgroup><col></col><col></col></colgroup><tbody><tr style="background: rgb(25, 5, 45); color: rgb(254, 252, 232);"><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Élément

</th><th class="align-left" style="padding: 0.6rem 1rem; text-align: left; border: 1px solid rgb(25, 5, 45);">Exigence

</th></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Version PHP**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">7.4 minimum, 8.4 maximum

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Extensions PHP**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">`<span class="editor-theme-code">mbstring</span>`

<span style="white-space: pre-wrap;">, </span>

`<span class="editor-theme-code">json</span>`

<span style="white-space: pre-wrap;">, </span>

`<span class="editor-theme-code">pdo_mysql</span>`

<span style="white-space: pre-wrap;">, </span>

`<span class="editor-theme-code">gd</span>`

<span style="white-space: pre-wrap;">, </span>

`<span class="editor-theme-code">fileinfo</span>`

</td></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Base de données**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">MySQL 5.7 ou supérieur, ou MariaDB 10.3 ou supérieur

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Serveur web**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Apache (recommandé) ; nginx pris en charge avec une configuration dédiée

</td></tr><tr><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Espace disque**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">Environ 50 Mo pour le module, en plus de l'espace nécessaire à vos médias

</td></tr><tr style="background: rgb(250, 245, 255);"><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);">**Permissions du système de fichiers**

</td><td style="padding: 0.6rem 1rem; border: 1px solid rgb(229, 231, 235);"><span style="white-space: pre-wrap;">PHP doit pouvoir écrire dans </span>

`<span class="editor-theme-code">DOL_DATA_ROOT</span>`

<span style="white-space: pre-wrap;"> ainsi que dans le docroot des sites</span>

</td></tr></tbody></table>

<p class="callout info">**Note —**<span style="white-space: pre-wrap;"> Tous ces prérequis sont contrôlés automatiquement par la page Diagnostic du module après installation. En cas de doute, procédez à l'installation et laissez le diagnostic identifier les manquements éventuels.</span></p>

#### <span style="color: rgb(35, 111, 161);">Vérification rapide en ligne de commande</span>

Si vous disposez d'un accès SSH au serveur, les commandes suivantes vous permettent de contrôler l'environnement en quelques instants :

```
# Version PHP
php -v

# Extensions PHP installées
php -m | grep -iE "mbstring|json|pdo_mysql|gd|fileinfo"

# Version de Dolibarr
grep "version =" /var/www/dolibarr/htdocs/filefunc.inc.php

# Espace disque disponible
df -h /var/www/
```

#### <span style="color: rgb(35, 111, 161);">Liste de contrôle avant installation</span>

**Avant de passer au chapitre suivant, assurez-vous des points suivants :**

- Votre installation Dolibarr est en version 18.x à 24.x.
- Le module Website est activé.
- Au moins un site Website est créé, avec une référence et un virtualhost configurés.
- Vous disposez des droits d'administrateur sur Dolibarr.
- <span style="white-space: pre-wrap;">Vous avez à votre disposition l'archive du module ou un accès au répertoire </span>`<span class="editor-theme-code">htdocs/custom/</span>`.

<p class="callout warning">**Avertissement —**<span style="white-space: pre-wrap;"> Sur une instance de production, il est impératif d'effectuer une sauvegarde complète (base de données et fichiers) avant l'installation. C'est l'occasion idéale de tester votre procédure de restauration.</span></p>