ServBay Documentatie: Databases beheren met Adminer

Overzicht

ServBay is een krachtige lokale webontwikkelomgeving speciaal ontworpen voor macOS, geïntegreerd met verschillende webservers, programmeertalen en databasesystemen. Om het beheren van deze ingebouwde databases te vergemakkelijken, wordt Adminer standaard geïnstalleerd en geconfigureerd in ServBay. Adminer is een krachtige, lichtgewicht databasebeheertool. Deze handleiding laat je zien hoe je met Adminer verbinding maakt met en beheer uitvoert over de databases in ServBay.

Wat is Adminer

Adminer is een databasebeheertool, geschreven in PHP, die uit slechts één bestand bestaat. Het ondersteunt veel databasesystemen, waaronder MySQL, MariaDB, PostgreSQL, SQLite, MongoDB en meer. In vergelijking met zwaardere databaseclients biedt Adminer de volgende belangrijke voordelen:

1. Lichtgewicht en eenvoudig te implementeren: Adminer bestaat uit slechts één PHP-bestand, waardoor installatie overbodig is. Je kunt direct aan de slag. ServBay heeft het al geïntegreerd en klaar voor gebruik.
2. Ondersteuning voor meerdere databases: Met één uniforme interface kun je verschillende soorten databases beheren, zonder aparte tools te hoeven installeren en leren.
3. Duidelijke en intuïtieve gebruikersinterface: De overzichtelijke en gebruiksvriendelijke interface maakt het gemakkelijk voor zelfs beginnende ontwikkelaars om snel aan de slag te gaan.
4. Volledige functionaliteit: Ondersteunt bijna alle veelgebruikte databaseoperaties, zoals het aanmaken, wijzigen en verwijderen van databases, tabellen, indexen en gebruikers, uitvoeren van SQL-queries en het importeren/exporteren van data.

Voor ontwikkelaars die ServBay gebruiken voor lokaal ontwikkelwerk, biedt Adminer een snelle en efficiënte oplossing voor databasebeheer.

Adminer openen

Na het starten van ServBay draait Adminer automatisch en is toegankelijk via de ingebouwde webserver. Je kunt toegang krijgen via de standaard localhost-domeinnaam van ServBay, gevolgd door de Adminer-bestandsnaam:

https://servbay.host/adminer.php

Zorg ervoor dat de ServBay-applicatie draait, evenals de relevante webserver (bijvoorbeeld Caddy of Nginx) en de database die je wil benaderen.

Verbinden met databases in ServBay

Het inlogscherm van Adminer is zeer overzichtelijk. Je selecteert het databasetype en voert de benodigde informatie in: serveradres, gebruikersnaam, wachtwoord en, indien nodig, de databasenaam. ServBay genereert standaard gebruikersnamen en wachtwoorden voor de ingebouwde databases. Deze vind je in het tabblad 'Database' van de ServBay-app.

Verbinden met MariaDB / MySQL

ServBay wordt standaard geleverd met MariaDB of MySQL. In Adminer kies je meestal het type "MySQL" om verbinding te maken.

1. Open je browser en ga naar de Adminer URL (https://servbay.host/adminer.php).
2. Kies MySQL in het dropdownmenu Systeem op het inlogscherm.
3. Voer de verbindingsgegevens in:
   • Server: Vul localhost in of gebruik het Unix Socket-pad dat ServBay aanbiedt: /Applications/ServBay/tmp/mysql.sock. Een socketverbinding is meestal efficiënter.
   • Gebruikersnaam: Vind de MariaDB/MySQL-gebruikersnaam in het ServBay 'Database'-tabblad.
   • Wachtwoord: Vind het MariaDB/MySQL-wachtwoord in het ServBay 'Database'-tabblad.
   • Database: (Optioneel) Vul hier de naam van de database in als je direct verbinding wilt maken met een specifieke database. Laat leeg om op serverniveau in te loggen en daarna alle databases te beheren.
4. Klik op de knop Inloggen.

Verbinden met PostgreSQL

ServBay ondersteunt ook PostgreSQL. Selecteer "PostgreSQL" in Adminer.

1. Open je browser en ga naar de Adminer URL (https://servbay.host/adminer.php).
2. Kies PostgreSQL in het dropdownmenu Systeem.
3. Voer de verbindingsgegevens in:
   • Server: Vul /Applications/ServBay/tmp in.
   • Gebruikersnaam: Vind de PostgreSQL-gebruikersnaam in het ServBay 'Database'-tabblad.
   • Wachtwoord: Vind het PostgreSQL-wachtwoord in het ServBay 'Database'-tabblad.
   • Database: Vul de naam van de database in, bijvoorbeeld de standaard postgres database of een andere aangemaakte database.
4. Klik op de knop Inloggen.

Verbinden met SQLite 3

ServBay ondersteunt ook SQLite 3. Aangezien SQLite een databasebestand is, moet je hier het bestandspad opgeven.

1. Open je browser en ga naar de Adminer URL (https://servbay.host/adminer.php).
2. Kies SQLite 3 in het dropdownmenu Systeem.
3. Voer het bestandspad van de database in:
   • Databasebestand: Vul het volledige pad naar het SQLite-databasebestand in. Het is aan te raden je SQLite-bestanden te plaatsen in de ServBay-datamap, bijvoorbeeld /Applications/ServBay/db/sqlite/your_database_name.sqlite.
   • Als het opgegeven bestand niet bestaat, vraagt Adminer of je dit bestand wilt aanmaken.
4. Klik op de knop Inloggen.

Veelvoorkomende databaseoperaties uitvoeren

Na succesvol inloggen op de database-server of een specifieke database kun je via de Adminer-interface diverse beheertaken uitvoeren. Interfaces en functies kunnen per databastype iets verschillen, maar de basisworkflow is vergelijkbaar.

Database aanmaken

(Geschikt voor MariaDB/MySQL en PostgreSQL)

1. Log in op de database-server (zonder specifieke database te selecteren).
2. Zoek de optie Database aanmaken of iets soortgelijks in de navigatie of op het startscherm.
3. Voer een nieuwe databasenaam in.
4. Kies desgewenst een tekenset en sorteerwijze.
5. Klik op Opslaan of Aanmaken.

(Bij SQLite 3 wordt de database aangemaakt door bij het inloggen een nieuw, niet-bestaand bestandspad op te geven.)

Tabellen en data beheren

1. Selecteer een database (indien niet al bij het inloggen gedaan).
2. Zoek de optie Tabel aanmaken op de overzichtspagina van de database.
3. Vul de tabelnaam en de kolomdefinities in: kolomnamen, datatypes, lengte, of de kolom NULL mag zijn, standaardwaarden, indexen (primaire sleutel, unieke index, gewone index), enzovoorts.
4. Klik op Opslaan om de tabel aan te maken.
5. Selecteer de gewenste tabel via de navigatie of overzichtspagina.
6. Voer vervolgens bewerkingen uit:
   • Invoegen: Nieuwe rijen toevoegen.
   • Selecteren: Gegevens bekijken, zoeken, sorteren en filteren.
   • Bijwerken: Bestaande rijen aanpassen.
   • Verwijderen: Gegevensrijen verwijderen.
   • Gebruik SQL-commando voor complexere queries en operaties.

SQL-commando’s uitvoeren

Adminer biedt een interface om direct SQL-commando’s uit te voeren voor flexibel databasebeheer en geavanceerde query’s.

1. Selecteer de database waarop je het commando wil uitvoeren.
2. Klik op de optie SQL-commando.
3. Voer je SQL-query in het tekstveld in.
4. Klik op Uitvoeren.

Data importeren en exporteren

Adminer ondersteunt het exporteren van databasestructuren en -data naar SQL- of andere formaten (zoals CSV), en het importeren van data uit deze bestanden. Dit is handig voor migratie, back-ups of het delen van data.

1. Kies de database of tabel die je wilt importeren of exporteren.
2. Zoek de optie Exporteren of Importeren.
3. Volg de instructies op het scherm om het formaat te kiezen en de actie uit te voeren.

Database verwijderen

(Geschikt voor MariaDB/MySQL en PostgreSQL)

1. Log in op de database-server (niet op een specifieke database).
2. Selecteer de database die je wilt verwijderen in de lijst.
3. Klik op de optie Verwijderen en bevestig. Let op: deze actie kan niet ongedaan worden gemaakt en verwijdert alle gegevens permanent.

(Bij SQLite 3 betekent een database verwijderen het handmatig wissen van het desbetreffende .sqlite-bestand via je bestandsbeheerder.)

Aandachtspunten

• Beveilig inloggegevens: Bewaar de databasegebruikersnamen en wachtwoorden die je uit de ServBay-instellingen haalt veilig en deel ze niet.
• ServBay status: Adminer is alleen bereikbaar via de webserver van ServBay en vereist dat de database ook actief is. Krijg je geen toegang tot Adminer of tot de database, controleer dan of ServBay draait en of de relevante services (Caddy/Nginx, MariaDB/MySQL, PostgreSQL, enz.) actief zijn.
• SQLite-bestandspaden: Zorg ervoor dat je voor SQLite een pad gebruikt waar ServBay de juiste lees- en schrijfrechten heeft, bij voorkeur onder /Applications/ServBay/db/sqlite/.
• Performance: Adminer is zeer lichtgewicht. Voor grote databases of complexe taken bieden desktoptools als TablePlus, DBeaver of pgAdmin mogelijk meer geavanceerde functionaliteit of betere prestaties.

Veelgestelde vragen (FAQ)

V: Ik kan https://servbay.host/adminer.php niet bereiken. Wat nu?

A: Controleer of de ServBay-app draait en of de ServBay-webserver (meestal Caddy of Nginx) actief is. Kijk ook of je browser toegang tot https://servbay.host toestaat.

V: Ik ben de databasegebruikersnaam of het wachtwoord kwijt, waar vind ik deze?

A: Je vindt de standaardgebruikersnaam en het wachtwoord voor elke database terug in het 'Database’-tabblad van de ServBay-app.

V: Wat is het serveradres en poort voor PostgreSQL?

A: Meestal is het serveradres localhost en de standaardpoort 5432. Controleer de PostgreSQL-instellingen in ServBay om dit te bevestigen. Bij gebruik van Unix Domain Socket, vul je /Applications/ServBay/tmp in (let op: Voeg géén .sock extensie toe voor PostgreSQL).

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

A: localhost gebruikt standaard TCP/IP (poort 3306), terwijl /Applications/ServBay/tmp/mysql.sock via een Unix Domain Socket werkt. Lokale socketverbindingen zijn meestal sneller en veiliger. Kies de optie die het beste bij jouw situatie past.

V: Kan ik in Adminer ook databases beheren die niet door ServBay zijn geïnstalleerd?

A: Adminer ondersteunt meerdere databasetypen. Je kunt verbinding maken met externe of apart geïnstalleerde databases (zoals een eigen MongoDB of een remote database) via het Adminer-bestand in ServBay, mits je over de juiste connectiegegevens beschikt en de database bereikbaar is. Houd er rekening mee dat Adminer vooral is geïntegreerd voor beheer van databases die via ServBay zijn geïnstalleerd.

Samenvatting

Adminer is een zeer handige databasebeheertool die in ServBay is meegeleverd. Dankzij het single-file ontwerp, de lichtgewicht aanpak en de multi-database ondersteuning maakt Adminer het beheren van MariaDB/MySQL-, PostgreSQL- en SQLite-databases op je lokale ontwikkelomgeving bijzonder eenvoudig. Met deze handleiding kun je snel verbinding maken met databases in ServBay en Adminer gebruiken voor dagelijkse beheer- en datawerkzaamheden.