ServBay Documentatie: Databases beheren met Adminer

Overzicht

ServBay is een krachtige lokale webontwikkelomgeving voor macOS en Windows, die diverse webservers, programmeertalen en databasesystemen integreert. Om ontwikkelaars te helpen bij het beheren van deze ingebouwde databases, wordt ServBay standaard geleverd met Adminer, een krachtig en lichtgewicht databasebeheerprogramma. Deze documentatie begeleidt je bij het verbinden en beheren van de ServBay-databases via Adminer.

Wat is Adminer

Adminer is een databasebeheerder geschreven in PHP in één enkel bestand. Het ondersteunt verschillende databases, waaronder MySQL, MariaDB, PostgreSQL, SQLite en MongoDB. Vergeleken met grotere databasebeheertools, biedt Adminer de volgende belangrijke voordelen:

1. Lichtgewicht en eenvoudige installatie: Adminer bestaat uit slechts één PHP-bestand, waardoor ingewikkelde installatie overbodig is. ServBay heeft Adminer al geïntegreerd; je kunt direct aan de slag.
2. Ondersteuning voor meerdere databases: Je kunt verschillende typen databases beheren via één uniform interface, waardoor je niet meerdere tools hoeft te installeren of leren.
3. Eenvoudig en overzichtelijk ontwerp: De interface is helder en makkelijk te navigeren, zodat ook beginners direct kunnen werken.
4. Uitgebreide functionaliteit: Adminer ondersteunt vrijwel alle veelvoorkomende databasehandelingen, zoals het aanmaken, wijzigen of verwijderen van databases, tabellen, indexen en gebruikers, het uitvoeren van SQL-query’s, en het importeren/exporteren van data.

Voor ontwikkelaars die lokaal werken met ServBay biedt Adminer een efficiënt en gebruiksvriendelijk beheerplatform voor databases.

Adminer openen

Zodra ServBay is gestart, draait Adminer automatisch en is beschikbaar via de ingebouwde webserver. Je bereikt Adminer door de standaard lokale domeinnaam van ServBay te gebruiken, gevolgd door de bestandsnaam van Adminer:

https://servbay.host/adminer.php

Zorg er altijd voor dat de ServBay-app draait, en dat de relevante webserver (zoals Caddy of Nginx) en database-services actief zijn.

Verbinden met een database in ServBay

De inlogpagina van Adminer is eenvoudig. Selecteer het databasetype en vul het serveradres, gebruikersnaam, wachtwoord en (voor sommige systemen) de databasenaam in. ServBay genereert standaard gebruikersnamen en wachtwoorden voor de ingebouwde databases. Je vindt deze gegevens in het tabblad ‘Database’ van de ServBay-app.

Verbinding maken met MariaDB / MySQL

ServBay integreert standaard MariaDB of MySQL. In Adminer kies je meestal het "MySQL" type voor deze verbinding.

1. Open je browser en ga naar Adminer (https://servbay.host/adminer.php).
2. Kies MySQL in het keuzemenu Systeem.
3. Vul de serverdetails in:
   • Server: Gebruik localhost of de door ServBay opgegeven Unix socket op /Applications/ServBay/tmp/mysql.sock. Socketverbindingen zijn doorgaans efficiënter.
   • Gebruikersnaam: Te vinden onder het tabblad ‘Database’ in de ServBay-app.
   • Wachtwoord: Ook te vinden onder hetzelfde tabblad.
   • Database: (optioneel) Vul hier een databasenaam in om rechtstreeks te verbinden met een specifieke database. Laat leeg om op de server in te loggen en alle databases te beheren.
4. Klik op Login.

Verbinding maken met PostgreSQL

ServBay ondersteunt ook PostgreSQL. In Adminer dien je dan "PostgreSQL" als type te selecteren.

1. Open je browser, ga naar Adminer (https://servbay.host/adminer.php).
2. Kies in het Systeem-menu voor PostgreSQL.
3. Vul de verbindingsgegevens in:
   • Server: Geef /Applications/ServBay/tmp op.
   • Gebruikersnaam: Te vinden in het tabblad ‘Database’ van ServBay.
   • Wachtwoord: Ook te vinden onder ‘Database’.
   • Database: Vul de naam van de gewenste database in, bijvoorbeeld postgres (standaard), of een eigen aangemaakte database.
4. Klik op Login.

Verbinding maken met SQLite 3

ServBay ondersteunt SQLite 3. Dit is een bestand-gebaseerde database; je dient het volledige pad naar het databasebestand op te geven.

1. Open je browser, ga naar Adminer (https://servbay.host/adminer.php).
2. Kies in het Systeem-menu voor SQLite 3.
3. Vul het pad in naar je databasebestand:
   • Databasebestand: Geef het volledige pad naar het SQLite databasebestand op. Aanbevolen is om je bestanden te plaatsen in de map /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • Indien het opgegeven bestand niet bestaat, vraagt Adminer of je het wilt aanmaken.
4. Klik op Login.

Veelgebruikte databasehandelingen uitvoeren

Na het succesvol inloggen op de database(server) kun je via Adminer verschillende beheertaken uitvoeren. Afhankelijk van het databasetype kunnen functies variëren, maar de basiswerking is gelijk.

Database aanmaken

(Van toepassing op MariaDB/MySQL, PostgreSQL)

1. Log in op de database/server zonder specifieke database te selecteren.
2. Zoek de optie Database aanmaken (of vergelijkbaar) in de linkernavigatie of hoofdscherm.
3. Vul een naam in voor de nieuwe database.
4. Selecteer eventueel karakterset en collatie.
5. Klik op Opslaan of Aanmaken.

(Bij SQLite 3 wordt een nieuwe database aangemaakt door in te loggen op een niet-bestaand databasebestand.)

Tabellen en data beheren

1. Selecteer een database als je die niet bij het inloggen hebt gekozen.
2. Zoek op de overzichtspagina het menu ‘Tabel aanmaken’.
3. Voer een tabelnaam in en definieer de velden (kolommen): naam, datatype, lengte, of NULL toegestaan is, standaardwaarde, index (primaire sleutel, unieke index, reguliere index), enz.
4. Klik op Opslaan om de tabel te maken.
5. Selecteer de tabel via de navigatie of overzichtspagina.
6. Voer datamanipulaties uit:
   • Invoegen: Voeg een nieuw record toe.
   • Selecteren: Bekijk, zoek, sorteer en filter bestaande data.
   • Bijwerken: Pas gegevens aan.
   • Verwijderen: Verwijder bestaande records.
   • Via SQL kun je complexe query’s en bewerkingen uitvoeren.

SQL-commando’s uitvoeren

Adminer biedt een invoerveld voor SQL-opdrachten waarmee je direct query’s en beheertaken uitvoert.

1. Kies de database waarin je werkt.
2. Klik op het menu SQL.
3. Voer je SQL-instructies in.
4. Klik op Uitvoeren.

Data importeren en exporteren

Met Adminer kun je structuren en data exporteren als SQL-bestand of in andere formaten (zoals CSV). Ook kun je via deze interface weer data importeren, handig voor migratie, backups, of het delen van data.

1. Selecteer de database of tabel die je wilt importeren/exporteren.
2. Zoek de opties Exporteren of Importeren.
3. Volg de stappen in de interface, kies het gewenste formaat en opties, en voer de handeling uit.

Database verwijderen

(Van toepassing op MariaDB/MySQL, PostgreSQL)

1. Log in op de database/server.
2. Selecteer de te verwijderen database in het overzicht.
3. Klik op Verwijderen en bevestig dit. Let op: deze handeling is permanent en verwijdert alle data.

(Bij SQLite 3 verwijder je een database door het bijbehorende .sqlite bestand handmatig te verwijderen via het bestandssysteem.)

Aandachtspunten

• Beveilig wachtwoorden: Bewaar de database-instellingen uit ServBay (gebruikersnamen, wachtwoorden) veilig en deel ze niet.
• ServBay status: Adminer werkt alleen als ServBay en de benodigde web/dataserver actief zijn. Lukt je verbinding niet? Controleer ServBay en de status van Caddy/Nginx, MariaDB/MySQL, PostgreSQL.
• Bestandsrechten SQLite: Zorg er bij SQLite voor dat ServBay toegang heeft tot het databasebestand—gebruik bij voorkeur /Applications/ServBay/db/sqlite/.
• Prestaties: Adminer is lichtgewicht. Bij extreem grote databases of complexe handelingen bieden desktoptools als TablePlus, DBeaver of pgAdmin mogelijk meer kracht of functies.

Veelgestelde vragen (FAQ)

Q: Ik kan niet naar https://servbay.host/adminer.php surfen, wat nu?

A: Controleer of ServBay actief is en of de webserver (meestal Caddy of Nginx) draait. Kijk ook of jouw browser https://servbay.host toegang geeft.

Q: Ik ben mijn databasegebruikersnaam of wachtwoord kwijt, waar vind ik die?

A: In de ServBay-app, tabblad ‘Database’, vind je de automatisch gegenereerde accounts en wachtwoorden van ServBay.

Q: Welke server en poort gebruik ik bij verbinding met PostgreSQL?

A: Standaard is de server localhost, poort 5432. Controleer eventueel de specifieke instellingen in ServBay. Bij verbinding via Unix Domain Socket gebruik je /Applications/ServBay/tmp (let op: géén .sock extensie voor PostgreSQL).

Q: Wat is het verschil tussen serveradres en socketpad bij MariaDB/MySQL?

A: Via localhost verbind je over TCP/IP (standaard poort 3306), via /Applications/ServBay/tmp/mysql.sock verbind je met een Unix Domain Socket. Zeker lokaal is een socket sneller en veiliger. Kies wat het beste past.

Q: Kan ik met Adminer ook andere databases beheren dan die ServBay standaard bevat?

A: Adminer ondersteunt vele databasevarianten. Installeer je zelf extras buiten ServBay (zoals MongoDB of externe databases), dan kun je Adminer ook daar voor inzetten, zolang de netwerkverbinding en logingegevens kloppen. Adminer is vooral bedoeld voor het beheer van de in ServBay geïntegreerde databases.

Samenvatting

Adminer is een bijzonder praktisch databasebeheerprogramma dat door ServBay wordt aangeboden. Dankzij het enkelbestand-systeem, lichtgewicht ontwerp en ondersteuning voor meerdere databases maakt Adminer het beheren van MariaDB/MySQL, PostgreSQL en SQLite in lokale ontwikkelomgevingen heel gemakkelijk. Met deze documentatie kun je moeiteloos verbinding maken met ServBay-databases, en Adminer inzetten voor dagelijkse beheer- en datahandelingen.