Chaque site KapsuleHost disposant d'une base de données bénéficie d'un accès via navigateur à celle-ci grâce à phpMyAdmin, ouvert en authentification unique de sorte qu'il n'y a pas de second mot de passe à retenir. Ce guide explique comment l'ouvrir, lire vos informations de connexion, les opérations qu'il vaut la peine d'y effectuer, et les deux tâches liées à la base de données que vous ne devriez jamais faire dans phpMyAdmin sur un site WordPress.
Ouvrir phpMyAdmin
- Connectez-vous à KPanel et cliquez sur Sites web dans la barre latérale gauche.
- Cliquez sur votre site.
- Dans le menu propre au site, ouvrez Base de données.
- Cliquez sur Ouvrir phpMyAdmin.
phpMyAdmin s'ouvre dans un nouvel onglet, déjà connecté et pointé vers la base de données de votre site. Il n'y a pas de formulaire de connexion ni d'identifiant distinct à conserver.
Si la page indique qu'aucune base de données n'est provisionnée pour ce type de site, c'est normal. Les sites HTML statiques et certains types d'applications sont créés sans base de données. Les types de sites qui en utilisent une, y compris WordPress et WooCommerce, en possèdent toujours une.
Vos informations de connexion
Le même écran affiche les identifiants utilisés par votre application, chacun accompagné d'un bouton de copie et le mot de passe masqué derrière un contrôle d'affichage :
| Champ | Valeur |
|---|---|
| Hôte | 127.0.0.1 |
| Port | 3306 |
| Base de données | Le nom de votre base de données |
| Nom d'utilisateur | Votre utilisateur de base de données |
| Mot de passe | Masqué jusqu'à ce que vous cliquiez sur afficher |
Ce sont les valeurs qui doivent figurer dans wp-config.php, dans un fichier .env, ou dans la configuration de base de données de n'importe quel framework.
127.0.0.1 signifie « ce serveur ». Il n'est pas accessible depuis votre ordinateur portable, et aucune configuration de pare-feu n'y changera rien : la base de données n'écoute tout simplement pas sur une adresse publique, par conception. Pour connecter un client de bureau tel que TablePlus ou Sequel Ace, passez par un tunnel SSH. Voir Connexion à votre base de données via un tunnel SSH.
À quoi l'utiliser
phpMyAdmin se révèle utile pour un ensemble précis de tâches :
- Lire des données. Confirmer ce qu'une extension a réellement enregistré, vérifier si une ligne existe, compter des enregistrements.
- Importer une base de données lors d'une migration ou d'une restauration.
- Exporter une base de données, soit comme copie de sécurité supplémentaire, soit pour la remettre à un développeur.
- Réparer une valeur unique défectueuse, comme un
siteurlmal saisi qui vous bloque désormais l'accès à wp-admin. - Diagnostiquer la taille. Trier les tables par taille montre immédiatement quand une table de journaux ou de données temporaires a pris des proportions incontrôlées.
Importer une base de données
- Ouvrez phpMyAdmin depuis l'onglet Database.
- Cliquez sur le nom de votre base de données dans le panneau de gauche.
- Cliquez sur Import en haut.
- Choisissez le fichier
.sqlet cliquez sur Go.
Une importation remplace les tables correspondantes. Elle ne fusionne pas les données.
Importer par-dessus une base de données active est destructeur et immédiat. Chaque ligne d'une table correspondante est remplacée par ce qui se trouve dans le fichier, et il n'y a pas d'annulation possible dans phpMyAdmin. Faites d'abord une sauvegarde depuis la page Sauvegardes du site : Effectuer une sauvegarde.
Pour un volumineux fichier d'export, compressez-le d'abord en .sql.gz, ce que phpMyAdmin accepte et qui ramène généralement le fichier sous la limite de téléversement. S'il est encore trop volumineux, divisez-le en plusieurs fichiers par table, ou ouvrez un ticket et nous l'importerons pour vous côté serveur.
Exporter une base de données
- Cliquez sur le nom de votre base de données dans le panneau de gauche.
- Cliquez sur Export.
- Quick avec le format SQL convient pour une copie simple. Choisissez Custom si vous avez besoin de tables particulières, ou si vous souhaitez une sortie compressée en gzip.
- Cliquez sur Go.
Un export phpMyAdmin est une copie supplémentaire utile, pas une stratégie de sauvegarde. Il capture uniquement la base de données, pas vos fichiers, et il reste là où vous l'avez enregistré. Votre site est sauvegardé automatiquement chaque jour avec les deux éléments ensemble, et vous pouvez également en faire une manuellement à tout moment : Effectuer une sauvegarde.
Deux choses à ne pas faire ici
Ne pas effectuer de recherche et remplacement avec du SQL
WordPress stocke les réglages d'extensions et de thèmes sous forme de chaînes sérialisées PHP, qui enregistrent la longueur de chaque valeur qu'elles contiennent. Une requête REPLACE() modifie le texte sans modifier la longueur enregistrée, de sorte que PHP ne peut plus lire l'option et celle-ci revient silencieusement à vide. Les réglages de thème disparaissent, les diaporamas se vident, les licences se désactivent.
Utilisez la carte Rechercher et remplacer dans l'onglet WordPress du site, qui gère correctement la sérialisation et effectue d'abord une sauvegarde. Explication complète : Effectuer une recherche et un remplacement.
Ne pas réinitialiser un mot de passe en modifiant wp_users
D'anciens guides vous indiquent de définir user_pass en utilisant la fonction MD5 depuis le menu déroulant de phpMyAdmin. Le WordPress moderne n'utilise plus de hachages MD5, et une erreur à cette étape bloque le compte au lieu de le réinitialiser.
KPanel dispose d'outils appropriés pour cela dans l'onglet WordPress du site, puis Users : connectez-vous directement avec Login as, envoyez un e-mail de réinitialisation, ou copiez un lien de réinitialisation à vous envoyer vous-même. Voir Réinitialiser un mot de passe administrateur WordPress perdu.
Outils de base de données WordPress dans KPanel
Pour les tâches courantes liées à la base de données WordPress, l'onglet WordPress, puis la section Base de données, sont plus sûrs et plus rapides que phpMyAdmin. Ils vous donnent un aperçu instantané de la taille des tables, l'optimisation et la réparation avec sauvegarde automatique préalable, la conversion d'anciennes tables vers un moteur de stockage moderne, et un nettoyage en un clic des révisions d'articles, des brouillons automatiques, des données temporaires expirées et des éléments mis à la corbeille. La recherche et remplacement se trouve juste à côté, dans Actions rapides.
Recourez à phpMyAdmin lorsque vous devez consulter des lignes brutes. Recourez à la section Database lorsque vous devez modifier quelque chose.
Dépannage
phpMyAdmin ne s'ouvre pas. Le bouton nécessite un accès en écriture au site. Si le rôle de votre compte KapsuleHost est en lecture seule, demandez à un propriétaire de compte. Si vous avez un accès en écriture et que cela échoue toujours, le site est peut-être encore en cours de provisionnement : vérifiez la pastille de statut en haut du site.
Je ne peux pas me connecter depuis mon ordinateur portable avec les informations de l'onglet Database. C'est correct, et voulu. La base de données n'est pas exposée publiquement. Utilisez un tunnel SSH : Connexion à votre base de données via un tunnel SSH.
L'importation s'arrête sans message d'erreur. C'est presque toujours lié à la taille du fichier. Compressez-le en gzip ou divisez-le.
J'ai modifié une valeur et le site s'est cassé. Restaurez à partir de la sauvegarde la plus récente : Restaurer à partir d'une sauvegarde. C'est pourquoi la sauvegarde vient en premier.
Les tables ont pris des proportions énormes. Triez par taille dans phpMyAdmin pour trouver le coupable, puis nettoyez depuis l'onglet WordPress, puis la section Base de données, plutôt que de supprimer des lignes manuellement.