Documentation ServBay : Gestion des bases de données avec Adminer

Vue d'ensemble

ServBay est un environnement de développement Web local puissant, conçu spécifiquement pour macOS. Il intègre plusieurs serveurs web, runtimes de langages de programmation et systèmes de base de données. Pour simplifier la gestion de ces bases de données intégrées, ServBay préinstalle et configure Adminer, un outil de gestion de base de données à la fois puissant et léger. Ce document vous guide sur la manière d’utiliser Adminer pour vous connecter et gérer les bases de données incluses dans ServBay.

Qu'est-ce qu'Adminer ?

Adminer est un outil de gestion de base de données développé en PHP, tenant dans un seul fichier. Il prend en charge de nombreux systèmes de base de données, tels que MySQL, MariaDB, PostgreSQL, SQLite, MongoDB, et plus encore. Comparé à d'autres clients de gestion de base de données plus volumineux, Adminer offre plusieurs avantages remarquables :

1. Léger et déploiement en un seul fichier : Adminer tient dans un unique fichier PHP, aucune installation complexe n’est requise et il est simple d’utilisation. Il est déjà intégré à ServBay, prêt à l'emploi dès l’installation.
2. Prise en charge multi-bases de données : Grâce à une interface unifiée, vous pouvez vous connecter et gérer différents types de bases de données, évitant ainsi l'installation et la prise en main de multiples outils distincts.
3. Interface utilisateur épurée et intuitive : Son interface claire et facile à naviguer facilite la prise en main, même pour un utilisateur débutant.
4. Fonctionnalités complètes : Adminer propose l’essentiel des opérations courantes : créer, modifier, supprimer des bases, tables, index, utilisateurs, exécuter des requêtes SQL, importer/exporter des données, etc.

Pour les développeurs travaillant en local avec ServBay, Adminer offre une solution de gestion de base de données simple, pratique et efficace.

Accéder à Adminer

Une fois ServBay lancé, Adminer s’exécute automatiquement et devient accessible via le serveur web intégré. Vous pouvez y accéder en utilisant le nom de domaine local par défaut de ServBay suivi du nom du fichier Adminer :

https://servbay.host/adminer.php

Assurez-vous que l’application ServBay est en cours d’exécution, et que les serveurs web concernés (Caddy ou Nginx) ainsi que le service de base de données désiré sont démarrés.

Se connecter à une base de données dans ServBay

L’interface de connexion d’Adminer est très intuitive. Il vous suffit de choisir le type de base de données et de saisir l’adresse du serveur, le nom d’utilisateur, le mot de passe et, pour certains types de base de données, le nom de la base. ServBay génère pour chaque base intégrée un nom d’utilisateur et un mot de passe par défaut, consultables sous l’onglet « Base de données » de l’application ServBay.

Connexion à MariaDB / MySQL

ServBay intègre généralement MariaDB ou MySQL par défaut. Dans Adminer, sélectionnez habituellement le type "MySQL" pour la connexion.

1. Ouvrez votre navigateur et rendez-vous sur l’URL Adminer (https://servbay.host/adminer.php).
2. Sur l’écran de connexion, sélectionnez MySQL dans le menu déroulant Système.
3. Saisissez les informations de connexion :
   • Serveur : Entrez localhost ou utilisez le chemin Unix Socket fourni par ServBay /Applications/ServBay/tmp/mysql.sock. La connexion via Socket est généralement plus performante.
   • Nom d'utilisateur : Consultez l’utilisateur MariaDB/MySQL via l’onglet « Base de données » de ServBay.
   • Mot de passe : Même principe, récupérez-le dans l’onglet « Base de données » de ServBay.
   • Base de données : (Optionnel) Saisissez le nom de la base pour un accès direct à celle-ci. Laissez vide pour accéder au serveur et gérer plusieurs bases après connexion.
4. Cliquez sur Connexion.

Connexion à PostgreSQL

ServBay prend également en charge PostgreSQL. Dans Adminer, sélectionnez le type "PostgreSQL".

1. Ouvrez votre navigateur et allez à l’URL Adminer (https://servbay.host/adminer.php).
2. Sur l’écran de connexion, sélectionnez PostgreSQL dans le menu déroulant Système.
3. Saisissez les informations de connexion :
   • Serveur : Entrez /Applications/ServBay/tmp.
   • Nom d'utilisateur : À retrouver dans l’onglet « Base de données » de ServBay.
   • Mot de passe : À retrouver dans le même onglet.
   • Base de données : Indiquez le nom de la base (ex. postgres par défaut ou toute autre base que vous auriez créée).
4. Cliquez sur Connexion.

Connexion à SQLite 3

ServBay prend en charge les bases de données SQLite 3. Ici, il s’agit d’un fichier, donc il faut spécifier le chemin complet du fichier de la base.

1. Ouvrez votre navigateur et accédez à l’URL Adminer (https://servbay.host/adminer.php).
2. Sur l’écran de connexion, sélectionnez SQLite 3 dans le menu déroulant Système.
3. Indiquez le chemin du fichier de la base :
   • Fichier de base de données : Saisissez le chemin complet du fichier SQLite. Il est conseillé de stocker les fichiers SQLite dans le répertoire de données ServBay, par exemple : /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • Si vous indiquez un chemin vers un fichier inexistant, Adminer vous proposera de le créer.
4. Cliquez sur Connexion.

Effectuer des opérations courantes sur les bases de données

Après connexion à votre serveur ou à une base spécifique, l’interface Adminer vous permet d’effectuer de nombreuses tâches de gestion. L’interface et les fonctions peuvent varier selon le type de base, mais les étapes principales restent similaires.

Créer une base de données

(Pour MariaDB/MySQL, PostgreSQL)

1. Connectez-vous au serveur sans spécifier de base précise.
2. Repérez l’option Créer une base de données dans la barre latérale ou sur l’écran principal.
3. Saisissez le nom de la nouvelle base.
4. Sélectionnez le jeu de caractères et les règles de tri si nécessaire.
5. Cliquez sur Enregistrer ou Créer.

(Pour SQLite 3, la création de base se fait lors de la connexion en désignant un fichier nouveau.)

Gérer des tables et des données

1. Sélectionnez une base (si vous n’en avez pas choisi lors de la connexion).
2. Dans l’aperçu de la base, trouvez l’option Créer une table.
3. Indiquez le nom de la table et définissez les champs : nom, type de données, longueur, autoriser NULL, valeur par défaut, index (clé primaire, unique, index simple), etc.
4. Cliquez sur Enregistrer pour créer la table.
5. Une fois la table créée, sélectionnez-la dans le panneau latéral ou l’aperçu.
6. Gérez les données :
   • Insérer : Ajouter de nouvelles lignes.
   • Sélectionner : Consulter, rechercher, trier, filtrer les données existantes.
   • Mettre à jour : Modifier des données existantes.
   • Supprimer : Retirer des enregistrements.
   • Utiliser la fonctionnalité Requête SQL pour des requêtes complexes.

Exécuter des requêtes SQL

Adminer propose un espace dédié dans lequel vous pouvez saisir et exécuter vos requêtes SQL, pour une gestion flexible et un accès direct aux données.

1. Sélectionnez la base sur laquelle exécuter la requête.
2. Cliquez sur Requête SQL.
3. Saisissez votre commande SQL dans la zone de texte.
4. Cliquez sur Exécuter.

Import et export de données

Adminer prend en charge l’exportation de la structure et des données de la base au format SQL ou d’autres formats (CSV, etc.), ainsi que leur import – pratique pour la migration, les sauvegardes ou le partage.

1. Sélectionnez la base ou la table à exporter/importer.
2. Trouvez l’option Exporter ou Importer.
3. Suivez les instructions à l’écran pour choisir le format et les options, puis lancez l’opération.

Supprimer une base de données

(Pour MariaDB/MySQL, PostgreSQL)

1. Connectez-vous au serveur sans spécifier de base précise.
2. Depuis la liste des bases, sélectionnez celle à supprimer.
3. Cliquez sur Supprimer et confirmez. Attention : cette opération est irréversible et supprime définitivement la base et toutes ses données !

(Pour SQLite 3, la suppression d’une base se fait en effaçant le fichier .sqlite correspondant depuis le système de fichiers.)

Points importants

• Sécurité des identifiants : Gardez soigneusement les noms d’utilisateur et mots de passe obtenus dans les paramètres de ServBay, ne les partagez pas.
• Statut de ServBay : Adminer fonctionne via le serveur web embarqué de ServBay. Le service de base de données ciblé doit aussi être en marche. Si vous ne pouvez accéder à Adminer ou à la base, vérifiez que ServBay et les différents services (Caddy/Nginx, MariaDB/MySQL, PostgreSQL, etc.) sont bien démarrés.
• Chemin des fichiers SQLite : Vérifiez que les fichiers SQLite sont situés dans un répertoire dont l’utilisateur ServBay a les droits de lecture et écriture (idéalement /Applications/ServBay/db/sqlite/).
• Performances : Adminer est très léger mais, pour les bases de très grande taille ou la gestion avancée, des clients dédiés pour bureau (TablePlus, DBeaver, pgAdmin, etc.) peuvent offrir davantage de fonctionnalités ou de meilleures performances.

Foire aux questions (FAQ)

Q : Je n’arrive pas à accéder à https://servbay.host/adminer.php, que faire ?

R : Vérifiez que l’application ServBay ainsi que le serveur web (généralement Caddy ou Nginx) sont bien en marche. Contrôlez également que votre navigateur autorise l’accès à https://servbay.host.

Q : J’ai oublié mon nom d’utilisateur ou mot de passe pour la base, où puis-je le retrouver ?

R : Vous pouvez retrouver les noms d’utilisateur et mots de passe générés par défaut pour chaque base dans l’onglet « Base de données » de ServBay.

Q : Adresse du serveur et port pour se connecter à PostgreSQL ?

R : L’adresse du serveur est généralement localhost et le port par défaut 5432. Vous pouvez vérifier l’adresse et le port de PostgreSQL dans les paramètres de ServBay. Pour une connexion par Unix Domain Socket, indiquez /Applications/ServBay/tmp (il n’est pas nécessaire d’indiquer le suffixe .sock pour PostgreSQL).

Q : Différence entre l’adresse serveur et le chemin socket pour MariaDB/MySQL ?

R : localhost se connecte généralement via TCP/IP (port 3306 par défaut), tandis que /Applications/ServBay/tmp/mysql.sock privilégie le socket Unix Domain, souvent plus rapide et sécurisé en local. Choisissez la méthode la mieux adaptée à votre besoin.

Q : Puis-je gérer, via Adminer, des bases non intégrées à ServBay ?

R : Adminer prend en charge de nombreux types de bases. Si vous avez installé d’autres bases (ex. : MongoDB séparé ou base distante), il est possible de s’y connecter avec le fichier Adminer de ServBay, tant que la connexion réseau est possible et que vous avez les bons identifiants. Cependant, la valeur ajoutée principale d’Adminer dans ServBay reste la gestion simplifiée des bases intégrées à la plateforme.

Résumé

Adminer, fourni dans ServBay, est un outil de gestion de base de données extrêmement pratique. Léger, en un seul fichier, et supportant de nombreux moteurs, il simplifie largement l’administration de MariaDB/MySQL, PostgreSQL et SQLite dans un environnement de développement local. Grâce à ce guide, vous pouvez désormais vous connecter aisément aux bases de ServBay et accomplir rapidement vos opérations courantes de gestion de base de données et de manipulation de données avec Adminer.