Instalacja i konfiguracja ExpressionEngine CMS w środowisku lokalnym ServBay

Przegląd

ExpressionEngine to potężny i elastyczny system zarządzania treścią (CMS), szeroko wykorzystywany do budowy złożonych stron internetowych i aplikacji webowych. Oferuje bogatą funkcjonalność oraz wysoce modułową architekturę, która pozwala deweloperom oraz projektantom na swobodne tworzenie i dostosowywanie witryn.

ServBay to środowisko lokalne do tworzenia aplikacji webowych zaprojektowane specjalnie dla macOS, które zapewnia kompleksowe rozwiązanie integrujące popularne serwery WWW (takie jak Nginx, Caddy, Apache), środowiska uruchomieniowe (PHP, Node.js, Python, Go, Java, Ruby, Rust, .NET), bazy danych (MySQL, PostgreSQL, MongoDB, Redis) oraz narzędzia deweloperskie (Composer, npm/yarn, phpMyAdmin/Adminer). Dzięki ServBay deweloperzy mogą łatwo zarządzać lokalnym środowiskiem programistycznym.

W tym przewodniku znajdziesz szczegółowe wskazówki, jak zainstalować i skonfigurować ExpressionEngine w ServBay, aby szybko wystartować z projektem ExpressionEngine.

Dlaczego warto zainstalować ExpressionEngine za pomocą ServBay?

Lokalna instalacja ExpressionEngine z wykorzystaniem ServBay oferuje następujące korzyści:

• Zintegrowane środowisko: ServBay zapewnia dedykowaną obsługę wymaganych środowisk, takich jak PHP, MySQL oraz serwer WWW – bez konieczności osobnej instalacji i ręcznej konfiguracji.
• Wsparcie dla wielu wersji: Możesz łatwo przełączać się między różnymi wersjami PHP zgodnie z wymaganiami ExpressionEngine.
• Wygodne zarządzanie bazą danych: ServBay zawiera wbudowane narzędzia phpMyAdmin lub Adminer do tworzenia i obsługi baz danych potrzebnych dla ExpressionEngine.
• Łatwa konfiguracja stron: Graficzny interfejs ServBay pozwala szybko tworzyć lokalne witryny i przypisywać je do katalogów projektów ExpressionEngine.
• Izolacja projektów: ServBay umożliwia tworzenie niezależnych konfiguracji dla każdego projektu, zapobiegając konfliktom środowiskowym między projektami.

Wymagania wstępne

Zanim rozpoczniesz instalację, upewnij się, że:

1. ServBay jest już zainstalowany i działa na Twoim systemie macOS. Jeśli nie, pobierz go z oficjalnej strony ServBay.
2. Posiadasz podstawową znajomość korzystania z terminala.
3. Rozumiesz podstawowe pojęcia związane z bazą danych (np. baza danych, użytkownik).
4. Domyślny katalog stron ServBay /Applications/ServBay/www ma ustawione prawa do zapisu.

Kroki instalacji

Instalacja i konfiguracja ExpressionEngine w ServBay obejmuje następujące etapy:

Krok 1: Przygotowanie katalogu projektu i pobranie ExpressionEngine

Otwórz terminal i przejdź do domyślnego katalogu stron ServBay /Applications/ServBay/www. Utwórz nowy katalog projektu, np. servbay-ee-app i wejdź do niego.

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

Następnie pobierz najnowszą wersję ExpressionEngine do bieżącego katalogu używając polecenia curl. Parametr -L pozwala na śledzenie przekierowań, a -o definiuje nazwę pliku wyjściowego.

curl -L https://expressionengine.com/latest -o expressionengine.zip

Krok 2: Rozpakowanie plików ExpressionEngine

Po zakończeniu pobierania rozpakuj plik expressionengine.zip w katalogu servbay-ee-app za pomocą polecenia unzip. Po ukończeniu możesz usunąć archiwum ZIP.

unzip expressionengine.zip
rm expressionengine.zip

Po rozpakowaniu zobaczysz strukturę plików ExpressionEngine w katalogu projektu.

Krok 3: Utworzenie bazy danych i użytkownika dla ExpressionEngine

ExpressionEngine wymaga bazy danych do przechowywania swoich danych i konfiguracji. ServBay oferuje MySQL oraz phpMyAdmin do wygodnego zarządzania bazą.

1. Dostęp do phpMyAdmin ServBay

   Otwórz przeglądarkę i przejdź do lokalnego centrum narzędzi ServBay: https://servbay.host/. Tam kliknij link „phpMyAdmin”, aby otworzyć stronę logowania. Użyj domyślnej nazwy użytkownika i hasła bazy danych ServBay (w przypadku czystej instalacji najczęściej wystarczy brak hasła dla localhost).

2. Tworzenie użytkownika i bazy danych

   Po zalogowaniu do phpMyAdmin utwórz osobnego użytkownika i bazę danych dla ExpressionEngine.

   • Przejdź do zakładki „Użytkownicy”: Na stronie głównej phpMyAdmin kliknij nawigację „Użytkownicy”.
   • Dodaj nowego użytkownika: Kliknij „Dodaj użytkownika”.
   • Uzupełnij dane użytkownika i bazy:
     • Nazwa użytkownika: np. ee_user, używana do połączenia z bazą ExpressionEngine.
     • Host: wybierz localhost (tylko lokalne połączenia, dla bezpieczeństwa).
     • Hasło: ustaw silne hasło do łączenia się z bazą przez ExpressionEngine. Zapamiętaj! Dla przykładu można użyć password123, ale w rzeczywistym środowisku wybierz mocniejsze hasło.
     • Powtórz hasło: Wpisz ponownie, by potwierdzić.
     • Utwórz bazę danych powiązaną z użytkownikiem: Zaznacz opcję „Utwórz bazę danych o tej samej nazwie i przyznaj wszystkie uprawnienia”. Utworzy to bazę o nazwie ee_user i nada pełne prawa temu użytkownikowi.
   • Weryfikacja uprawnień: Sprawdź, by w sekcji „Uprawnienia globalne” nie były zaznaczone niepotrzebne uprawnienia (wszystko, co potrzebne, zostało już nadane do bazy danych).
   • Zatwierdź: Na końcu strony kliknij „Wykonaj”, by utworzyć użytkownika oraz bazę.

   Gotowe: masz bazę danych ee_user oraz użytkownika ee_user z pełnym dostępem do tej bazy.

Krok 4: Konfiguracja witryny w ServBay

Musisz teraz wskazać ServBay, jak obsługiwać wybrany adres domenowy (np. servbay-ee.local) i kierować go na katalog projektu ExpressionEngine.

1. Otwórz ServBay i dodaj nową witrynę

   Uruchom graficzny interfejs ServBay. W panelu bocznym kliknij „Witryny”, a następnie przycisk „+” lub „Dodaj”, aby utworzyć nową konfigurację.

   • Nazwa (Name): np. My ExpressionEngine Site – łatwa do zidentyfikowania.
   • Domena (Domain): np. servbay-ee.local (ServBay automatycznie doda wpis do pliku hosts, wskazując na lokalny adres 127.0.0.1).
   • Typ witryny (Type): wybierz PHP (ExpressionEngine działa na PHP).
   • Wersja PHP (PHP Version): wybierz zgodną wersję z wymaganiami ExpressionEngine (ServBay obsługuje różne wersje).
   • Katalog główny witryny (Document Root): wskaż utworzony katalog projektu – /Applications/ServBay/www/servbay-ee-app.
   • Serwer WWW (Web Server): Wybierz dowolny wspierany przez ServBay serwer (Nginx, Caddy, Apache). Domyślne ustawienia z reguły wystarczą.

2. Zapisz i zastosuj zmiany

   Po wypełnieniu wszystkich pól kliknij „Zapisz” lub „Zastosuj”. ServBay może wymagać restartu serwera WWW, by załadować nową konfigurację – postępuj zgodnie z instrukcjami i poczekaj na zakończenie restartu.

   Od tej pory po wejściu w przeglądarce pod adres https://servbay-ee.local/ Twoja witryna zostanie poprawnie skierowana do katalogu projektu ExpressionEngine.

Krok 5: Uruchomienie instalatora ExpressionEngine przez przeglądarkę

ExpressionEngine oferuje instalator przez www, który przeprowadzi Cię przez końcową konfigurację.

1. Przejdź do strony instalatora

   Otwórz przeglądarkę, wpisz domenę skonfigurowaną w ServBay i dodaj plik startowy instalacji admin.php. Domyślnie jest to /admin.php.

   Przykładowy adres: https://servbay-ee.local/admin.php

   Powinien wyświetlić się ekran powitalny lub kreator instalacji ExpressionEngine.

2. Wypełnij kolejne etapy kreatora

   Instalator poprosi o następujące informacje:

   • Dane połączenia z bazą danych:
     • Host bazy danych: localhost
     • Nazwa bazy: ee_user (utworzona w kroku 3)
     • Użytkownik bazy danych: ee_user (utworzony w kroku 3)
     • Hasło bazy danych: wpisz hasło zdefiniowane dla użytkownika ee_user
   • Dane konta administratora: Utwórz konto superadministratora panelu EE (nazwa użytkownika, hasło, email). Użyj bezpiecznego hasła!
   • Konfiguracja witryny: Nazwa strony, URL i inne dane podstawowe.

3. Zakończ instalację

   Zweryfikuj wszystkie informacje i kliknij „Instaluj” lub przycisk kończący kreator. ExpressionEngine utworzy wszystkie niezbędne tabele bazy danych i zakończy podstawową konfigurację.

   Po wszystkim powinieneś zostać przekierowany do strony logowania lub panelu administracyjnego.

Krok 6: Podstawowa konfiguracja po instalacji

Gdy ExpressionEngine jest już zainstalowany, możesz kontynuować konfigurację, instalować dodatki i szablony.

1. Zaloguj się do panelu ExpressionEngine

   Wejdź pod https://servbay-ee.local/admin.php i zaloguj się danymi administratora utworzonymi podczas instalacji.

2. Instalacja dodatków

   W panelu Admin przejdź do „Developer” -> „Add-Ons” -> „Plugins”. Przeglądaj dostępne wtyczki i instaluj te, które są potrzebne do projektu.

3. Instalacja i konfiguracja szablonów

   Przejdź do „Design” -> „Templates”. Tutaj możesz tworzyć grupy szablonów, dodawać nowe template i pisać własny kod HTML/CSS/EE wyświetlający zawartość witryny.

Tworzenie strony w ExpressionEngine

Masz już zainstalowany i skonfigurowany ExpressionEngine w ServBay. Możesz rozpocząć budowę i zarządzanie swoją stroną. Przykładowe podstawowe działania:

Tworzenie kanałów i wpisów

Sercem ExpressionEngine są „kanały” oraz „wpisy”. Kanały definiują strukturę oraz rodzaje treści, a wpisy są ich konkretnymi instancjami.

1. Tworzenie kanału: W panelu admina przejdź do „Content Structure” -> „Channels”. Kliknij „Create New Channel”, uzupełnij nazwę, przypisz zbiory pól (Fields Group) i kliknij „Save Channel”.
2. Dodawanie wpisów: Przejdź do „Content” -> „Publish”. Wybierz utworzony kanał, podaj tytuł wpisu i resztę treści (zgodnie z polami zdefiniowanymi w kanale), na końcu kliknij „Save”.

Konfiguracja menu nawigacyjnego

Menu zwykle buduje się za pomocą szablonów.

1. Tworzenie/edycja szablonu: W „Design” -> „Templates” stwórz lub edytuj szablon dla nawigacji strony (możesz np. utworzyć template nav w grupie site).
2. Pisanie kodu nawigacji: Użyj znaczników szablonów ExpressionEngine w celu pobrania wpisów kanału lub stron i wygenerowania kodu HTML menu.
3. Włącz nawigację do layoutu: W głównym szablonie układu strony wstaw {% include 'site:nav' %} (jeżeli używasz silnika Blade) lub inną stosowną komendę.

Własne widgety (boczne paski)

Podobnie jak nawigację, widgety i sidebar'y zwykle obsługuje się przez dedykowane szablony.

1. Stwórz szablon widgetu: W „Design” -> „Templates” dodaj template np. site:sidebar.
2. Dodaj kod widgetu: Wstaw kod prezentujący np. najnowsze wpisy, listę kategorii, reklamy itd.
3. Wstaw widget do layoutu: Wstaw szablon widgetu w wybranym miejscu layoutu strony.

Często zadawane pytania (FAQ)

• Pytanie: Co zrobić, gdy po wejściu na https://servbay-ee.local/ pojawia się błąd uprawnień?
  • Odpowiedź: Sprawdź uprawnienia do katalogu projektu ExpressionEngine (/Applications/ServBay/www/servbay-ee-app) oraz jego podkatalogów i plików. Użytkownik, pod którym działa ServBay (zwykle Twoje konto), musi mieć prawo do odczytu i zapisu. Użyj chmod lub chown, np. sudo chown -R yourusername:yourgroup /Applications/ServBay/www/servbay-ee-app.
• Pytanie: Instalator ExpressionEngine nie może połączyć się z bazą danych. Dlaczego?
  • Odpowiedź: Sprawdź dokładnie dane wpisywane do instalatora (host: localhost, nazwa bazy, użytkownik, hasło) – muszą odpowiadać tym, które utworzyłeś w phpMyAdmin. Dodatkowo upewnij się, że MySQL/MariaDB w ServBay działa.
• Pytanie: Czy mogę użyć innych baz danych ServBay (np. PostgreSQL)?
  • Odpowiedź: ExpressionEngine domyślnie obsługuje MySQL/MariaDB. Jeśli oficjalna dokumentacja EE przewiduje wsparcie dla PostgreSQL oraz dysponujesz odpowiednimi sterownikami i konfiguracją, możesz spróbować użyć PostgreSQL dostępnego w ServBay – wszystko zależy jednak od kompatybilności ExpressionEngine. Sprawdź dokumentację EE, by poznać obsługiwane typy baz danych.

Podsumowanie

Postępując zgodnie z tym poradnikiem, powinieneś być w stanie sprawnie zainstalować i skonfigurować ExpressionEngine CMS w lokalnym środowisku ServBay. ServBay zapewnia szybkie i wygodne środowisko do lokalnego rozwoju z pełną integracją wszystkich potrzebnych komponentów. Od teraz możesz wykorzystać potencjał ExpressionEngine do budowy własnych stron czy aplikacji webowych. Powodzenia w tworzeniu!