Mise à jour de version

Introduction

Rappel : sauvegardez toujours votre site avant de le mettre à jour.

La méthode recommandée pour mettre à jour les installations de Joomla! est d'utiliser le composant Joomla Update.

Une installation standard de Joomla 4 et versions ultérieures inclut un panneau de notifications utile sur le Panneau d'administration après connexion. Vous pouvez voir d'un coup d'œil si une mise à jour est disponible et son numéro de version.

Le message de mise à jour qui apparaît dans le panneau de notifications dépend du Canal de mise à jour défini dans la page Mise à jour de Joomla : Paramètres et de la version Mineure actuelle. Lorsque Canal de mise à jour est défini sur Défaut, les mises à jour au sein de la version Majeure actuelle sont notifiées. Lorsque le Paramètre est défini sur Le prochain Joomla!, vous pouvez mettre à jour vers la dernière version actuelle, puis cliquer sur le bouton Vérifier les mises à jour pour voir si la prochaine version Majeure est disponible.

Bien que Joomla vous informe lorsqu'une mise à jour est disponible, c'est à vous d'effectuer la mise à jour. Il s'agit d'un processus simple qui devrait être effectué dès que possible pour garder le site à jour.

Accéder au composant de mise à jour

Si le panneau de notifications est affiché sur le Panneau d'administration, sélectionner le bouton x.y.z disponible - Mettre à jour maintenant ! pour accéder au composant de mise à jour.

Autrement, pour accéder au composant de mise à jour depuis le menu Administration, sélectionner Système pour y accéder via le Tableau de bord Système.

Le Tableau de bord Système comporte un Panneau de mise à jour qui inclut un lien Joomla indiquant le numéro de version de la mise à jour disponible. Sélectionner le lien Joomla pour accéder au composant de mise à jour.

Effectuer la mise à jour

Joomla! 4 et 5 fournissent une Vérification préalable à la mise à jour pour les mises à jour de versions Mineures. Cette vue du composant de mise à jour Joomla affiche les spécifications techniques du serveur sur lequel se trouve le site ainsi que les extensions du noyau et tierces qui utilisent le serveur de mise à jour, sous forme de liste.

Remarque : l'écran de Vérification préalable à la mise à jour n'est affiché que pour les versions majeures et mineures (par exemple, 4 vers 5, ou 5.2 vers 5.3). Il n'est pas affiché pour les correctifs (par exemple, 5.3.1 vers 5.3.2).

Portez une attention particulière aux résultats de la vérification et prenez les mesures nécessaires pour corriger les problèmes mis en évidence avant de procéder à la mise à jour. Il se peut que vous deviez mettre à jour, désactiver ou désinstaller des extensions incompatibles avant de mettre à jour Joomla.

Il n'est pas rare de voir des avertissements concernant les Paramètres recommandés, car ceux-ci sont souvent spécifiques au serveur et liés à l'hébergement. Il est probable qu'ils existaient déjà lors de l'installation de Joomla et il est fort probable qu'ils n'empêcheront pas la mise à jour de s'achever.

Notez le rappel qu'il est fortement recommandé de faire une sauvegarde si ce n'est pas déjà fait !

Il y a un lien sous le bouton de mise à jour. Dans la plupart des cas, vous pouvez ignorer ce lien. Il fournit une option pour téléverser manuellement les fichiers de mise à jour si votre serveur est derrière un pare-feu ou incapable de contacter les serveurs de mise à jour de Joomla.

Une fois la Vérification préalable à la mise à jour examinée et validée, sélectionner Mise à jour.

Confirmer la mise à jour

Cocher la case pour confirmer que vous avez effectué une sauvegarde et vérifié la compatibilité des extensions, puis cliquer sur Démarrer la mise à jour.

Progression de la mise à jour

Une fois la mise à jour lancée, une barre de progression apparaît pendant la mise à jour des fichiers Joomla.

Finalisation

Lorsque la barre de progression atteint 100%, un message système confirme que votre site a été mis à jour ainsi que le numéro de version. Le numéro de version sera également mis à jour dans la barre d'outils supérieure, à côté du nom du site.

Cliquer sur le bouton Retour pour revenir au composant Joomla Update où il est possible de vérifier à nouveau les mises à jour.

Vérifications après la mise à jour

Une fois la mise à jour terminée, vous devriez effectuer quelques vérifications pour vous assurer que tout s'est déroulé comme prévu, qu'aucune erreur n'est présente et qu'aucun changement ne nécessite une action supplémentaire.

Vérification du frontal

Rendez-vous sur le frontal du site web et vérifiez qu'il fonctionne et s'affiche comme avant la mise à jour. Utilisez la combinaison Maj + Recharger pour forcer votre navigateur à recharger toute modification des feuilles de style et des scripts.

Vérifications système

Dans le menu latéral, sélectionnez Système pour accéder au Tableau de bord Système. Cela vous donne un aperçu de l'état actuel de votre site Joomla.

Dans cet exemple, nous pouvons voir que depuis la mise à jour, deux éléments nécessitent une attention particulière. Ils sont marqués d'une étiquette comportant un nombre. Ce nombre indique combien d'éléments nécessitent une attention. Cliquer sur chacun d'eux permet de les corriger.

Remarque Le Tableau de bord Système effectue une vérification à chaque chargement de la page. Gardez à l'esprit que les paramètres de mise en cache du navigateur peuvent influencer ce résultat. Il est recommandé de vider le cache du navigateur lors de la vérification en utilisant Maj + Recharger.

Vérification de la base de données

Naviguez vers Système → Maintenance → Base de données. Si votre base de données est à jour, vous devriez voir un écran similaire à celui ci-dessous :

Si votre base de données n'est pas à jour, vous verrez un écran répertoriant les problèmes rencontrés, similaire à celui ci-dessous :

Dans ce cas, sélectionnez le Nom de l'extension posant problème, puis cliquez sur le bouton Mettre à jour la structure dans la barre d'outils. Joomla mettra à jour votre base de données pour corriger les problèmes répertoriés, puis réaffichera l'écran. Si la correction a réussi, l'affichage indiquera que la base de données est à jour.

Remarque : Si des erreurs persistent, assurez-vous que toutes les tables de la base de données sont déverrouillées.

Découverte Système

Dans certains cas, lors de la mise à jour vers une nouvelle version de Joomla, de nouvelles extensions principales sont ajoutées. S'il y a eu des problèmes lors de la mise à jour de la base de données, ces extensions peuvent ne pas avoir été correctement installées. Pour vérifier cela, naviguez vers Système → Découverte. Sélectionnez ensuite l'icône Découverte dans la barre d'outils. L'écran devrait s'afficher comme suit :

Si c'est le cas, vous savez que toutes les nouvelles extensions ajoutées lors de la mise à jour ont été correctement installées dans la base de données.

S'il y a des extensions non installées, elles apparaîtront de manière similaire à l'écran suivant :

Dans ce cas, cocher les cases et cliquer sur l'icône Installer dans la barre d'outils. Joomla va installer la ou les extensions puis afficher l'écran indiquant qu'aucune extension n'a été découverte. À ce stade, les nouvelles extensions ont été installées dans la base de données.

Dépannage

Si vous avez des questions, des problèmes ou des erreurs avant, pendant ou après la mise à jour, veuillez les poser sur le forum Migrating and Upgrading to Joomla! 5.x.

Si vous rencontrez des problèmes ou des erreurs pendant le processus de mise à jour, voici quelques conseils.

• Vider le cache de votre navigateur. Il se peut que des modifications aient été apportées au CSS ou au Javascript qui devront être rechargés par votre navigateur Web après une mise à jour.
• Si des messages d'erreur de base de données s'affichent après la mise à jour, veillez à consulter le lien Système → Panneau de maintenance → Base de données. Dans certains cas, si une erreur de base de données se produit, elle empêchera l'exécution de toutes les mises à jour de la base de données. Dans ce cas, vous pouvez les exécuter depuis le lien Base de données, puis utiliser la méthode Système → Installer → Découverte pour vérifier et installer toute nouvelle extension.
• Le processus de mise à jour crée ou complète un fichier journal nommé administrator/logs/joomla_update.php que vous pouvez ouvrir avec un éditeur de texte pour voir les étapes enregistrées dans le journal. Il affichera les étapes principales (téléchargement du zip, installation, exécution des instructions SQL, nettoyage), de la manière suivante :

2024-04-17T09:13:16+00:00    INFO 127.0.0.1    update    Update started by user Jimmy (139). Old version is 5.0.3.
2024-04-17T09:13:18+00:00    INFO 127.0.0.1    update    Downloading update file from ...
2024-04-17T09:13:28+00:00    INFO 127.0.0.1    update    File Joomla_5.1.0-Stable-Update_Package.zip downloaded.
2024-04-17T09:13:28+00:00    INFO 127.0.0.1    update    Starting installation of new version.
2024-04-17T09:13:40+00:00    INFO 127.0.0.1    update    Finalising installation.
2024-04-17T09:13:40+00:00    INFO 127.0.0.1    update    Start of SQL updates.
2024-04-17T09:13:40+00:00    INFO 127.0.0.1    update    The current database version (schema) is 5.0.0-2023-09-11.
... Lots of individual SQL queries
2024-04-17T09:13:41+00:00    INFO 127.0.0.1    update    End of SQL updates.
2024-04-17T09:13:41+00:00    INFO 127.0.0.1    update    Uninstalling extensions
2024-04-17T09:13:41+00:00    INFO 127.0.0.1    update    Deleting removed files and folders.
2024-04-17T09:13:44+00:00    INFO 127.0.0.1    update    Cleaning up after installation.
2024-04-17T09:13:44+00:00    INFO 127.0.0.1    update    Update to version 5.1.0 is complete.