phpMyAdmin

phpMyAdmin est une application web PHP servant à administrer à distance les bases de données MySQL ou MariaDB.

Elle permet d'administrer (créer, renommer, modifier, supprimer) les éléments suivants :

• les bases de données
• les tables et leurs champs (ajout, suppression, définition du type)
• ainsi que leur contenu
• les index, les clés primaires et étrangères
• les utilisateurs des bases et leurs permissions.

phpMyAdmin permet aussi d'importer ou exporter les données dans divers formats (CSV, XML, PDF, OpenDocument, Word, Excel et LaTeX).

Pour toute information complémentaire, se référer à la documentation officielle de phpMyAdmin (en français).

Installer le paquet phpmyadmin.
Soit en ligne de commande :

sudo apt install phpmyadmin

Lors de l'installation, il vous sera posé quelques questions auxquelles il faut répondre avec soin :

• Choisir le serveur web à configurer automatiquement (utiliser les flèches du clavier ou la touche tab pour se déplacer et la barre d'espace pour sélectionner/désélectionner) :

• Créer la base de données phpmyadmin : oui

• Définir un mot de passe pour l'utilisateur MySQL phpmyadmin :

• Indiquer le mot de passe de l'utilisateur MySQL « root » tel que défini à l'installation de mysql-server :

phpMyAdmin devrait être accessible à l'adresse http://localhost/phpmyadmin.

La configuration par défaut (faite ci-dessus) lors de l'installation crée un alias qui donne accès à phpMyAdmin par un url du type : mon-site.fr/phpmyadmin et les robots des hackers le savent !
Si votre phpMyAdmin est en ligne, il peut être judicieux de renommer cet alias.
Pour le faire, il suffit : d'éditer avec les permissions administrateur le fichier /etc/phpmyadmin/apache.conf
et de remplacer

Alias /phpmyadmin /usr/share/phpmyadmin
# par quelque chose comme ci-dessous (avec accents ou pas? !)
Alias /nom-accès-personnalisé /usr/share/phpmyadmin

Recharger la conf d'apache (reload)

Il est possible de changer de thème graphique, notamment avec les versions récentes, pour cela, rendez-vous sur thèmes

Concernant les problèmes de non accessibilité de phpMyAdmin, s'assurer auparavant que, lors de l'installation du paquet phpmyadmin, le serveur web souhaité (généralement Apache) a bien été sélectionné lorsque la question a été posée :
l'interface n'est pas très claire à ce niveau et l'option Apache peut sembler sélectionnée alors qu'elle ne l'est pas. Il faut appuyer sur la barre d'espace et s'assurer d'avoir une astérisque * au niveau d'Apache.

Utilisez la commande suivante pour pouvoir répondre à nouveau aux questions :

sudo dpkg-reconfigure phpmyadmin

Avec MySQL et MariaDB, l'authentification de l'utilisateur root de MySQL se fait au moyen du plugin auth_socket, donc avec sudo.
Cette méthode ne permet pas de se connecter avec phpMyAdmin, mais il est vivement déconseillé de modifier ce comportement.

Si vous avez besoin d'un accès total à vos bases de données depuis un même compte, la solution conseillée est donc de créer un nouvel utilisateur et de lui attribuer tous les privilèges :

sudo mysql

Puis dans la console MySQL :

CREATE USER 'nom_utilisateur_choisi'@'localhost' IDENTIFIED BY 'mot_de_passe_solide';
GRANT ALL ON *.* TO 'nom_utilisateur_choisi'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
QUIT;

En remplaçant évidemment nom_utilisateur_choisi et mot_de_passe_solide dans cette requête.

juillet 2024 : une erreur de configuration du fichier etc/apache2/mods-enabled/php8.2.load empêche le démarrage d'apache2 et donc l'accès à localhost et à phpmyadmin. Ouvrez ce fichier et lisez la 3e ligne qui renvoie sur le fichier /usr/lib/apache2/modules/libphp8.2.so En fait (chez moi), ce fichier s'appelle désormais libphp8.3.so. Il faut donc corriger la ligne de ce premier fichier avec Droits de super utilisateur avec le nom correct. L'accès est rétabli.

Si des erreurs apparaissent en fin de configuration, le plus simple est de supprimer complètement (purger) phpMyAdmin et de le réinstaller.

Si le problème persiste, le forum est à votre disposition.

Pour supprimer cette application, il suffit de supprimer son paquet. La configuration de l'application sera conservée ou supprimée selon la méthode de désinstallation que vous choisirez.

• MySQL
• Mariadb
• LAMP
• PHP
• Apache2
• Nginx
• Caddy

Vous pouvez consulter les sites suivants pour obtenir un complément d'information :

• Documentation complète en français
• (en) Site officiel du projet
• (en) page phpMyAdmin sur help.ubuntu.com (page pour le moment largement obsolète)

• Adminer est une alternative presque aussi complète, mais beaucoup plus légère et simple à déployer (il n'est constitué que d'un seul fichier PHP).

• Sequeler (disponible en Flatpak sur Flathub)
• DBeaver Community¹⁾ (disponible en snap sur snapcraft et en Flatpak sur Flathub)
• Beekeeper Studio²⁾ (disponible en Flatpak sur Flathub)

Contributeurs : Guigouz, McPeter, krodelabestiole.