Mettre à jour Matomo
Cette page explique comment mettre à jour Matomo vers sa dernière version. Nous vous recommandons d’utiliser la version la plus récente de Matomo et avons rendu le processus de mise à jour simple et sécurisé. Deux méthodes s’offrent à vous :
La mise à jour en un clic de Matomo (mise à jour automatique)
Vous pouvez utiliser la mise à jour en un clic pour actualiser votre version de Matomo en seulement 10 secondes, avec un simple clic sur un bouton !
Étape 1 : Définir les permissions d’écriture sur le dossier Matomo via FTP
Pour effectuer la mise à jour en un clic, le dossier de votre Matomo doit disposer des bonnes permissions sur votre serveur web afin de permettre à Matomo de télécharger le fichier, d’extraire les éléments nécessaires et d’écraser les fichiers existants.
Veuillez accorder les permissions d’écriture via votre logiciel FTP (CHMOD 0755) au dossier racine de Matomo.
Dans certains cas, la mise à jour automatique peut tout de même échouer. Essayez alors de changer le propriétaire du dossier Matomo par l’utilisateur de votre serveur web.
Vous pouvez également définir temporairement les permissions sur CHMOD 0777, mais veuillez noter que cela peut présenter des risques sur les environnements mutualisé. Il est donc important d’annuler cette modification dès que la mise à jour est terminée.
Une fois la mise à jour en un clic terminée avec succès, vous pouvez remettre votre dossier Matomo et ses fichiers en lecture seule.
Important : le dossier tmp/ doit rester accessible en écriture en permanence.
Notez que si vous utilisez la fonction de mise à jour automatique GeoIP, le dossier misc/ doit également être accessible en écriture.
Cliquez sur le message d’alerte dans Matomo
Dans Matomo, connectez-vous comme super utilisateur‧ice, puis accédez aux paramètres de Matomo (Administration) 
Lorsqu’une nouvelle version de Matomo sera disponible, une alerte s’affichera à cet endroit.
Une fois qu’une nouvelle version de Matomo est publiée, le message peut mettre jusqu’à 8 heures à apparaître sur votre Matomo.
Lisez le message et cliquez sur « Mettre à jour automatiquement »
Admirez la magie !
Faites-vous plaisir
Votre Matomo est maintenant à jour ! Pourquoi ne pas partager votre expérience avec d’autres en écrivant un article de blog, ou en profiter pour explorer de nouvelles analyses dans vos données ?
Avez-vous déjà consulté vos principaux sites référents ou trié vos pages par taux de rebond décroissant ?
Ou simplement détendez-vous un instant et profitez de la beauté de la vie !
La mise à jour manuelle en trois étapes
Si, pour une raison quelconque, la mise à jour en un clic ne fonctionne pas, vous pouvez toujours mettre à jour Matomo manuellement via FTP.
1) Sauvegardez votre fichier de configuration
Veuillez sauvegarder votre fichier de configuration Matomo. Vous pouvez le trouver à l’emplacement suivant :
config/config.ini.php
This file contains the details for your existing installation, e.g. your database sign-in information and list of enabled plugins. This file would only be needed (along with your full database backup) in case you need to restore your Matomo instance and data at a later point.
2) Remplacez les fichiers de Matomo par la dernière version
Vous pouvez télécharger la dernière version de Matomo depuis builds.matomo.org/matomo.zip. Après le téléchargement, vous pouvez extraire le fichier sur votre ordinateur.
Si vous téléversez ces fichiers par FTP sur votre serveur Matomo, veuillez vous assurer que tous les fichiers sont transférés en mode binaire.
Si vous avez un accès SSH à votre serveur, vous pouvez télécharger la dernière version et l’extraire directement depuis le serveur qui héberge Matomo :
# go into the the directory that contains your existing « matomo/ » installation
$ wget https://builds.matomo.org/matomo.zip # download latest version
$ unzip -o matomo.zip # extract it to « matomo/ » directory
$ rm matomo.zip # delete the archive
check for any obsolete files, Matomo 4.13.2+ only
$ ./console diagnostics:unexpected-files
delete any obsolete files, Matomo 4.13.2+ only
$ ./console diagnostics:unexpected-files –delete
read below for the next step
3) Mettre à jour Matomo
Rendez-vous sur votre installation Matomo dans votre navigateur web. Si la nouvelle version de Matomo nécessite des modifications de la base de données, cet écran s’affichera :
Ceci mettra à jour votre base de données afin qu’elle soit compatible avec la dernière version du code.
Veuillez faire preuve de patience : les mises à jour de la base de données (par exemple l’ajout d’un nouvel index) peuvent prendre plusieurs minutes.
Ne fermez pas votre navigateur et ne rafraîchissez pas la page pendant ce processus.
Si cette étape n’est pas effectuée correctement, votre installation de Matomo pourrait s’afficher de manière incorrecte ou ne plus fonctionner du tout.
Mise à jour de la base de données pour les serveurs Matomo à fort trafic
Pour les sites web à fort trafic, où le processus de mise à jour peut prendre de quelques minutes à plusieurs heures, il est fortement recommandé d’exécuter le processus de mise à jour de la base de données en ligne de commande. Vous pouvez déclencher la mise à jour de Matomo en exécutant dans votre terminal :
$ ./path/to/matomo/console core:update
(Si cette commande ne fonctionne pas, vous pouvez essayer : php /path/to/matomo/console core:update)
Pour les serveurs Matomo à trafic moyen et élevé, nous recommandons également de désactiver le suivi des visites et de désactiver l’interface utilisateur de Matomo pendant que vous exécutez la mise à jour en ligne de commande. Cela garantira que les mises à jour du DB Schema se terminent le plus rapidement possible et sans erreurs de lecture/écriture simultanées.
Lorsque vous activez le mode maintenance de Matomo, aucune donnée n’est enregistrée. Il existe toutefois un moyen de reconstituer les requêtes de suivi afin de ne perdre aucune donnée : en savoir plus dans cette FAQ.
Une fois la mise à jour effectuée avec succès
Une fois Matomo mis à jour avec succès vers la dernière version, il est recommandé de consuilter les paramètres de Matomo (Administration) Diagnostics > System check report et d’examiner le rapport en suivant toutes les actions recommandées. Par exemple, la vérification de l’intégrité des fichiers pourrait indiquer qu’il reste des fichiers de la version précédente qui peuvent maintenant être supprimés.
Besoin d’aide pour mettre à jour votre Matomo ?
Si vous n’êtes pas sûr‧e de pouvoir effectuer la mise à jour de Matomo par vous-même et avez besoin d’aide pour mettre à jour votre Matomo vers la dernière version, nous pouvons vous aider. Nous, à l’origine de la création de Matomo, offrons un support professionnel de qualité et vous aiderons à planifier et effectuer en douceur la mise à jour de votre Matomo et de votre base de données. Par exemple, lorsque vous avez un serveur Matomo à fort trafic, une très grande base de données, ou lorsque vous n’êtes pas certain‧e du processus de mise à jour, nous sommes là pour vous aider et rendre ce processus aussi simple que possible pour vous.