Migrer Joomla : checklist (versions, extensions, tests, retour arrière)
Migrer Joomla (3→4 ou 4→5) n’est pas un simple clic : le risque vient surtout des templates et des extensions. La bonne approche, c’est une migration prévisible : inventaire, préproduction, sauvegardes vérifiées, puis une batterie de tests avant de basculer.
Si vous partez de zéro, commencez plutôt par l’installation propre : Installer Joomla avec Docker Compose (prod).
1) Définir le périmètre : de quelle version à quelle version ?
Avant d’ouvrir le gestionnaire de mise à jour, clarifiez :
- Version actuelle de Joomla + PHP + base de données
- Version cible (ex : 3.10→4.x, ou 4.4→5.x)
- Vos contraintes : maintenance courte, e-commerce, multilingue, connecteurs externes
Bonne pratique : mettez d’abord votre site au dernier patch de la branche actuelle (ex : terminer en 3.10.x avant le saut majeur). Ça réduit les surprises côté extensions et schémas de base.
Pour cadrer l’hébergement et éviter un environnement “différent” entre dev et prod, gardez une base claire : Héberger Joomla en production sur adgents.cloud.
2) Inventaire template + extensions (le point critique)
La majorité des échecs vient de là. Faites un inventaire :
- template actif + overrides
- extensions : sécurité, SEO, formulaires, cache, sauvegardes, paiement, analytics
- plugins système (souvent oubliés)
Pour chaque extension :
- compatible avec la version cible ?
- alternative si abandon du mainteneur ?
- impact si désactivation temporaire ?
Astuce pragmatique : les sujets sécurité reviennent après chaque migration ; profitez-en pour auditer : Sécuriser Joomla (hardening, WAF, sauvegardes).
3) Monter une préproduction identique (pas “à peu près”)
Votre préproduction doit reproduire :
- même version PHP
- même moteur/version de base de données
- mêmes variables serveur (limites mémoire, taille upload, timeout)
- mêmes règles reverse proxy/HTTPS
Si vous utilisez Docker, c’est plus simple de garder un environnement identique. Vous pouvez repartir de l’existant : Installer Joomla avec Docker Compose (prod) et dupliquer l’environnement sur un sous-domaine.
4) Sauvegarder ET tester la restauration
Avant migration, faites une sauvegarde complète :
- fichiers (code + médias)
- base de données
- configuration (variables, secrets, règles proxy)
Puis faites un test de restauration sur une instance dédiée. L’objectif n’est pas d’avoir “un zip”, mais d’être certain de revenir en arrière rapidement.
Sur adgents.cloud, vous pouvez activer des backups automatiques (jusqu’à 1/h) avec une rétention longue. Ça sécurise la fenêtre de migration : adgents.cloud — backups & rétention.
5) Nettoyage avant la migration (gagne du temps)
Avant de migrer :
- supprimez les extensions inutilisées
- videz la corbeille (contenus, catégories)
- mettez à jour toutes les extensions encore nécessaires
- vérifiez les erreurs PHP dans les logs
Ce nettoyage évite de traîner des composants morts qui bloquent l’upgrade. Et c’est le bon moment pour traiter la performance : Joomla lent : optimiser performances (cache, images, PHP, DB).
6) Exécuter la migration en préproduction
Procédez sur préproduction :
- désactivez temporairement ce qui n’est pas compatible
- lancez l’upgrade
- validez que le back-office fonctionne (gestion contenus, menus, utilisateurs)
- corrigez les extensions une à une (mise à jour, remplacement, suppression)
Vidéo (FR) utile avant de vous lancer : 
7) Batterie de tests post-migration (à faire systématiquement)
Après l’upgrade, testez au minimum :
- front : pages clés, recherche, menus, multilingue
- formulaires (contact, devis) + réception des emails
- performances (TTFB, cache, compression)
- SEO : robots.txt, sitemap, canonical, redirections, 404
- comptes : login, reset mot de passe
Pour les redirections et la surface d’attaque, gardez un focus sécurité : Sécuriser Joomla (guide 2026).
8) Préparer le plan de retour arrière (avant le go-live)
Même si tout marche en préproduction, un aléa reste possible en production (DNS, email, cache proxy, trafic). Préparez :
- une fenêtre de maintenance
- un gel du contenu (publis, commentaires)
- une sauvegarde “juste avant”
- une procédure claire de restauration
Si vous hébergez sur adgents.cloud, vous pouvez garder une instance “ancienne” prête à reprendre le trafic pendant la bascule, et redimensionner CPU/RAM si la charge monte. Détails : Héberger Joomla sur adgents.cloud.
9) Passage en production : déroulé simple
Quand la préproduction est validée :
- sauvegarde finale
- exécution des mêmes étapes sur prod
- tests rapides (pages clés + formulaires + login)
- surveillance logs + temps de réponse
Vous voulez un cadre propre (staging, backups, stop/start, scaling) sans refaire toute l’infra ? Essayez adgents.cloud : déploiement en 1 clic et facturation à l’heure.
