Instalacja i konfiguracja Drupala w lokalnym środowisku ServBay

Wprowadzenie

Drupal to potężny, elastyczny i skalowalny system zarządzania treścią (CMS) typu open source. Jest szeroko stosowany do tworzenia różnych typów stron internetowych — od blogów, stron małych firm po rozbudowane portale korporacyjne i skomplikowane aplikacje webowe. Oferuje bogate narzędzia do zarządzania treścią, zaawansowaną kontrolę uprawnień użytkowników oraz solidną, modułową architekturę, co czyni go idealnym wyborem dla deweloperów oczekujących wysokiej wydajności i możliwości rozbudowy.

ServBay to narzędzie do lokalnego rozwoju stron WWW zaprojektowane specjalnie dla macOS. Integruje najpopularniejsze serwery WWW (np. Caddy, Nginx), różnorodne środowiska uruchomieniowe (PHP, Node.js, Python, Go, Java itp.), bazy danych (MySQL, PostgreSQL, MongoDB, Redis) oraz narzędzia deweloperskie, takie jak Composer czy npm. Instalacja i konfiguracja Drupala w środowisku ServBay zapewni Ci stabilną, wygodną i kompletną platformę rozwojową na lokalnym komputerze.

W tym artykule szczegółowo opisujemy, jak zainstalować i skonfigurować Drupala w środowisku ServBay, by w krótkim czasie uruchomić lokalny projekt Drupal.

Wymagania wstępne

Przed rozpoczęciem instalacji Drupala upewnij się, że zostały spełnione poniższe warunki:

1. ServBay zainstalowany i uruchomiony: Sprawdź, czy ServBay został poprawnie zainstalowany na macOS i działa prawidłowo.
2. Podstawowa znajomość obsługi ServBay: Wiesz, jak korzystać z interfejsu ServBay, zarządzać pakietami, dodawać strony i korzystać z wbudowanych narzędzi (np. phpMyAdmin).
3. Zainstalowane PHP i MySQL/MariaDB: ServBay domyślnie zawiera kilka wersji PHP oraz bazy danych MySQL lub MariaDB. Upewnij się, że wybrana przez Ciebie wersja PHP jest aktywna oraz że usługa bazy danych działa.
4. Composer zainstalowany: ServBay ma wbudowanego Composera — kluczowe narzędzie do zarządzania zależnościami w nowoczesnych projektach PHP. W tym przewodniku Composer zostanie użyty do utworzenia projektu Drupal.

Kroki instalacji Drupala

Poniżej znajdziesz szczegółową instrukcję instalacji i konfiguracji Drupala w środowisku ServBay:

Krok 1: Utworzenie katalogu projektu

Najpierw utwórz osobny podkatalog dla projektu Drupal w głównym katalogu stron WWW ServBay /Applications/ServBay/www.

Otwórz Terminal i wykonaj następujące polecenia:

cd /Applications/ServBay/www
mkdir servbay-drupal-app
cd servbay-drupal-app

Te polecenia utworzą nowy folder servbay-drupal-app w katalogu /Applications/ServBay/www i przejdą do niego.

Krok 2: Utworzenie projektu Drupal za pomocą Composera

Composer jest już zintegrowany z ServBay, nie musisz go instalować oddzielnie. Oficjalnie rekomenduje się użycie Composera do tworzenia projektów i zarządzania zależnościami w Drupalu.

Będąc w katalogu servbay-drupal-app, wykonaj polecenie:

composer create-project drupal/recommended-project .

To polecenie utworzy nowy projekt Drupal w bieżącym katalogu (.) przy użyciu szablonu drupal/recommended-project. Composer automatycznie pobierze pliki jądra Drupala i wszystkie wymagane zależności. Czas trwania zależy od szybkości Twojego internetu.

Szablon drupal/recommended-project umieszcza wszystkie pliki publiczne (np. index.php, style CSS, pliki JavaScript itp.) w podkatalogu web. Jest to zalecana struktura dla nowoczesnych projektów Drupal i podnosi poziom bezpieczeństwa aplikacji.

Krok 3: Utworzenie bazy danych i użytkownika

Drupal do działania wymaga bazy danych do przechowywania treści, konfiguracji i danych użytkowników. Użyjemy wbudowanego narzędzia phpMyAdmin w ServBay do stworzenia bazy oraz użytkownika.

1. Otwórz narzędzie do zarządzania bazą danych — phpMyAdmin

   W przeglądarce wejdź na domyślny dashboard ServBay: https://servbay.host/. W panelu głównym znajdź i kliknij link „phpMyAdmin” (zwykle w sekcji „Narzędzia” lub „Bazy danych”), aby przejść do interfejsu phpMyAdmin.

   servbay.host to dedykowana domena ServBay wskazująca na jego wewnętrzny panel administracyjny.

2. Utwórz użytkownika bazy danych

   Dla bezpieczeństwa zaleca się stworzyć osobnego użytkownika bazy dla projektu Drupal.

   • Przejdź do zakładki „Użytkownicy”: W phpMyAdmin kliknij w górnym menu „Użytkownicy”.
   • Dodaj nowego użytkownika: Kliknij „Dodaj użytkownika”.
   • Wypełnij dane użytkownika:
     • Nazwa użytkownika: np. drupal_user.
     • Host: wpisz lub wybierz localhost (użytkownik będzie miał dostęp tylko lokalnie).
     • Hasło: wybierz silne hasło. Przykład password123 podany jest tylko edukacyjnie — w praktyce użyj złożonego hasła wygenerowanego przez generator.
     • Powtórz hasło: przepisz je ponownie.
   • Uprawnienia do bazy: W sekcji „Utwórz bazę danych o takiej samej nazwie i przyznaj wszystkie uprawnienia” zaznacz tę opcję. Zostanie automatycznie utworzona baza drupal_user i przypisane do niej wszystkie uprawnienia tego użytkownika.
   • Uprawnienia globalne: Upewnij się, że nie jest zaznaczona opcja globalnych uprawnień „przyznaj wszystkie uprawnienia” (chyba że naprawdę tego potrzebujesz). Wystarczą pełne prawa do tej jednej bazy.
   • Zatwierdź: Po sprawdzeniu danych kliknij w prawym dolnym rogu „Wykonaj”.

   Teraz masz utworzoną bazę drupal_user i użytkownika drupal_user, który ma do niej pełny dostęp.

Krok 4: Konfiguracja serwera WWW (Dodanie strony w ServBay)

Kolejny krok to skonfigurowanie strony WWW w ServBay, aby wskazywała na katalog web Twojego projektu Drupal pod wybraną lokalną domeną.

1. Uruchom interfejs ServBay: Otwórz aplikację ServBay.
2. Dodaj nową stronę: Kliknij zakładkę „Strony” w lewym menu.
3. Dodaj stronę: Na liście stron kliknij przycisk „+” lub podobny, by dodać nową konfigurację.
4. Uzupełnij dane strony:
   • Nazwa: np. My Drupal Site.
   • Domena: np. servbay-drupal.local — ServBay obsługuje końcówkę .local bez konieczności edycji pliku hosts.
   • Typ strony: wybierz PHP.
   • Wersja PHP: wybierz wersję zgodną z wybraną wersją Drupala (sprawdź dokumentację projektu).
   • Katalog główny: bardzo ważne — wskaż katalog z plikiem wejściowym Drupala, czyli /Applications/ServBay/www/servbay-drupal-app/web.
5. Zapisz konfigurację: Po uzupełnieniu danych kliknij „Zapisz” lub odpowiadający przycisk. ServBay automatycznie zaktualizuje konfigurację serwera WWW i ją uaktywni.

Krok 5: Uruchom instalator Drupala

Teraz możesz rozpocząć instalację Drupala korzystając z przeglądarki i lokalnej domeny.

1. Wejdź na stronę instalacji

   Otwórz w przeglądarce adres: https://servbay-drupal.local/core/install.php.

   Powinieneś zobaczyć panel instalacyjny Drupala.

2. Wybierz język

   Wybierz domyślny język swojego serwisu Drupal i kliknij „Zapisz i kontynuuj”.

3. Wybierz rodzaj instalacji

   Wybierz „Standardowy”, jeśli chcesz mieć domyślną konfigurację z przydatnymi funkcjami. Kliknij „Zapisz i kontynuuj”.

4. Konfiguracja bazy danych

   Instalator poprosi o dane połączenia z bazą danych. Wypełnij danymi z kroku 3:

   • Typ bazy: wybierz MySQL, MariaDB, Percona Server lub równoważny.
   • Nazwa bazy: drupal_user.
   • Użytkownik bazy: drupal_user.
   • Hasło: wpisz swoje hasło ustawione dla drupal_user.
   • Host bazy: localhost.
   • Opcje zaawansowane: zmieniaj tylko, jeśli korzystasz z niestandardowego portu lub niestandardowej konfiguracji.

   Po wpisaniu kliknij „Zapisz i kontynuuj”. Drupal połączy się i zaimportuje dane początkowe.

5. Uzupełnij dane strony

   Jeśli połączenie się powiedzie, przejdziesz do konfiguracji witryny. Uzupełnij:

   • Nazwa strony: wyświetlana nazwa serwisu.
   • Email strony: adres email do powiadomień etc.
   • Użytkownik administratora: login administratora.
   • Hasło administratora: podaj silne hasło dla administratora.
   • Kraj/region: wybierz odpowiedni kraj.
   • Strefa czasowa: ustaw swoją strefę czasową.

   Zakończ i przejdź dalej — Drupal dokończy instalację i utworzy konfigurację.

6. Zakończ instalację

   Po wszystkim zostaniesz przekierowany na stronę główną nowego serwisu Drupal. Gratulacje — instalacja Drupala w środowisku ServBay powiodła się!

Krok 6: Instalacja modułów i motywów (Podstawowa informacja)

Mocną stroną Drupala jest rozbudowany ekosystem modułów i motywów. Po udanej instalacji możesz zacząć rozbudowywać i personalizować swoją stronę.

1. Zaloguj się do panelu administracyjnego Drupala: Odwiedź https://servbay-drupal.local/user lub https://servbay-drupal.local/admin i zaloguj się danymi administratora.
2. Instalacja modułów: Po zalogowaniu przejdź do menu „Rozszerzenia” (Extend), gdzie możesz wyszukiwać, instalować i zarządzać modułami dodającymi nowe funkcje stronie.
3. Instalacja motywów: Przejdź do „Wygląd” (Appearance), by wybierać/modyfikować motywy odpowiadające za wygląd witryny.

Kolejne kroki po instalacji

Po udanej instalacji Drupala możesz od razu zacząć wykorzystywać jego możliwości do budowy własnej strony. Poniżej kilka podstawowych czynności.

Tworzenie typów i treści

Podstawą Drupala są typy treści, które definiują budowę różnych rodzajów zawartości (np. artykuły, strony itp.).

1. Tworzenie typu treści: Z panelu admina przejdź do „Struktura” -> „Typy treści”. Możesz edytować istniejące lub kliknąć „Dodaj typ treści” i określić jego pola (tytuł, opis, obraz, itp.).
2. Dodawanie treści: Przejdź do „Zawartość” -> „Dodaj zawartość”, wybierz typ, uzupełnij pola i kliknij „Zapisz i opublikuj”.

Konfiguracja menu nawigacyjnego

Menu pozwala organizować strukturę linków na stronie.

1. Tworzenie menu: Z panelu admina wybierz „Struktura” -> „Menu”. Tutaj możesz dodać nowe menu lub edytować istniejące.
2. Dodawanie pozycji menu: Edytuj menu, kliknij „Dodaj link”, wpisz tekst oraz ścieżkę docelową (np. /node/1 lub zewnętrzny URL). Zapisz zmiany.

Dostosowywanie układu bloków

Bloki to moduły wyświetlane w określonych miejscach strony (np. pasek boczny, stopka).

1. Dodawanie bloków: Z panelu admina — „Struktura” -> „Układ bloków”. Strona pokazuje dostępne obszary motywu, do których możesz przeciągać dostępne bloki (np. menu, niestandardowe treści).
2. Konfiguracja bloków: Obok każdego bloku kliknij „Konfiguruj”, by zmienić tytuł, widoczność dla stron czy ról użytkowników.

Najczęstsze pytania i wskazówki (FAQ)

• Jak zmienić konfigurację PHP? Jeśli Drupal wymaga określonych rozszerzeń PHP lub zwiększenia limitu pamięci (memory_limit), wejdź w ServBay w zakładkę „Pakiety”, znajdź wybraną wersję PHP i kliknij „Konfiguruj”, aby edytować plik php.ini. Po zapisaniu konieczny jest restart usługi PHP (ServBay zazwyczaj sam do tego zachęci lub zrobi to automatycznie).
• Dlaczego strona nie działa?
  • Sprawdź, czy ServBay jest uruchomiony.
  • Zweryfikuj konfigurację strony w ServBay — w szczególności domenę i ścieżkę katalogu głównego (czy na pewno .../servbay-drupal-app/web).
  • Sprawdź, czy wybrany serwer WWW (Caddy lub Nginx) jest aktywny.
  • Upewnij się, że wchodzisz na adres https://servbay-drupal.local (dla instalacji początkowej — https://servbay-drupal.local/core/install.php).
• Nie można połączyć się z bazą danych?
  • Sprawdź, czy nazwa bazy, użytkownik i hasło wpisane w instalatorze Drupala są identyczne z tymi założonymi w phpMyAdmin.
  • Serwer bazy powinien być ustawiony na localhost.
  • Zweryfikuj, czy usługa MySQL/MariaDB jest w ServBay uruchomiona.
• Błędy podczas pobierania zależności Composerem? Sprawdź połączenie z Internetem — Composer musi mieć dostęp do packagist.org. Czasem pomaga wyczyścić cache Composera lub go zaktualizować (ServBay automatycznie go odświeża).
• Problemy z uprawnieniami do plików? Drupal wymaga zapisu w niektórych katalogach (np. web/sites/default/files oraz web/sites/default/settings.php). Serwer ServBay zwykle działa na Twoim koncie użytkownika, ale jeśli wystąpią problemy, sprawdź prawa do tych folderów.

Podsumowanie

Postępując zgodnie z tym przewodnikiem, udało Ci się zainstalować i skonfigurować Drupala w lokalnym środowisku ServBay. ServBay to wygodna, wydajna platforma integrująca wszystkie potrzebne komponenty do rozwoju Drupala. Teraz możesz w pełni wykorzystać potencjał Drupala, budować, testować i rozwijać swój serwis lokalnie. Dzięki elastyczności ServBay łatwo zarządzasz różnymi wersjami PHP, bazami danych i innymi usługami — wszystko to pod ręką, by dopasować środowisko do wymagań projektu.