Chapitre 5 — Prérequis et compatibilité
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. Aucun n'est facultatif.
Côté Dolibarr
Élément | Exigence |
|---|---|
Version Dolibarr | 18.0.0 minimum, 24.x.x maximum |
Module Website | Activé. Cette dépendance est obligatoire ; sans elle, l'installation du module échoue. |
Au moins un site Website | Créé avec une référence et un virtualhost |
Module Categories | Recommandé. Utile pour la catégorisation des contenus. |
Conseil — La version de votre Dolibarr est consultable depuis Accueil → À propos. La liste des modules activés est disponible dans Configuration → Modules.
Côté serveur (PHP et système)
Élément | Exigence |
|---|---|
Version PHP | 7.4 minimum, 8.4 maximum |
Extensions PHP |
,
,
,
,
|
Base de données | MySQL 5.7 ou supérieur, ou MariaDB 10.3 ou supérieur |
Serveur web | Apache (recommandé) ; nginx pris en charge avec une configuration dédiée |
Espace disque | Environ 50 Mo pour le module, en plus de l'espace nécessaire à vos médias |
Permissions du système de fichiers | PHP doit pouvoir écrire dans
ainsi que dans le docroot des sites |
Note — 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.
Vérification rapide en ligne de commande
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/Liste de contrôle avant installation
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.
- Vous avez à votre disposition l'archive du module ou un accès au répertoire
htdocs/custom/.
Avertissement — 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.