Mettre à jour Joomla sans casser son site demande méthode et préparation rigoureuse. Des erreurs fréquentes surviennent lors des mises à niveau majeures et perturbent l’accès utilisateur.
Je présente des recommandations opérationnelles issues d’expériences de migration et de la documentation officielle. Ces précautions mènent naturellement à des points concrets à vérifier avant d’agir.
A retenir :
- Sauvegardes complètes des fichiers de site et de la base de données
- Serveur en préproduction avec PHP 8.1 minimum et accès SSH
- Inventaire des extensions tierces et état de compatibilité
- Tests en local ou préproduction et vérification du SEO
Préparer le serveur et les sauvegardes pour Joomla 5
Après les vérifications listées, la préparation du serveur et des sauvegardes devient prioritaire. Il faut garantir des accès SFTP ou SSH et des copies valides des fichiers et de la base de données.
Selon la documentation officielle, Joomla 5 exige au minimum PHP 8.1 et recommande PHP 8.3 pour de meilleures performances. Vérifier les permissions et tester une restauration reste indispensable avant toute mise en production.
Voici un tableau synthétique comparant quelques extensions populaires et leur état de compatibilité connu. Cette vue aide à prioriser les actions avant la mise à jour vers Joomla 5.
Extension
Type
Compatibilité Joomla 5
Remarque
Akeeba Backup
Sauvegarde
Généralement compatible
Test recommandé avant production
RSJoomla
Composants tiers
Compatibilité variable
Vérifier versions auprès du fournisseur
JCE Editor
Éditeur
Compatibilité confirmée
Mettre à jour le plugin installé
SP Page Builder
Constructeur de pages
Mise à jour requise
Tester en préproduction
RocketTheme
Templates
Adaptation nécessaire
Overrides à vérifier
Étapes serveur :
- Mettre à jour PHP vers 8.3 si possible
- Configurer accès SFTP/SSH et clés sécurisées
- Vérifier espace disque et limites de mémoire
- Planifier fenêtre de maintenance hors-pointe
« J’ai sauvé un site en testant d’abord la restauration Akeeba sur un clone »
Alice B.
Gérer les extensions et la compatibilité avec Joomla 5
Ce chapitre suit la préparation serveur et détaille l’audit des extensions et thèmes. L’objectif est d’identifier tout plugin ou template susceptible de casser le front-end ou le back-end.
Selon la documentation officielle, le composant de mise à jour présent en 3.10 permet un contrôle initial des extensions. Il reste toutefois nécessaire d’examiner chaque extension majeure utilisée pour confirmer la compatibilité.
Évaluation des extensions tierces
Cette étape commence par un inventaire précis des extensions actives et de leurs versions. Il convient de lister l’usage exact de chaque extension afin de décider d’une mise à jour, d’une suppression ou d’un remplacement.
Inventaire extensions :
- Extensions critiques utilisées pour le commerce ou la sécurité
- Plugins de performance ou de cache influençant le backend
- Constructeurs de pages comme SP Page Builder
- Solutions de sauvegarde comme Akeeba Backup
« J’ai dû remplacer un module obsolète par un champ personnalisé natif pour régler un bug »
Marc L.
Gestion des templates et overrides front-end
Ce point lie l’audit des extensions à la partie visuelle et au rendu final. Les templates basés sur Bootstrap 2 ou Protostar seront à migrer vers Cassiopeia ou adaptés avec un template enfant.
Template checklist :
- Créer un template enfant pour préserver personnalisation
- Mettre à jour les overrides dans dossier html
- Convertir les icônes Font Awesome vers la version 6
- Tester le rendu sur Cassiopeia si nécessaires
La prochaine étape décrira la finalisation post-migration, incluant vérifications SEO et sécurité. Cette préparation facilite la réinstallation et la validation des extensions une par une.
« Après la mise à jour, j’ai réinstallé chaque extension puis testé ses fonctions critiques »
Sophie R.
Finaliser l’installation et vérifier le front-end
Ce volet suit l’audit des extensions et traite des actions post-mise à jour essentiels. Il couvre la mise à jour PHP, le remplacement du fichier htaccess et les réglages de sécurité pour le backend.
Selon la documentation officielle, il est conseillé d’activer HSTS, de vider les caches et de vérifier les tâches planifiées après migration. Ces contrôles réduisent les risques de régression SEO et d’accès non autorisé.
Étape
Action
Pourquoi
Outil suggéré
Sauvegarde finale
Export fichiers et base
Moyen de restauration rapide
Akeeba Backup
Remplacer htaccess
Renommer htaccess.txt fourni
Compatibilité règles Apache
Éditeur de fichiers
Vérifier permissions
Configurer configuration.php
Éviter erreurs d’écriture
Accès SFTP
Tests fonctionnels
Parcours client et backend
Détecter régressions métier
Tests manuels et outils
Contrôles post-migration :
- Vérifier intégration Google Search Console et Analytics
- Contrôler les redirections SEO et liens cassés
- Activer l’authentification forte pour le backend
- Désactiver plugin de rétrocompatibilité lorsqu’approprié
Pour renforcer la sécurité, activez Webauthn ou une double-authentification adaptée aux utilisateurs. Enfin, planifiez des sauvegardes régulières et un cron pour les tâches planifiées.
« Un cron bien configuré a évité plusieurs dysfonctionnements automatiques sur notre site »
Antoine D.
Pour finir, testez le front-office sur différents navigateurs et activez l’outil de débogage intégré pour corriger les erreurs restantes. La dernière étape consiste à remettre le site en ligne lorsque tout est validé.
Source : « Documentation officielle pour la mise à jour vers Joomla 4 et vers Joomla 5 », Joomla.org, 23 Mai 2025.