Installation de phpMyAdmin sur Ubuntu 24.04

Ce tutoriel existe pour ces versions d'OS

Ubuntu 24.04 (Noble Numbat)
Ubuntu 22.04 (Jammy Méduses)
Ubuntu 18.04 (Castor Bionic)

Sur cette page

Conditions préalables
Configuration de l'utilisateur MySQL/MariaDB
Installer phpMyAdmin via le référentiel Ubuntu
Sécuriser l'installation de phpMyAdmin
Tester votre installation phpMyAdmin

phpMyAdmin est un outil gratuit et open source pour gérer et administrer les serveurs MySQL. Il vous permet de gérer les données MySQL à partir d'un navigateur Web et vous pouvez gérer des bases de données, des tables, des colonnes, des index, des relations, des utilisateurs, des autorisations, etc., à partir d'une seule interface utilisateur de tableau de bord sur votre navigateur Web.

Avec phpMyAdmin, vous pouvez importer et exporter des données vers le serveur MySQL. Vous pouvez importer des données CSV et SQL sur votre MySQL et également exporter vos données vers plusieurs formats tels que CSV, SQL, XML, Latex, XML, PDF et OpenDocument texte et feuille de calcul.

Ce tutoriel vous montrera comment installer phpMyAdmin sur Ubuntu 24.04. Vous installerez phpMyAdmin puis le sécuriserez via le module Apache basic_auth.

Conditions préalables

Avant d'aller plus loin, vérifiez que vous disposez des éléments suivants :

Un serveur Ubuntu 24.04.
Un utilisateur non root avec des privilèges d'administrateur.
Une pile LAMP (Linux, Apache, MySQL/MariaDB et PHP) a été installée.

Configuration de l'utilisateur MySQL/MariaDB

Avant d'installer phpMyAdmin, créons un utilisateur MySQL/MariaDB dédié pour gérer les bases de données via phpMyAdmin. Cet utilisateur aura les privilèges d'accéder à toutes les bases de données sur le serveur MySQL/MariaDB, alors assurez-vous d'utiliser un mot de passe fort.

Connectez-vous à votre serveur MySQL/MariaDB avec la commande 'mysql' suivante. Tapez votre mot de passe root MySQL/MariaDB lorsque vous y êtes invité.

sudo mysql -u root -p

Une fois connecté, exécutez les requêtes suivantes pour créer un nouvel utilisateur MySQL/MariaDB. Dans ce cas, vous créerez un utilisateur 'newuser' avec le mot de passe 'mystrongpassword'. Cet utilisateur sera utilisé pour gérer les bases de données via phpMyAdmin.

CREATE USER newuser@localhost IDENTIFIED BY 'mystrongpassword';
GRANT ALL PRIVILEGES ON *.* TO newuser@localhost;
FLUSH PRIVILEGES;

Vérifiez maintenant l'utilisateur 'newuser' avec la requête suivante. Assurez-vous que l'utilisateur 'newuser' peut accéder à toutes les bases de données '*.*' de votre serveur MySQL/MariaDB.

SHOW GRANTS FOR newuser@localhost;

Tapez quit pour quitter lorsque vous avez terminé.

Installer phpMyAdmin via le référentiel Ubuntu

Sur Ubuntu, phpMyAdmin peut être installé de deux manières, via le référentiel officiel Ubuntu et manuellement à partir du code source. Dans cette section, vous installerez phpMyAdmin via le référentiel Ubuntu, ce qui nécessite l'installation de la pile LAMP (Linux, Apache, MySQL/MariaDB).

Tout d’abord, mettez à jour l’index de votre package Ubuntu avec la commande suivante.

sudo apt update

Vérifiez le package phpmyadmin avec la commande 'apt info' suivante.

sudo apt info phpmyadmin

Comme vous pouvez le voir ci-dessous, le phpMyAdmin 5.2.1 est disponible sur l'univers/dépôt web Ubuntu. le package phpMyAdmin nécessitait les packages php-mysql et dbconfig-common pour l'installation.

Installez maintenant phpMyAdmin sur votre serveur Ubuntu avec la commande « apt install » suivante. Tapez Y pour confirmer l’installation.

sudo apt install phpmyadmin

Sélectionnez le serveur Web par défaut « apache2 », puis OK.

Sélectionnez Oui pour confirmer la base de données pour phpMyAdmin via dbconfig-common.

Saisissez maintenant le nouveau mot de passe pour l'utilisateur phpMyAdmin et répétez le mot de passe.

Répétez votre mot de passe :

Une fois l'installation terminée, votre installation de phpMyAdmin devrait être disponible à l'adresse :

/etc/phpmyadmin/ : Il s'agit du répertoire de configuration principal de phpMyAdmin.
/usr/share/phpmyadmin : c'est ici que le code source de phpMyAdmin est stocké.

Enfin, ouvrez votre navigateur Web et visitez http://192.168.5.30/phpmyadmin. Si votre installation réussit, la page de connexion phpMyAdmin vous sera présentée.

Connectez-vous avec le nouvel utilisateur MySQL/MariaDB que vous avez créé, puis cliquez sur Connexion pour confirmer.

Si votre authentification réussit, vous devriez obtenir le tableau de bord phpMyAdmin comme celui-ci :

Sécuriser l'installation de phpMyAdmin

Maintenant que phpMyAdmin est installé, vous allez sécuriser votre phpMyAdmin en modifiant le chemin d'installation par défaut et en implémentant le module Apache basic_auth. Cela ajoutera une nouvelle authentification à votre phpMyAdmin,

Tout d’abord, activez le module de réécriture pour le serveur Web Apache avec la commande suivante.

sudo a2enmod rewrite

Ouvrez l'extrait Apache par défaut pour phpMyAdmin '/etc/phpmyadmin/apache.conf' à l'aide de l'éditeur nano suivant.

sudo nano /etc/phpmyadmin/apache.conf

En haut de la ligne, modifiez le chemin d’installation de phpMyAdmin. Dans ce cas, le chemin de phpMyAdmin sera remplacé par « /padm ».

Alias /padm /usr/share/phpmyadmin

Ajoutez l'option 'AllowOverride All' à la directive phpMyAdmin '...'. Cela vous permet de remplacer cette configuration de directive via le fichier .htaccess.

<Directory /usr/share/phpmyadmin>
 ...
 ...
 AllowOverride All
...
...
<Directory>

une fois terminé, enregistrez le fichier et quittez l'éditeur.

Créez maintenant un nouveau fichier .htaccess dans le répertoire phpMyAdmin '/usr/share/phpmyadmin/' avec l'éditeur nano suivant.

sudo nano /usr/share/phpmyadmin/.htaccess

Insérez la configuration suivante dans le fichier. Avec cela, vous sécuriserez la directive phpMyAdmin via le module Apache basic_auth.

AuthType Basic
AuthName "Restricted Files"
AuthUserFile /etc/phpmyadmin/.htpasswd
Require valid-user

Enregistrez le fichier et quittez l'éditeur lorsque vous avez terminé.

Ensuite, exécutez la commande suivante pour générer un nouveau fichier de mot de passe '/etc/phpmyadmin/.htpasswd' pour l'authentification de base. Dans cet exemple, vous allez créer un nouveau premier utilisateur « padm ». Ensuite, saisissez votre mot de passe et répétez lorsque vous y êtes invité.

sudo htpasswd -c /etc/phpmyadmin/.htpasswd padm

Exécutez maintenant la commande suivante pour vérifier votre configuration Apache. Assurez-vous d'avoir une syntaxe appropriée et vous obtiendrez le résultat « La syntaxe est OK ».

sudo apachectl configtest

Enfin, exécutez la commande ci-dessous pour redémarrer le serveur Web Apache et appliquer votre nouvelle configuration Apache.

sudo systemctl restart apache2

Tester votre installation phpMyAdmin

Ouvrez votre navigateur Web et visitez votre installation phpMyAdmin avec le nouveau chemin, tel que http://192.168.5.30/padm. Si votre configuration réussit, vous serez invité à vous authentifier par mot de passe à partir du module Apache basic_auth.

Saisissez votre utilisateur et votre mot de passe et cliquez sur Connexion.

Si l'authentification réussit, vous verrez la page de connexion phpMyAdmin. Sinon, vous verrez la page Non autorisé.

Connectez-vous à phpMyAdmin avec votre utilisateur et votre mot de passe MySQL/MariaDB, puis cliquez sur Connexion pour confirmer.

Vous verrez maintenant que phpMyAdmin s'exécute sur le chemin personnalisé '/padm'.

Vous avez maintenant terminé l'installation de phpMyAdmin sur le serveur Ubuntu 24.04 et sécurisé phpMyAdmin en modifiant l'installation par défaut et en implémentant le module Apache basic-auth, qui ajoute une nouvelle authentification avant d'accéder à la page de connexion de phpMyAdmin.

Cette installation vous permet d'accéder rapidement à phpMyAdmin depuis n'importe quel hôte virtuel ou nom de domaine. Ainsi, si HTTPS est activé sur votre nom de domaine, vous pouvez également accéder à phpMyAdmin via HTTPS sécurisé.