Installation de phpMyAdmin sur Ubuntu 24.04

Ce tutoriel existe pour ces versions de système d'exploitation.

Ubuntu 24.04 (Noble Numbat)
Ubuntu 22.04 (Méduse Jammy)
Ubuntu 18.04 (Castor Bionique)

Sur cette page

Conditions préalables
Configuration d'un utilisateur MySQL/MariaDB
Installation de phpMyAdmin via le dépôt Ubuntu
Sécuriser l'installation de phpMyAdmin
Tester votre installation de phpMyAdmin

phpMyAdmin est un outil gratuit et open-source pour gérer et administrer des serveurs MySQL. Il vous permet de gérer des 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 permissions, etc., à partir d'une interface unique 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 dans votre MySQL et également exporter vos données dans plusieurs formats tels que CSV, SQL, XML, Latex, PDF et texte et tableur OpenDocument.

Ce tutoriel vous montrera comment installer phpMyAdmin sur Ubuntu 24.04. Vous allez installer phpMyAdmin puis le sécuriser via le module basic_auth d'Apache.

Conditions préalables

Avant d'aller plus loin, confirmez que vous avez ce qui suit :

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 d'un 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 des privilèges pour 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 allez créer 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 '*.*' sur votre serveur MySQL/MariaDB.

SHOW GRANTS FOR newuser@localhost;

Tapez quit pour quitter quand vous avez terminé.

Installation de phpMyAdmin via le dépôt Ubuntu

Sur Ubuntu, phpMyAdmin peut être installé de deux manières, via le dépôt officiel d'Ubuntu et manuellement à partir du code source. Dans cette section, vous installerez phpMyAdmin via le dépôt Ubuntu, ce qui nécessite que la pile LAMP (Linux, Apache, MySQL/MariaDB) soit installée.

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

sudo apt update

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

sudo apt info phpmyadmin

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

Maintenant, installez 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.

Maintenant, saisissez 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/: C'est le répertoire principal de configuration pour 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 est réussie, vous verrez la page de connexion de phpMyAdmin.

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

Si votre authentification est réussie, vous devriez obtenir le tableau de bord phpMyAdmin comme suit :

Sécuriser l'installation de phpMyAdmin

Maintenant que vous avez installé phpMyAdmin, vous allez sécuriser votre phpMyAdmin en changeant le chemin d'installation par défaut et en mettant en œuvre le module basic_auth d'Apache. 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 le extrait Apache par défaut pour phpMyAdmin '<strong>/etc/phpmyadmin/apache.conf</strong>' en utilisant 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 changé en '<strong>/padm</strong>'.

Alias /padm /usr/share/phpmyadmin

Ajoutez l'option 'AllowOverride All' à la directive phpMyAdmin '<Directory /usr/share/phpmyadmin>...<Directory>'. Cela vous permet de remplacer cette configuration de directive via le fichier .htaccess.

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

Lorsque vous avez 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 basic_auth d'Apache.

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

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

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

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

Maintenant, exécutez la commande suivante pour vérifier votre configuration Apache. Assurez-vous d'avoir une syntaxe correcte et vous recevrez la sortie '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 de 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 est réussie, vous serez invité à entrer un mot de passe pour l'authentification du module basic_auth d'Apache.

Entrez votre nom d'utilisateur et votre mot de passe, puis cliquez sur Se connecter.

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

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

Maintenant, vous verrez que phpMyAdmin fonctionne 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 mettant en œuvre le module d'authentification de base d'Apache, 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é.