Dokumentacja ServBay: Zarządzanie bazami danych za pomocą Adminer

Przegląd

ServBay to zaawansowane lokalne środowisko rozwoju webowego wspierające macOS i Windows, zintegrowane z wieloma serwerami WWW, środowiskami uruchomieniowymi języków programowania oraz systemami baz danych. Aby ułatwić programistom zarządzanie wbudowanymi bazami danych, ServBay wyposażony jest w Adminer – wydajne i lekkie narzędzie do zarządzania bazami danych. Ten dokument opisuje, jak korzystać z Adminer do łączenia się i zarządzania bazami dostępnymi w ServBay.

Czym jest Adminer

Adminer to pojedynczy plik PHP stanowiący kompleksowe narzędzie do zarządzania bazami danych. Obsługuje wiele systemów bazodanowych, takich jak MySQL, MariaDB, PostgreSQL, SQLite, MongoDB i inne. W porównaniu do ciężkich klientów bazodanowych, Adminer wyróżnia się:

1. Lekkość i prostota wdrożenia: Adminer składa się wyłącznie z jednego pliku PHP, co eliminuje potrzebę złożonej instalacji. Jest natychmiast dostępny w ServBay.
2. Wieloplatformowa obsługa baz danych: Umożliwia zarządzanie różnymi typami baz z pojedynczego, spójnego interfejsu – zapomnisz o instalacji i nauce wielu niezależnych narzędzi.
3. Intuicyjny i przejrzysty interfejs: Interfejs jest czytelny, łatwy w nawigacji oraz przyjazny nawet dla osób korzystających po raz pierwszy.
4. Bogata funkcjonalność: Wspiera typowe operacje jak tworzenie, edycja i usuwanie baz danych, tabel, indeksów czy użytkowników, wykonywanie zapytań SQL oraz import/eksport danych.

Adminer jest wygodnym i skutecznym rozwiązaniem dla developerów tworzących lokalnie z użyciem ServBay.

Dostęp do Adminer

Po uruchomieniu ServBay, Adminer jest automatycznie dostępny przez wbudowany serwer WWW. Odwiedź go, przechodząc pod domyślną domenę ServBay z nazwą pliku Adminer:

https://servbay.host/adminer.php

Upewnij się, że aplikacja ServBay jest uruchomiona, a właściwy serwer WWW (np. Caddy lub Nginx) oraz wybrana usługa bazodanowa są aktywne.

Łączenie się z bazą danych w ServBay

Panel logowania Adminer jest bardzo prosty – wybierz typ bazy, podaj adres serwera, nazwę użytkownika, hasło oraz (dla niektórych baz) nazwę konkretnej bazy. Domyślne dane dostępu dla wbudowanych baz danych znajdziesz w zakładce „Baza danych” w aplikacji ServBay.

Połączenie z MariaDB / MySQL

ServBay standardowo integruje MariaDB lub MySQL. W Adminer do połączenia wybierz typ „MySQL”.

1. Otwórz przeglądarkę i przejdź do Adminer (https://servbay.host/adminer.php).
2. Na ekranie logowania rozwiń menu System i wybierz MySQL.
3. Wprowadź dane dostępowe:
   • Serwer: wpisz localhost lub podaj ścieżkę do Unix Socket, np. /Applications/ServBay/tmp/mysql.sock. Połączenie przez Socket jest często wydajniejsze.
   • Użytkownik: sprawdź nazwę użytkownika w zakładce „Baza danych” w ServBay dla MariaDB/MySQL.
   • Hasło: znajduje się również w tej zakładce.
   • Baza danych: (opcjonalnie) wpisz nazwę konkretnej bazy, aby połączyć się bezpośrednio z nią. Pole pozostawione puste pozwala zarządzać wszystkimi bazami po zalogowaniu.
4. Kliknij Zaloguj.

Połączenie z PostgreSQL

ServBay obsługuje także PostgreSQL – w Adminer wybierz typ „PostgreSQL”.

1. Otwórz przeglądarkę i przejdź do Adminer (https://servbay.host/adminer.php).
2. Na ekranie logowania rozwiń System i wybierz PostgreSQL.
3. Podaj dane dostępowe:
   • Serwer: wpisz /Applications/ServBay/tmp.
   • Użytkownik: sprawdź nazwę użytkownika w zakładce „Baza danych” w ServBay.
   • Hasło: znajdziesz tam również.
   • Baza danych: podaj nazwę, np. domyślną postgres albo nazwę własnej bazy.
4. Kliknij Zaloguj.

Połączenie z SQLite 3

ServBay obsługuje bazy SQLite 3. Tu należy przedstawić ścieżkę do pliku bazy danych.

1. Otwórz przeglądarkę i przejdź do Adminer (https://servbay.host/adminer.php).
2. Na ekranie logowania rozwiń System i wybierz SQLite 3.
3. Podaj ścieżkę pliku bazy:
   • Plik bazy danych: wpisz pełną ścieżkę do pliku SQLite, np. /Applications/ServBay/db/sqlite/nazwa_bazy.sqlite. Zaleca się umieszczanie pliku w katalogu danych ServBay.
   • Jeśli plik nie istnieje, Adminer zapyta o możliwość utworzenia nowej bazy danych.
4. Kliknij Zaloguj.

Wykonywanie typowych operacji na bazie danych

Po udanym logowaniu możesz wykonywać szeroki zakres czynności zarządczych w bazie przez interfejs Adminer. Dostępność funkcji zależy od typu bazy, ale główne operacje wyglądają podobnie.

Tworzenie bazy danych

(dotyczy MariaDB/MySQL, PostgreSQL)

1. Po zalogowaniu do serwera baz danych bez wybranej konkretnej bazy.
2. W pasku nawigacyjnym lub głównym interfejsie znajdź opcję Utwórz bazę danych lub podobną.
3. Wpisz nazwę nowej bazy.
4. Wybierz kodowanie znaków i sortowanie (jeśli wymagane).
5. Kliknij Zapisz lub Utwórz.

(dla SQLite 3 nowa baza tworzona jest logując się poprzez podanie nieistniejącej ścieżki pliku.)

Zarządzanie tabelami i danymi

1. Wybierz bazę danych (jeśli nie została wskazana przy logowaniu).
2. Na stronie przeglądu bazy znajdź opcję Utwórz tabelę.
3. Podaj nazwę tabeli oraz zdefiniuj jej kolumny – nazwy, typy danych, długości, dozwolone wartości NULL, wartości domyślne, indeksy (klucz główny, unikalny, zwykły itp.).
4. Kliknij Zapisz aby utworzyć tabelę.
5. Po utworzeniu wybierz tabelę z paska nawigacyjnego lub przeglądu.
6. Wykonuj operacje na danych:
   • Wstaw: dodaj nowy wiersz.
   • Przeglądaj: wyświetl, przeszukaj, sortuj lub filtruj istniejące dane.
   • Aktualizuj: edytuj istniejące rekordy.
   • Usuń: usuń wybrane wiersze.
   • Skorzystaj z opcji Komenda SQL aby wykonać zaawansowane zapytania.

Wykonywanie komend SQL

Adminer zapewnia dedykowany formularz do wpisywania i wykonania własnych instrukcji SQL – możesz tam realizować niestandardowe zapytania lub złożone operacje.

1. Wybierz bazę danych, na której chcesz pracować.
2. Przejdź do opcji Komenda SQL.
3. W polu tekstowym wpisz swoje polecenie SQL.
4. Kliknij Wykonaj.

Import i eksport danych

Za pomocą Adminer możesz eksportować strukturę i zawartość bazy do pliku SQL lub innych formatów (np. CSV), a także importować dane – ułatwia to migrację, backup lub współdzielenie.

1. Wybierz bazę lub konkretną tabelę.
2. Odnajdź opcję Eksportuj lub Importuj.
3. Wybierz format i ustawienia, a następnie wykonaj operację zgodnie z instrukcjami na ekranie.

Usuwanie bazy danych

(dotyczy MariaDB/MySQL, PostgreSQL)

1. Po zalogowaniu do serwera, wybierz bazę do usunięcia z listy.
2. Kliknij Usuń i potwierdź wybór. Uwaga: ta operacja jest nieodwracalna – wszystkie dane zostaną trwale usunięte!

(dla SQLite 3 usunięcie bazy polega na fizycznym skasowaniu pliku .sqlite w systemie plików.)

Wskazówki

• Bezpieczeństwo danych: Dane dostępowe pobierane z ustawień ServBay należy przechowywać w bezpiecznym miejscu, nie udostępniaj ich osobom trzecim.
• Status aplikacji ServBay: Dostęp do Adminer wymaga uruchomionej aplikacji ServBay i pracującej usługi bazodanowej. W razie problemów z dostępem sprawdź, czy ServBay oraz właściwe usługi (Caddy/Nginx, MariaDB/MySQL, PostgreSQL itd.) są aktywne.
• Ścieżka plików SQLite: Upewnij się, że pliki baz SQLite są umieszczone w katalogu, do którego użytkownik ServBay ma pełne prawa odczytu i zapisu – zalecane jest /Applications/ServBay/db/sqlite/.
• Wydajność: Mimo iż Adminer jest bardzo lekki, do zarządzania wielkimi bazami lub zaawansowanych operacji warto rozważyć profesjonalne aplikacje desktopowe (TablePlus, DBeaver, pgAdmin itp.).

Często zadawane pytania (FAQ)

Q: Nie mogę otworzyć https://servbay.host/adminer.php. Co zrobić?

A: Sprawdź, czy aplikacja ServBay jest uruchomiona oraz czy serwer WWW (np. Caddy lub Nginx) jest aktywny. Upewnij się, że przeglądarka pozwala na dostęp do https://servbay.host.

Q: Zapomniałem nazwy użytkownika lub hasła do bazy. Gdzie je znaleźć?

A: Informacje o domyślnych użytkownikach i hasłach dla baz ServBay znajdziesz w zakładce „Baza danych” w interfejsie aplikacji ServBay.

Q: Jakie są adres i port serwera dla PostgreSQL?

A: Zwykle serwer to localhost, a domyślny port to 5432. Dane te możesz potwierdzić w ustawieniach ServBay. Jeśli łączysz się przez Unix Domain Socket, podaj /Applications/ServBay/tmp (bez końcówki .sock – PostgreSQL jej nie wymaga).

Q: Czym różni się adres serwera od ścieżki socket w MariaDB/MySQL?

A: localhost umożliwia połączenie przez TCP/IP (domyślnie port 3306), natomiast /Applications/ServBay/tmp/mysql.sock łączy przez Unix Domain Socket. Połączenie przez socket w lokalnym środowisku bywa szybsze i bezpieczniejsze. Wybierz sposób odpowiedni dla swoich potrzeb.

Q: Czy przez Adminer mogę zarządzać innymi bazami niż te wbudowane w ServBay?

A: Adminer obsługuje wiele typów baz danych. Jeśli zainstalujesz inne bazy poza ServBay (np. osobny MongoDB lub zdalne bazy), możesz próbować połączyć się z ich użyciem poprzez plik Adminer w ServBay – pod warunkiem dostępności sieci i poprawnych danych połączeniowych. Główną zaletą integracji Adminer w ServBay jest wygodne zarządzanie wbudowanymi bazami.

Podsumowanie

Adminer to praktyczne narzędzie udostępniane w ramach ServBay, które dzięki lekkości, pojedynczemu plikowi PHP oraz obsłudze wielu typów baz znacznie upraszcza zarządzanie MariaDB/MySQL, PostgreSQL oraz SQLite w lokalnym środowisku developerskim. Dzięki temu przewodnikowi łatwo połączysz się z bazami w ServBay i wykorzystasz Adminer do codziennych operacji administracyjnych oraz pracy z danymi.