Instalacja i konfiguracja Craft CMS w środowisku ServBay

Przegląd

Craft CMS to zaawansowany system zarządzania treścią (CMS), ceniony przez deweloperów za elastyczne modelowanie danych, intuicyjny interfejs i przyjazne dla programistów funkcje. Doskonale sprawdza się przy tworzeniu zaawansowanych i spersonalizowanych stron internetowych.

Wykorzystanie ServBay jako lokalnego środowiska dla Craft CMS niesie ze sobą wiele korzyści, m.in. przygotowany zestaw technologii takich jak PHP, bazy danych (np. MySQL lub PostgreSQL), serwer WWW (Caddy lub Nginx) oraz wbudowany Composer i narzędzia CLI, co znacznie upraszcza proces instalacji i konfiguracji.

W tym przewodniku krok po kroku zostanie opisane, jak zainstalować i skonfigurować projekt Craft CMS w środowisku ServBay.

Wymagania wstępne

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

1. ServBay jest zainstalowany i uruchomiony: Upewnij się, że ServBay został poprawnie zainstalowany na Twoim macOS i że wybrana wersja PHP (Craft CMS ma określone wymagania – sprawdź dokumentację Craft CMS) oraz baza danych (najczęściej MySQL lub PostgreSQL) są aktywne. ServBay umożliwia wygodną zmianę i konfigurację wielu wersji PHP oraz baz danych według wymagań Craft CMS.
2. Znajomość podstaw obsługi terminala: Będziesz potrzebować terminala do wykonywania poleceń, takich jak tworzenie katalogów oraz uruchamianie Composera.
3. Podstawy Composera: Craft CMS zarządza zależnościami za pomocą Composera. Choć ServBay ma wbudowanego Composera, powinieneś wiedzieć, jak użyć polecenia composer create-project.

Kroki instalacji Craft CMS

Poniżej znajdziesz szczegółowe instrukcje, jak zainstalować i skonfigurować Craft CMS w ServBay.

Krok 1: Utwórz katalog projektu

Na początek utwórz nowy katalog projektu w domyślnym katalogu stron ServBay /Applications/ServBay/www. ServBay ustawia ten katalog jako główny katalog serwera WWW, co umożliwia bezpośredni dostęp do stron.

Otwórz terminal i wykonaj polecenia:

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

Powyższe komendy utworzą katalog servbay-craft-app w /Applications/ServBay/www i przeniosą Cię do niego.

Krok 2: Utworzenie projektu Craft CMS przy użyciu Composera

ServBay zawiera już Composera, więc możesz użyć go bezpośrednio w katalogu projektu. Oficjalnym, rekomendowanym sposobem instalacji Craft CMS jest użycie Composera.

Będąc w folderze servbay-craft-app, wpisz:

composer create-project craftcms/craft .

To polecenie pobierze najnowszą wersję Craft CMS z wszystkimi wymaganymi zależnościami do katalogu bieżącego (.). Zaczekaj aż proces pobierania i instalacji dobiegnie końca.

Krok 3: Tworzenie bazy danych i użytkownika

Craft CMS wymaga bazy danych na potrzeby przechowywania treści i ustawień. Skorzystaj z dołączonych przez ServBay narzędzi phpMyAdmin lub Adminer, aby utworzyć bazę oraz użytkownika. W tym przykładzie opisujemy użycie phpMyAdmin.

1. Dostęp do phpMyAdmin w ServBay

   Otwórz przeglądarkę i przejdź do panelu developerskiego ServBay https://servbay.host/. Znajdź i kliknij link „phpMyAdmin”, aby uruchomić narzędzie do zarządzania bazą danych.

   Porada: Domyślny login do phpMyAdmin to zazwyczaj root, hasło ServBay.dev. Z powodów bezpieczeństwa zaleca się niezwłocznie zmienić hasło do konta root lub utworzyć osobnego użytkownika do zarządzania.

2. Tworzenie użytkownika bazy danych

   Choć technicznie możesz użyć konta root do połączenia Craft CMS z bazą danych, zalecaną praktyką (ze względów bezpieczeństwa i zarządzania uprawnieniami) jest utworzenie osobnego użytkownika dla każdej aplikacji.

   1. Przejdź do zarządzania użytkownikami

      W głównym oknie phpMyAdmin kliknij zakładkę „Użytkownicy” w górnym menu.

   2. Dodaj nowego użytkownika

      Wybierz „Dodaj użytkownika” i uzupełnij poniższe pola:

      • Nazwa użytkownika: np. craft_user – login dla Craft CMS.
      • Host: Wybierz localhost lub local, dzięki czemu użytkownik będzie mógł się łączyć tylko lokalnie.
      • Hasło: Wprowadź bezpieczne hasło. Nie używaj przykładowego password123, zwłaszcza w środowiskach produkcyjnych. W środowisku developerskim hasło może być prostsze, ale zachowaj zasady bezpieczeństwa.
      • Powtórz hasło: Wpisz to samo hasło ponownie.
      • W sekcji „Baza danych dla użytkownika” zaznacz „Utwórz bazę danych o tej samej nazwie i przyznaj wszystkie uprawnienia”. Dzięki tej opcji automatycznie powstanie baza danych craft_user z pełnymi uprawnieniami dla nowego użytkownika.
      • Upewnij się, że pole „Przyznaj wszystkie uprawnienia” jest zaznaczone.
      • Kliknij „Wykonaj” na dole strony.

   Konto użytkownika craft_user oraz o tej samej nazwie baza danych zostaną utworzone i skonfigurowane z odpowiednimi uprawnieniami.

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

Aby serwer WWW ServBay (Caddy lub Nginx) obsługiwał Twój projekt Craft CMS, musisz dodać nową stronę w panelu ServBay.

1. Uruchom aplikację ServBay

   Otwórz program ServBay.

2. Dodawanie nowej strony

   W lewym panelu wybierz zakładkę „Strony” (w starszych wersjach: „Hosty”). Następnie kliknij ikonę „+” lub przycisk „Dodaj stronę”, aby dodać nową konfigurację strony.

   Uzupełnij poniższe pola:

   • Nazwa: wymyśl łatwą do identyfikacji nazwę, np. My Craft Site.
   • Domena: wpisz adres, pod którym lokalnie będziesz odwiedzał serwis, np. servbay-craft.local. ServBay skonfiguruje automatycznie lokalny DNS.
   • Typ: wybierz PHP.
   • Wersja PHP: wskaż kompatybilną wersję PHP (sprawdzoną na etapie wymagań wstępnych). ServBay umożliwia instalację i obsługę wielu wersji PHP jednocześnie.
   • Root strony: To kluczowy krok — pliki publicznie dostępne Craft CMS (np. index.php) znajdują się w podkatalogu web w katalogu projektu. Dla bezpieczeństwa root serwera powinien być ustawiony dokładnie na ten folder, nie na cały projekt. Wpisz ścieżkę: /Applications/ServBay/www/servbay-craft-app/web Upewnij się, że wskazujesz folder web utworzony w kroku 1.

3. Zapisz konfigurację

   Po wypełnieniu pól kliknij „Zapisz”. ServBay przeładuje konfiguracje serwera WWW, by uaktywnić nową stronę. Pojawi się ona na liście stron jako servbay-craft.local.

Krok 5: Uruchomienie instalatora Craft CMS

Teraz możesz przejść do przeglądarki i uruchomić instalator Craft CMS pod wybraną przez siebie domeną.

1. Wejście na stronę instalacji

   Odwiedź w przeglądarce adres https://servbay-craft.local/. Craft CMS wykryje brak instalacji i automatycznie przekieruje Cię na stronę instalatora (najczęściej https://servbay-craft.local/index.php?p=admin/install).

2. Uzupełnienie danych do bazy danych

   Podczas kroku konfiguracji bazy danych wpisz dane wybrane w kroku 3:

   • Serwer bazy danych: localhost
   • Nazwa bazy: craft_user (lub nazwa, którą ustawiłeś)
   • Użytkownik: craft_user (lub login użytkownika z kroku 3)
   • Hasło: hasło podane przy tworzeniu użytkownika.

   Kliknij dalej. Jeśli połączenie zakończy się sukcesem, przejdziesz do następnego kroku.

3. Tworzenie konta administratora

   Postępuj zgodnie z instrukcjami i utwórz konto administratora Craft CMS: wybierz nazwę użytkownika, hasło oraz adres e-mail. Zadbaj o bezpieczne hasło.

   Przejdź do kolejnego kroku.

4. Ustawienia witryny

   Wypełnij podstawowe dane strony, takie jak nazwa serwisu.

   Kliknij „Zakończ instalację (Finish Up)”. Rozpocznie się końcowy etap instalacji: utworzenie tabel bazy danych i zapisanie konfiguracji.

   Po zakończeniu zostaniesz przekierowany do strony logowania w panelu administracyjnym Craft CMS.

Krok 6: Wstępna konfiguracja i eksploracja

Po zalogowaniu do panelu administracyjnego Craft CMS możesz rozpocząć konfigurację oraz przegląd systemu:

1. Sprawdź plik .env: Craft CMS wykorzystuje plik .env do zarządzania zmiennymi środowiskowymi, w tym danymi dostępowymi do bazy. Instalator automatycznie utworzy ten plik w katalogu głównym projektu (servbay-craft-app/). Możesz tutaj np. ustawić CRAFT_ENVIRONMENT na dev.
2. Instalacja wtyczek: W panelu przejdź do sekcji „Wtyczki (Plugins)”, gdzie możesz przeglądać, instalować i konfigurować dodatki Craft CMS.
3. Tworzenie struktury treści: W zakładce „Ustawienia (Settings)” zdefiniujesz pola, sekcje (Sections), kategorie (Categories), tagi (Tags) i inne elementy struktury treści.
4. Konfiguracja wysyłki e-maili: Aby przetestować wysyłkę maili lokalnie, możesz ustawić Craft CMS do korzystania z wbudowanego Mailpit lub Mailhog w ServBay. W pliku .env lub ustawieniach panelu wybierz tryb SMTP, ustaw serwer na localhost, a port na ten podany w panelu ServBay dla Mailpit/Mailhog.

Najczęstsze pytania (FAQ)

• P: Co zrobić, jeśli podczas instalacji pojawia się błąd połączenia z bazą danych?
  • Odpowiedź: Upewnij się, że adres serwera bazy (localhost), nazwa bazy, użytkownik i hasło są zgodne z tym, co zostało ustawione w phpMyAdmin. Sprawdź także, czy usługa bazy danych (MySQL lub PostgreSQL) jest uruchomiona w ServBay.
• P: Po wejściu na servbay-craft.local wyświetla się błąd 404 lub pusta strona?
  • Odpowiedź:
    • Sprawdź, czy root strony w ServBay jest poprawnie ustawiony na /Applications/ServBay/www/servbay-craft-app/web. To najczęstsza przyczyna problemów.
    • Upewnij się, że serwer WWW (Caddy/Nginx) oraz PHP są uruchomione.
    • Sprawdź w panelu ServBay, czy strona servbay-craft.local jest aktywna.
• P: Composer działa bardzo wolno lub nie pobiera Craft CMS?
  • Odpowiedź: Prawdopodobnie to problem z siecią lub używanym mirror’em Composera. Możesz spróbować ustawić mirror na krajowy – na przykład Aliyun lub Packagist China.
• P: Po instalacji panele administracyjne bądź frontend wyglądają źle/styl CSS lub zdjęcia się nie wczytują?
  • Odpowiedź: To zazwyczaj wynik błędnych uprawnień do plików. Upewnij się, że użytkownik ServBay ma prawa zapisu do folderów storage i web/cpresources. ServBay najczęściej ustawia je automatycznie, lecz w razie problemów sprawdź ręcznie uprawnienia lub je zresetuj.

Podsumowanie

Po przejściu przez powyższe kroki powinieneś mieć zainstalowany i skonfigurowany Craft CMS w lokalnym środowisku ServBay. Integracja narzędzi ServBay znacznie upraszcza zarządzanie wersjami PHP, konfiguracją baz danych i serwera WWW, dzięki czemu możesz w pełni skupić się na pracy z Craft CMS. Teraz możesz korzystać z elastycznego modelowania treści Craft CMS, budując własną stronę lub aplikację!