Instalacja i konfiguracja Bedrock w środowisku ServBay

Przegląd

Ten dokument poprowadzi Cię krok po kroku, jak zainstalować i skonfigurować Bedrock w lokalnym środowisku developerskim ServBay. Bedrock to nowoczesna struktura projektowa WordPress, która korzysta z Composer do zarządzania zależnościami, optymalizuje zarządzanie konfiguracją i wdraża najlepsze praktyki, zwiększając efektywność i bezpieczeństwo pracy z projektami WordPress. Korzystając z zaawansowanych i łatwych w użyciu narzędzi zarządzania środowiskiem lokalnym ServBay, możesz szybko postawić środowisko developerskie Bedrock.

Czym jest Bedrock?

Bedrock to struktura projektowa WordPress stworzona przez zespół Roots, mająca na celu poprawę doświadczenia deweloperskiego. Różni się znacząco od tradycyjnej struktury WordPress – główne cechy to:

• Zarządzanie zależnościami przez Composer: Rdzeń WordPressa, motywy i wtyczki mogą być zarządzane przez Composer, co upraszcza proces aktualizacji i rozwiązywania konfliktów zależności.
• Ulepszone zarządzanie konfiguracją: Bazując na zasadach Twelve-Factor App, zmienne środowiskowe są przechowywane w pliku .env, co oddziela konfigurację od kodu, czyniąc go bardziej bezpiecznym i elastycznym.
• Lepsza organizacja projektu: Rdzeń WordPressa znajduje się w dedykowanym podkatalogu (web/wp), a motywy i wtyczki w katalogu web/app, co poprawia przejrzystość struktury.
• Zwiększone bezpieczeństwo: Domyślnie zaimplementowane są dodatkowe środki bezpieczeństwa, takie jak ukrywanie ścieżek do plików rdzenia.

Bedrock to świetny wybór do budowy solidnych, łatwych w utrzymaniu i nowoczesnych aplikacji WordPress.

Dlaczego warto korzystać z ServBay do developmentu z Bedrock?

ServBay to narzędzie środowiska lokalnego przeznaczone dla macOS, integrujące popularne serwery WWW (Caddy/Nginx/Apache), wiele wersji PHP, bazy danych (MySQL/PostgreSQL/MongoDB) oraz środowiska Node.js, Python, Go, Java i inne. Używając ServBay w połączeniu z Bedrockiem, zyskujesz:

• Szybka instalacja środowiska: ServBay ma preinstalowane wszystkie wymagania Bedrocka, jak PHP, Composer i bazy danych — nie musisz instalować ich oddzielnie.
• Elastyczne zarządzanie wersjami: Łatwo przełączaj się między wersjami PHP i testuj zgodność Bedrocka z różnymi wersjami PHP.
• Zintegrowane zarządzanie bazą danych: Twórz i zarządzaj bazą danych dla Bedrocka za pomocą wbudowanego phpMyAdmin lub Adminer.
• Łatwa konfiguracja witryn: Szybko skonfigurujesz witrynę Bedrock (wirtualny host) przez graficzny interfejs ServBay, wskazując poprawny katalog główny witryny.
• Zarządzanie w jednym miejscu: Zarządzaj wszystkimi pakietami i stronami potrzebnymi do lokalnego developmentu w jednej aplikacji.

Wymagania wstępne

Przed rozpoczęciem upewnij się, że spełniasz następujące warunki:

• ServBay jest zainstalowany i uruchomiony na Twoim macOS.
• Masz podstawową znajomość obsługi terminala (wiersza poleceń).
• Wiesz, czym jest Composer (w tym przewodniku znajdziesz konkretne polecenia).

Kroki instalacji Bedrock

W tej części szczegółowo opisano, jak zainstalować i skonfigurować projekt Bedrock w środowisku ServBay.

Krok 1: Utwórz katalog projektu

Najpierw przejdź do domyślnego katalogu głównego stron ServBay /Applications/ServBay/www i stwórz nowy katalog dla projektu. Zalecamy nadanie mu opisowej nazwy, np. servbay-bedrock-app.

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

Ten katalog będzie głównym katalogiem Twojego projektu Bedrock.

Krok 2: Utwórz projekt Bedrock przez Composer

ServBay dostarcza Composer, więc możesz używać polecenia composer bezpośrednio w terminalu. W katalogu projektu (/Applications/ServBay/www/servbay-bedrock-app) uruchom następujące polecenie Composer, aby utworzyć projekt Bedrock:

composer create-project roots/bedrock .

To polecenie pobierze najnowszą wersję Bedrock oraz wszystkie jego zależności do bieżącego katalogu (.). Ten proces może potrwać kilka minut w zależności od szybkości Twojego internetu.

Krok 3: Utwórz bazę danych i użytkownika

Bedrock i WordPress wymagają bazy danych do przechowywania treści i ustawień. Skorzystamy z wbudowanego w ServBay phpMyAdmin do utworzenia bazy i odpowiedniego użytkownika.

1. Przejdź do phpMyAdmin w ServBay

   Otwórz przeglądarkę i przejdź pod domyślny adres ServBay: https://servbay.host/. Na stronie powitalnej ServBay znajdziesz link „phpMyAdmin” — kliknij go, aby wejść do narzędzia zarządzania bazą danych.

2. Stwórz użytkownika bazy danych

   Dla bezpieczeństwa i przejrzystości zaleca się utworzenie osobnego użytkownika i bazy danych dla każdego projektu.

   1. Wejdź do zakładki użytkowników

      W głównej stronie phpMyAdmin kliknij w menu na górze „Użytkownicy”.

   2. Dodaj nowego użytkownika

      Kliknij „Dodaj użytkownika”. Wypełnij dane:

      • Nazwa użytkownika: Podaj nazwę użytkownika bazy dla tego projektu, np. bedrock_user.
      • Host: Wybierz localhost. Ten użytkownik będzie mógł się łączyć wyłącznie lokalnie.
      • Hasło: Wpisz bezpieczne hasło dla tego użytkownika. Zapisz je — przykładowo do testów lokalnych możesz użyć password123, ale w środowisku produkcyjnym koniecznie użyj silnego hasła.
      • Powtórz hasło: Wprowadź ponownie swoje hasło.

      W sekcji „Stwórz bazę danych o tej samej nazwie i nadaj wszystkie uprawnienia” wybierz tę opcję. Dzięki temu automatycznie utworzy się baza bedrock_user i przypisane zostaną jej wszystkie uprawnienia.

      Upewnij się, że zaznaczone jest pole „Przyznaj wszystkie uprawnienia”, aby użytkownik miał pełną kontrolę nad nową bazą danych.

      Na dole strony kliknij „Wykonaj”, by zakończyć proces tworzenia użytkownika i bazy danych.

Krok 4: Konfiguracja Bedrock

Bedrock używa zmiennych środowiskowych do zarządzania konfiguracją — zwykle są one przechowywane w pliku .env w katalogu głównym projektu.

1. Edytuj plik konfiguracyjny środowiska

   W katalogu głównym projektu Bedrock (/Applications/ServBay/www/servbay-bedrock-app) znajdziesz przykładowy plik o nazwie .env.example. Skopiuj go i zmień nazwę na .env:

   cp .env.example .env

   Plik .env służy do faktycznej konfiguracji projektu, .env.example to tylko przykład i nie zawiera poufnych danych.

2. Zmodyfikuj plik .env

   Otwórz świeżo skopiowany plik .env w edytorze tekstowym (np. VS Code, Sublime Text, Nano itd.). Odszukaj sekcję konfiguracji bazy danych i zmień dane na te, które ustawiłeś w punkcie 3:

   # Database
   DB_NAME='bedrock_user' # Nazwa bazy danych – taka sama jak nazwa użytkownika
   DB_USER='bedrock_user' # Użytkownik bazy danych
   DB_PASSWORD='password123' # Hasło do bazy danych
   DB_HOST='localhost' # Adres serwera bazy danych, lokalnie zwykle localhost
   DB_PREFIX='wp_' # Prefiks tabel, możesz zostawić domyślnie lub zmienić
   
   # WordPress Environment
   WP_ENV='development' # Bieżące środowisko: development, staging, production
   
   # Site URLs
   WP_HOME='http://servbay-bedrock.local' # Pełny URL strony
   WP_SITEURL='${WP_HOME}/wp' # URL katalogu z plikami WordPressa

   Zmień te wartości zgodnie ze swoimi ustawieniami (szczególnie DB_PASSWORD powinno odpowiadać hasłu wybranemu w phpMyAdmin).

   WP_HOME i WP_SITEURL definiują, pod jakim adresem dostępna będzie strona w przeglądarce. servbay-bedrock.local to typowa domena lokalna – możesz ją zmienić wg uznania. WP_SITEURL powinno wskazywać na katalog web/wp.

   W pliku .env możesz również skonfigurować inne ustawienia Bedrock i WordPress, jak stałe, ustawienia poczty itd.

Krok 5: Konfiguracja serwera WWW (witryny ServBay)

Aby serwer WWW w ServBay poprawnie obsługiwał Twój projekt Bedrock, musisz dodać nową stronę (wirtualny host) w aplikacji ServBay.

1. Dodaj nową stronę

   Otwórz aplikację ServBay, przejdź do zakładki „Witryny” po lewej stronie. Kliknij przycisk „+” lub „Dodaj witrynę”, by utworzyć nową konfigurację. Wypełnij następujące pola:

   • Nazwa: Nadaj stronie rozpoznawalną nazwę — np. My Bedrock Site. Ta nazwa służy tylko do zarządzania w ServBay.
   • Domena: Wpisz domenę ustawioną w pliku .env jako WP_HOME, np. servbay-bedrock.local. ServBay automatycznie zmapuje ją na lokalny adres (127.0.0.1).
   • Typ strony: Wybierz PHP.
   • Wersja PHP: Wybierz wersję PHP kompatybilną z Bedrockiem — zalecamy najnowszą stabilną wersję dostępną w ServBay.
   • Katalog główny strony: To bardzo ważny krok. Katalog główny Bedrocka to nie jest katalog projektu, tylko podkatalog web – ustaw jako /Applications/ServBay/www/servbay-bedrock-app/web.

2. Zapisz konfigurację

   Po wypełnieniu wszystkich danych kliknij „Zapisz”. ServBay automatycznie zaktualizuje konfigurację serwera WWW. Jeśli pojawi się informacja o konieczności restartu usług, wykonaj zalecane czynności.

Krok 6: Dokończ instalację WordPressa

Twój projekt Bedrock jest już skonfigurowany, a strona w ServBay gotowa. Teraz możesz przejść przez tradycyjny kreator instalacji WordPressa.

1. Przejdź na stronę instalacji

   Otwórz przeglądarkę i wpisz adres ustawiony w pliku .env i konfiguracji ServBay jako WP_SITEURL, np. http://servbay-bedrock.local/wp. Jeśli wszystko jest ustawione poprawnie, pojawi się instalator WordPressa.

2. Wprowadź dane bazy danych

   Kreator instalacji WordPress poprosi o dane dostępowe do bazy danych. Wprowadź dane utworzone w kroku trzecim:

   • Nazwa bazy danych: bedrock_user (taka jak użytkownik)
   • Użytkownik: bedrock_user
   • Hasło: Twoje hasło (password123 lub inne ustawione wcześniej)
   • Host bazy danych: localhost
   • Prefiks tabel: wp_ (zazwyczaj pozostaw domyślnie, chyba że chcesz inaczej)

   Kliknij „Prześlij” (lub odpowiednik w Twojej wersji językowej). WordPress przystąpi do łączenia z bazą.

3. Uzupełnij dane strony

   Po połączeniu z bazą przejdziesz do ustawień strony. Wypełnij:

   • Tytuł strony: Nazwa Twojej nowej witryny.
   • Nazwa użytkownika: Login administratora.
   • Hasło: Mocne hasło administratora.
   • E-mail administratora: Adres e-mail administratora.
   • Widoczność dla wyszukiwarek: Na środowisku lokalnym zaleca się zaznaczyć „Zablokuj dla wyszukiwarek”.

4. Zakończ instalację

   Kliknij „Zainstaluj WordPress”. Instalator utworzy niezbędne tabele w bazie danych, a po udanej instalacji zobaczysz stronę z potwierdzeniem i link do logowania do panelu administratora WordPress.

Krok 7: Instalacja motywów i wtyczek (przez Composer)

Bedrock zaleca zarządzanie motywami i wtyczkami przez Composer zamiast przez panel administratora WordPress.

1. Znajdź pakiet motywu/wtyczki do Composer

   Wiele popularnych motywów i wtyczek dostępnych jest jako pakiety Composer, m.in. poprzez Packagist (packagist.org) lub WordPress Packagist (wpackagist.org). Ich nazwy mają zwykle format vendor/package-name, np. wpackagist-theme/twentytwentyone lub wpackagist-plugin/wordpress-seo.

2. Zainstaluj przez Composer

   Będąc w katalogu głównym projektu Bedrock (/Applications/ServBay/www/servbay-bedrock-app), użyj polecenia Composer, aby zainstalować motyw lub wtyczkę.

   Instalacja motywu:

   composer require wpackagist-theme/your-theme-name

   Instalacja wtyczki:

   composer require wpackagist-plugin/your-plugin-name

   Zastąp your-theme-name i your-plugin-name właściwymi nazwami pakietów. Motywy trafią do katalogu web/app/themes, wtyczki do web/app/plugins.

3. Włącz w panelu WordPress

   Zaloguj się do panelu administratora WordPress (http://servbay-bedrock.local/wp/wp-admin/) i:

   • Motywy: kliknij „Wygląd” → „Motywy”, znajdź zainstalowany i włącz.
   • Wtyczki: kliknij „Wtyczki” → „Zainstalowane wtyczki”, znajdź i włącz wybraną.

   Chociaż Bedrock umożliwia instalację przez Composer, możesz także instalować motywy i wtyczki z poziomu panelu (jako pliki .zip), ale Composer to rekomendowany i bardziej nowoczesny sposób zarządzania.

Tworzenie strony w oparciu o Bedrock

Teraz masz zainstalowanego i skonfigurowanego Bedrocka w środowisku ServBay. Możesz zacząć budować swoją stronę jak w standardowym WordPressie, korzystając z nowoczesnych zalet, jakie zapewnia Bedrock:

• Tworzenie stron i wpisów: Zaloguj się do panelu WordPress, twórz nowe treści w zakładkach „Strony” i „Wpisy” – wszystko jak w zwykłym WordPressie.
• Konfiguracja menu nawigacyjnych: Ustaw menu w „Wygląd” → „Menu”.
• Zarządzanie widgetami: Zmieniaj zawartość sidebarów i innych obszarów w „Wygląd” → „Widgety”.
• Rozwój motywów i wtyczek: Jako deweloper możesz bezpośrednio pracować w katalogach web/app/themes i web/app/plugins.
• Zarządzanie konfiguracją: Ustawiaj konfigurację dla różnych środowisk (development, staging, produkcja) korzystając z pliku .env.

Najczęściej zadawane pytania (FAQ)

• P: Co zrobić, gdy pod adresem http://servbay-bedrock.local pojawia się błąd 404?
  • O: Sprawdź, czy domena ustawiona w konfiguracji ServBay jest zgodna z używaną w przeglądarce.
  • O: Sprawdź, czy katalog główny strony w ServBay to /Applications/ServBay/www/servbay-bedrock-app/web.
  • O: Upewnij się, że serwer WWW w ServBay działa.
  • O: Sprawdź poprawność ustawienia WP_HOME w pliku .env.
• P: Co zrobić, gdy pod adresem http://servbay-bedrock.local/wp pojawia się błąd połączenia z bazą danych?
  • O: Upewnij się, że w .env dane DB_NAME, DB_USER, DB_PASSWORD, DB_HOST odpowiadają tym, które zostały ustawione w phpMyAdmin.
  • O: Sprawdź, czy serwis MySQL (lub wybrana baza danych) w ServBay jest uruchomiony.
  • O: Upewnij się, że utworzony w phpMyAdmin użytkownik ma wszystkie uprawnienia do odpowiedniej bazy.
• P: Dlaczego po instalacji motywu/wtyczki nie widzę ich w panelu WordPress?
  • O: Jeśli instalowałeś przez Composer, upewnij się, że polecenia composer install lub composer require zostały wykonane w katalogu projektu (/Applications/ServBay/www/servbay-bedrock-app) i zakończyły się powodzeniem.
  • O: Motywy zainstalowane przez Composer znajdują się w web/app/themes, a wtyczki w web/app/plugins. Sprawdź, czy w tych katalogach obecne są odpowiednie pliki.
  • O: W panelu WordPress znajdź i włącz motyw w „Wygląd” → „Motywy”, a wtyczkę w „Wtyczki” → „Zainstalowane wtyczki”.
• P: Jak zaktualizować Bedrock, rdzeń WordPressa, motywy lub wtyczki?
  • O: Ponieważ Bedrock korzysta z Composer, aktualizację wykonasz poleceniem composer update w katalogu projektu, lub composer update vendor/package-name dla konkretnego motywu/wtyczki. Po aktualizacji może być konieczne wykonanie aktualizacji bazy poprzez panel WordPress (jeśli będzie to wymagane).

Podsumowanie

Po wykonaniu powyższych kroków masz w pełni działający projekt Bedrock w lokalnym środowisku programistycznym ServBay. Łącząc wygodne zarządzanie środowiskiem przez ServBay z nowoczesnym workflow Bedrocka, możesz rozwijać i utrzymywać projekty WordPress szybciej oraz bezpieczniej. Rozpocznij budowę swojej kolejnej strony WordPress wykorzystując pełnię możliwości Bedrocka!