La mise à jour Dolibarr peut devenir nécessaire lorsque les besoins ou les contraintes administratives évoluent. Par exemple, avec l’apparition de la facture électronique, il faut avoir une version minimum de Dolibarr et installer le module qui ajoute cette fonctionnalité.
Le logiciel Dolibarr doit donc suivre les évolutions pour rester compatible avec l’administration.
Les versions des logiciels (PHP, MySQL) qu’utilise Dolibarr pour fonctionner changent et Dolibarr doit aussi suivre les contraintes techniques.
Voilà pourquoi il faut mettre à jour.
Votre hébergeur a mis à jour PHP et Dolibarr ne fonctionne plus très bien
Dolibarr est programmé dans un langage : PHP
Or, PHP existe en de très nombreuses versions et maintenir ces versions prend du temps et des ressources. C’est pourquoi, parfois l’hébergeur va forcer votre Dolibarr à utiliser un PHP plus récent.
Mais lorsqu’il le fait, votre Dolibarr peut arrêter de fonctionner subitement.
Dolibarr commence alors à avoir des pages blanches ou des morceaux de pages coupées, ou même des actions qui ne fonctionnent plus.
Il faut que la version de PHP et de Dolibarr se suivent plus ou moins pour que le tout reste opérationnel.
De quelle version partez-vous
Le chemin dépend de votre point de départ. Deux contraintes se cumulent : la version de PHP que votre hébergeur vous impose, et les changements de comportement introduits par Dolibarr en montant de version.
- Dolibarr 14, sorti en juillet 2021 : PHP 5.6 à 7.4.
- Dolibarr 15, sorti en février 2022 : PHP 5.6 à 7.4.
- Dolibarr 16, sorti en septembre 2022 : PHP 5.6 à 8.1.
- Dolibarr 17, sorti en mars 2023 : PHP 7.0 à 8.1.
- Dolibarr 18, sorti en août 2023 : PHP 7.1 à 8.1.
- Dolibarr 19, sorti en février 2024 : PHP 7.1 à 8.2.
- Dolibarr 20, sorti en septembre 2024 : PHP 7.1 à 8.2.
- Dolibarr 21, sorti en février 2025 : PHP 7.1 à 8.3.
- Dolibarr 22, sorti en juillet 2025 : PHP 7.1 à 8.4.
- Dolibarr 23, sorti en février 2026 : PHP 7.2 à 8.4.
Ces bornes viennent du tableau officiel des versions Dolibarr. Elles expliquent la panne décrite plus haut : un Dolibarr 15 ne fonctionne pas au delà de PHP 7.4, un Dolibarr 18 s’arrête à PHP 8.1. Le jour où l’hébergeur bascule sur une version de PHP plus récente, l’installation cesse de répondre.
Ce qui change en montant vers Dolibarr 23
Trois modules disparaissent ou changent de statut, et c’est là que les installations personnalisées cassent :
- Le module « Site externe » est supprimé. Il est remplacé par l’éditeur de menus natif.
- Le module « OpenID Connect » n’existe plus comme module. Sa configuration passe dans Accueil, Configuration, Sécurité.
- Le module Zapier repasse en statut expérimental.
Le détail complet figure dans Dolibarr 23 : les nouveautés importantes.
Ce qui change en montant vers Dolibarr 24
Trois comportements par défaut changent, et chacun peut provoquer une régression :
- La syntaxe Universal Search devient obligatoire sur les paramètres de filtre. Les modules et les personnalisations qui utilisaient l’ancienne syntaxe doivent être adaptés.
- Le token CSRF passe en mode 3 et le filtrage HTML restrictif est activé par défaut. Les intégrations et les champs personnalisés peuvent en être affectés.
- Les API de connexion sont désactivées par défaut. Il faut activer API_ENABLE_LOGIN_API pour rétablir l’ancien comportement.
Le détail complet figure dans Dolibarr 24 : les nouveautés importantes.
Mise à jour qui se termine en erreur fatale
Une mise à jour interrompue peut mettre Dolibarr dans un état instable.
L’interface se charge partiellement, certains menus disparaissent et d’autres affichent des messages d’erreur incompréhensibles.
Des pages qui fonctionnaient auparavant deviennent soudainement impossibles à ouvrir.
Les documents PDF ne se génèrent plus. Les listes restent vides alors que les données existent toujours dans la base.
Dans certains cas, l’accès à la base de données reste bloqué en mode maintenance.
Dolibarr attend une étape qui ne s’est jamais terminée. Vous cliquez partout et rien ne répond. Les actions simples comme créer une facture ou valider un devis provoquent une erreur immédiate.
Les modules internes ne se chargent plus ou se chargent à moitié, avec des boutons absents et des champs impossibles à modifier.
Parfois, la mise à jour laisse des tables incomplètes. Certaines lignes ont été créées mais pas les autres. Dolibarr ne reconnaît plus sa structure interne et tout ce qui dépend de ces tables devient inutilisable. Cela peut aller jusqu’à bloquer la connexion, l’utilisateur étant accueilli par un écran vide ou un message qui indique que la mise à jour doit être terminée alors qu’elle ne peut plus avancer.
Le pire symptôme est une base incohérente. Les données existent, mais Dolibarr ne peut plus y accéder correctement. Les totaux ne correspondent plus, les calculs se bloquent, les historiques ne s’affichent plus et les journaux d’activité ne remontent plus aucune information. Le logiciel reste ouvert, mais il n’est plus fiable. Impossible de travailler sereinement dans cet état.
Enfin, il arrive que l’ensemble fonctionne en apparence mais produise des erreurs silencieuses. Les enregistrements ne se sauvegardent plus. Les modifications disparaissent. Les formulaires reviennent en arrière sans prévenir. C’est la situation la plus délicate, car on croit que tout va bien alors que des données sont déjà perdues ou inexploitables.
Ce sont ces symptômes cumulés qui transforment une mise à jour ratée en blocage complet.
Notre méthode pour garantir une mise à jour Dolibarr fiable
Premièrement, nous hébergeons Dolibarr de façon sécurisée et personne d’autre n’a la main directement sur l’installation. Nous gardons l’ensemble dans un état cohérent à notre modèle d’installation.
Tous les hébergements ont le même modèle, qui est entièrement maîtrisé. On ne veut aucune surprise.
Donc pour mettre à jour, nous attendons environ 3 mois après les mises à jour majeures avant de tester sur notre Dolibarr la mise à jour. On laisse ce temps car il est nécessaire à diminuer les problèmes et laisser le temps à d’éventuels modules externes connus d’être compatibles.
Ensuite, nous mettons à jour votre Dolibarr de façon décalée.
Nous savons réparer les problèmes de mise à jour comme des problèmes avec la base de données, des problèmes PHP ou autre,…
Vous n’avez pas à vous préoccuper de la mise à jour
Nous en faisons notre affaire.
S’il y a des modules externes, nous vous contacterons pour pouvoir vérifier la compatibilité.
Le reste, vous n’avez pas à demander de mises à jour, nous gérons ce détail au bon moment.
Vous obtenez alors un réel service de Dolibarr en ligne.