Tutoriel comment migrer Joomla 4.4 vers Joomla 5
MIGRATION 4.4.X VERS 5.X
Hébergement/Spécifications techniques
- Vérifiez si votre environnement d'hébergement répond aux exigences minimales.
- Vous ne pourrez pas effectuer la mise à niveau vers Joomla 5 si votre environnement serveur ne respecte pas les exigences techniques minimales.
- L'option de mise à niveau n'apparaîtra pas dans le composant de mise à jour Joomla.
- PHP 8.1
- MySQL 8.0.13
- MariaDB 10.4.x (les tests ont montré que J3, J4 et J5 sont compatibles avec MariaDB 10.4.x)
- PostgreSQL 12.0
Vous pouvez vérifier les informations système sur votre site Joomla 4 en cliquant sur Système -> Informations Système.
Contactez votre hébergeur si votre serveur ne répond pas aux exigences.
Exemple de configuration système conforme :
- MySQL 8.0.34
- PHP 8.1
- Joomla 4.4.x
Vérification de la compatibilité des extensions
Vérifiez toutes vos extensions pour leur compatibilité avec Joomla 5. Il existe plusieurs scénarios pour les extensions tierces lors de cette mise à niveau :
- L'extension peut être compatible avec J4 et J5 sans utiliser le plugin de compatibilité ascendante.
- L'extension peut être compatible avec J4 et J5 AVEC l'utilisation du plugin de compatibilité ascendante.
- L'extension peut sembler fonctionner sous J5, mais provoquer des erreurs lors de son utilisation.
- L'extension peut compromettre l'ensemble du site.
Pas de panique ! Ce n'est pas aussi grave que ça en a l'air ! Parlons d'abord du plugin de retro-compatibilité.
Le site que vous allez mettre à niveau doit répondre à toutes les exigences techniques et exécuter Joomla 4.4.x pour pouvoir être mis à niveau. Si votre site n'exécute pas encore Joomla 4.4.x, mettez à jour vers 4.4.x avant de passer à J5.
- Suivez toutes les instructions de la section Planification avant de procéder à la mise à niveau.
- Sauvegardez votre site Web .
- Mettez à jour toutes les extensions qui doivent être mises à jour.
- Désactivez ou désinstallez toutes les extensions non compatibles avec J5.
- Si vous utilisez l'ancien composant de recherche (com_search) ou tout module associé, désinstallez-les avant la mise à jour.
- Si vous utilisez Google reCAPTCHA, désactivez-le et commencez à utiliser Invisible reCAPTCHA à la place.
- Activez le débogage (Configuration globale -> onglet Système -> paramètre Système de débogage sur Oui.
- Sauvegardez à nouveau votre site Web .
- Testez votre sauvegarde pour vous assurer qu'elle est restaurée . (Oui, faites ceci. Vous vous sentirez mieux.)
- Allez dans Système -> Mise à jour -> Joomla
- Cliquez sur Options dans la barre d'outils supérieure sur le côté droit.
- Changez le canal de mise à jour en Joomla Next
- Cliquez sur Enregistrer et fermer dans la barre d'outils supérieure.
- Si votre serveur répond aux spécifications techniques, vous verrez l'écran suivant avec des liens dans la barre latérale gauche pour les paramètres requis, les paramètres recommandés et les extensions.
- Il y a de fortes chances que vos paramètres requis et vos paramètres recommandés conviennent puisque cet écran ne s'affichera pas si votre environnement ne répond pas aux exigences techniques. Les extensions peuvent ne pas convenir. Consultez la section dans Planification (ci-dessus) sur la vérification préalable à la mise à jour et pourquoi elle peut ne pas avoir de coche verte mais avoir toujours toutes les extensions compatibles. Vous avez déjà fait vos tests (n'est-ce pas ?), vous savez donc déjà s'ils sont compatibles ou non.
- Le plugin de compatibilité ascendante sera activé lors de la mise à niveau de Joomla 4.4.x vers 5.x.
- Si vous n'avez pas suivi les instructions de Planification (ci-dessus) pour l'exécution d'essai, arrêtez-vous maintenant, revenez à la section Planification et suivez les instructions. La planification est la partie la plus importante de cette mise à jour.
- Une fois que vous êtes sûr que toutes vos extensions sont compatibles avec J5 et que vous avez testé la mise à niveau et que le résultat était parfait, vous pouvez cocher le bouton Accepter les avertissements concernant les extensions potentiellement incompatibles et procéder à la mise à jour, cliquez sur OK dans le boîte de dialogue, puis cliquez sur le bouton Mettre à jour.
- Ensuite, votre site vous demandera à nouveau de confirmer que vous avez effectué une sauvegarde (que vous avez et que vous avez testé sa restauration).
- Votre site effectuera la mise à niveau vers J5.
- Une mise à niveau réussie et vous verrez votre site sous la forme Joomla 5 dans le coin supérieur droit de l'écran.
- Testez le frontend de votre site.
- Testez le backend de votre site.
- Désactivez le débogage dans l'onglet Système -> Configuration globale -> Serveur.
- Corrigez votre nouvelle recherche intelligente si nécessaire.
- Configurez votre plugin de schéma comme décrit dans la zone de planification de ce document.
- Savourez une bonne boisson et émerveillez-vous de voir à quel point vous êtes merveilleux.