Comment installer Matomo Web Analytics sur Ubuntu 18.04 LTS

Matomo (anciennement Piwik) est une application d'analyse Web gratuite et open source développée par une équipe de développeurs internationaux, qui s'exécute sur un serveur Web PHP/MySQL. Il suit les visites en ligne sur un ou plusieurs sites Web et affiche des rapports sur ces visites à des fins d'analyse. Vous pouvez le considérer comme une alternative à Google Analytics. Matomo est open source et son code est accessible au public sur Github. Certaines de ses fonctionnalités sont : Test A/B, Heatmaps, Entonnoirs, API de suivi et de rapport, Google AdWords, Facebook Ads, Bing Ads, Coût par clic (CPC), etc. Ce tutoriel vous montrera comment installer Matomo sur un système Ubuntu 18.04 LTS utilisant Nginx comme serveur Web et nous sécuriserons le site Web avec un certificat SSL Let's Encrypt.

Exigences

Pour exécuter Matomo (Piwik) sur votre système Ubuntu, vous aurez besoin de plusieurs éléments :

• Serveur Web tel qu'Apache, Nginx, IIS.
• PHP version 5.5.9 ou ultérieure avec les extensions pdo et pdo_mysql ou mysqli, gd, xml, curl et mbsting. PHP 7+ est recommandé.
• MySQL version 5.5 ou supérieure, ou la version équivalente de MariaDB. MySQL 5.7+ est recommandé.

Prérequis

• Un système d'exploitation exécutant Ubuntu 18.04.
• Un utilisateur non root avec des privilèges sudo.

Étapes initiales

Vérifiez votre version d'Ubuntu :

lsb_release -ds
# Ubuntu 18.04.1 LTS

Configurez le fuseau horaire :

sudo dpkg-reconfigure tzdata

Mettez à jour les packages de votre système d'exploitation (logiciels). Il s'agit d'une première étape importante car elle garantit que vous disposez des dernières mises à jour et correctifs de sécurité pour les packages logiciels par défaut de votre système d'exploitation :

sudo apt update && sudo apt upgrade -y

Installez certains packages essentiels nécessaires à l'administration de base du système d'exploitation Ubuntu :

sudo apt install -y curl wget vim git unzip socat

Étape 1 - Installer MySQL et créer une base de données pour Matomo

Matomo prend en charge les bases de données MySQL et MariaDB. Dans ce tutoriel, nous utiliserons MySQL comme serveur de base de données.

Installez le serveur de base de données MySQL :

sudo apt install -y mysql-server

Vérifiez la version de MySQL :

mysql --version
# mysql  Ver 14.14 Distrib 5.7.24, for Linux (x86_64) using  EditLine wrapper

Exécutez l'mysql_secure installation script pour améliorer la sécurité MySQL et définir le mot de passe pour MySQL root utilisateur :

sudo mysql_secure_installation

Répondez à chacune des questions :

Would you like to setup VALIDATE PASSWORD plugin? N
New password: your_secure_password
Re-enter new password: your_secure_password
Remove anonymous users? [Y/n] Y
Disallow root login remotely? [Y/n] Y
Remove test database and access to it? [Y/n] Y
Reload privilege tables now? [Y/n] Y

Connectez-vous au shell MySQL en tant qu'utilisateur root :

sudo mysql -u root -p
# Enter password

Créez une base de données MySQL vide et un utilisateur pour Matomo et mémorisez les informations d'identification :

mysql> CREATE DATABASE dbname;
mysql> GRANT ALL ON dbname.* TO 'username' IDENTIFIED BY 'password';
mysql> FLUSH PRIVILEGES;

Quitter MySQL :

mysql> exit

Remplacez dbname , username et password avec vos propres noms.

Étape 2 - Installer PHP et les extensions PHP nécessaires

Installez PHP, ainsi que les extensions PHP nécessaires :

sudo apt install -y php7.2 php7.2-cli php7.2-fpm php7.2-common php7.2-curl php7.2-gd php7.2-xml php7.2-mbstring php7.2-mysql

Vérifier la version PHP :

php --version

# PHP 7.2.10-0ubuntu0.18.04.1 (cli) (built: Sep 13 2018 13:45:02) ( NTS )
# Copyright (c) 1997-2018 The PHP Group
# Zend Engine v3.2.0, Copyright (c) 1998-2018 Zend Technologies
#     with Zend OPcache v7.2.10-0ubuntu0.18.04.1, Copyright (c) 1999-2018, by Zend Technologies

Le service PHP-FPM est automatiquement démarré et activé au redémarrage sur le système Ubuntu 18.04, il n'est donc pas nécessaire de le démarrer et de l'activer manuellement. Nous pouvons passer à l'étape suivante, qui consiste à obtenir des certificats SSL gratuits auprès de Let's Encrypt CA.

Étape 3 – Installer acme.sh client et obtenir le certificat Let's Encrypt (facultatif )

Sécuriser votre site Web avec HTTPS n'est pas nécessaire, mais c'est une bonne pratique pour sécuriser le trafic de votre site. Afin d'obtenir un certificat TLS de Let's Encrypt, nous utiliserons le client Acme.sh. Acme.sh est un logiciel shell Unix pur permettant d'obtenir des certificats TLS de Let's Encrypt sans aucune dépendance.

Téléchargez et installez Acme.sh :

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh 
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]
cd ~

Vérifiez la version d'Acme.sh :

/etc/letsencrypt/acme.sh --version
# v2.8.0

Obtenir RSA et ECC/ECDSA certificats pour votre domaine/nom d'hôte :


# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength 2048
# ECDSA
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d example.com --keylength ec-256

Après avoir exécuté les commandes ci-dessus, vos certificats et les clés sera dans :

• Pour RSA  : /etc/letsencrypt/example.com répertoire.
• Pour ECC/ECDSA  : /etc/letsencrypt/example.com_ecc répertoire.

Étape 3 - Installer NGINX et configurer NGINX pour Matomo

Matomo peut fonctionner correctement avec de nombreux logiciels de serveur Web populaires. Dans ce tutoriel, nous avons sélectionné Nginx.

Téléchargez et installez la dernière version principale de Nginx à partir du référentiel Ubuntu :

sudo apt install -y nginx

Vérifiez la version de Nginx :

sudo nginx -v
# nginx version: nginx/1.14.0

Configurez Nginx pour Matomo en exécutant :

sudo vim /etc/nginx/sites-available/matomo.conf

Et remplissez le fichier avec la configuration suivante :

server {

  listen [::]:443 ssl http2;
  listen 443 ssl http2;
  listen [::]:80;
  listen 80;

  server_name example.com;
  root /var/www/matomo/;
  index index.php;

  ssl_certificate /etc/letsencrypt/example.com/fullchain.cer; 
  ssl_certificate_key /etc/letsencrypt/example.com/example.com.key; 
  ssl_certificate /etc/letsencrypt/example.com_ecc/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/example.com_ecc/example.com.key;

  location ~ ^/(index|matomo|piwik|js/index).php {
    include snippets/fastcgi-php.conf;
    fastcgi_param HTTP_PROXY ""; 
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock; 
  }
  
  location = /plugins/HeatmapSessionRecording/configs.php {
    include snippets/fastcgi-php.conf;
    fastcgi_param HTTP_PROXY "";
    fastcgi_pass unix:/var/run/php/php7.2-fpm.sock;
  }

  location ~* ^.+\.php$ {
    deny all;
    return 403;
  }

  location / {
    try_files $uri $uri/ =404;
  }
  
  location ~ /(config|tmp|core|lang) {
    deny all;
    return 403;
  }

  location ~ \.(gif|ico|jpg|png|svg|js|css|htm|html|mp3|mp4|wav|ogg|avi|ttf|eot|woff|woff2|json)$ {
    allow all;
  }

  location ~ /(libs|vendor|plugins|misc/user) {
    deny all;
    return 403;
  }

}

REMARQUE  : Pour une configuration Nginx complète et prête pour la production pour Matomo, visitez https://github.com/matomo-org/matomo-nginx.

Activez le nouveau matomo.conf configuration en liant le fichier au sites-enabled répertoire.

sudo ln -s /etc/nginx/sites-available/matomo.conf /etc/nginx/sites-enabled

Vérifiez la configuration de Nginx pour les erreurs de syntaxe :

sudo nginx -t

Recharger le service Nginx :

sudo systemctl reload nginx.service

Étape 4 - Installer Matomo Analytics

Créer /var/www répertoire :

sudo mkdir -p /var/www/

Accédez à /var/www répertoire :

cd /var/www/

Téléchargez la dernière version de Matomo via wget et décompressez-la :

sudo wget https://builds.matomo.org/matomo.zip && sudo unzip matomo.zip

Supprimer le matomo.zip téléchargé fichier :

sudo rm matomo.zip

Changer le propriétaire du /var/www/matomo répertoire vers www-data  utilisateur:

sudo chown -R www-data:www-data /var/www/matomo

Étape 5 - Terminez la configuration de Matomo Analytics

Ouvrez votre site dans un navigateur Web et suivez l'assistant d'installation Web de Matomo.

Tout d'abord, le message de bienvenue de Matomo devrait apparaître. Cliquez sur "Suivant" bouton :

Après, vous verrez une "vérification du système" page. Si quelque chose manque, vous verrez un avertissement. Si tout est marqué d'une coche verte, cliquez sur "Suivant" bouton pour passer à l'étape suivante :

Ensuite, remplissez les détails de la base de données et cliquez sur "Suivant" bouton :

Si tout s'est bien passé avec la configuration de la base de données, vous devriez voir " Tables créées avec succès !" messages :

Créez un compte super utilisateur Matomo et cliquez sur "Suivant" bouton :

Ensuite, configurez le premier site Web que vous souhaitez suivre et analyser avec Matomo. Plus tard, vous pourrez ajouter d'autres sites à suivre avec Matomo :

Ensuite, vous recevrez le code de suivi JavaScript pour votre site que vous devez ajouter pour commencer le suivi.

Ensuite, vous devriez voir que l'installation de Matomo est terminée.

Toutes nos félicitations! Votre installation Matomo est terminée.

Liens

• https://matomo.org/
• https://github.com/matomo-org/matomo
• https://github.com/matomo-org/matomo-nginx