Instalacja PrestaShop na komputerze lokalnie: przewodnik po localhost

PrestaShop na localhost służy do nauki, testowania modułów i konfiguracji motywu bez ingerowania w sklep produkcyjny. Localhost oznacza adres komputera, na którym działa lokalny serwer, zwykle dostępny pod `http://localhost` lub `http://127.0.0.1`.

Dokumentacja PrestaShop opisuje instalację lokalną jako sposób testowania kodu bez przesyłania plików na serwer online i bez ryzyka uszkodzenia produkcyjnego sklepu. Localhost nie zastępuje hostingu produkcyjnego, testów płatności u operatora ani kontroli działania na docelowym serwerze.

Lokalny sklep przydaje się, gdy chcesz:
- sprawdzić moduł przed instalacją na stronie firmowej;
- przetestować motyw lub zmianę szablonu;
- odtworzyć błąd na kopii danych;
- poznać panel administracyjny.

Jeśli porównujesz platformy przed uruchomieniem sprzedaży, przeczytaj WooCommerce i Shopify: koszty, obsługa i integracje. Gdy rozważasz zmianę platformy po testach, realizacja sklepu internetowego na WooCommerce dotyczy właśnie tego rozwiązania.

Komputer musi uruchomić serwer WWW, obsługiwaną wersję PHP i bazę MySQL lub MariaDB zgodne z konkretnym wydaniem PrestaShop. Dokumentacja producenta wskazuje MySQL 5.7 lub MariaDB 10.2 jako minima, `memory_limit` minimum 512M jako rekomendację oraz Apache 2.4 lub nowszy; PrestaShop może też działać z Nginx 1.0 lub nowszym.

Tabela zgodności PrestaShop rozróżnia wydania 9.0 i 9.1: wydanie 9.0 obsługuje PHP od 8.1 do 8.4, a wydanie 9.1 obsługuje PHP od 8.1 do 8.5. Dokumentacja rekomenduje PHP 8.4 dla 9.0 i PHP 8.5 dla 9.1. Wymagane rozszerzenia obejmują między innymi cURL, DOM, fileinfo, GD, intl, mbstring, OpenSSL, PDO MySQL, SimpleXML i Zip.

Wybierz wersję PHP według numeru wydania sklepu i sprawdź, czy serwer WWW korzysta z tej samej konfiguracji, którą weryfikujesz w terminalu.

Wybierz XAMPP lub Laragon do prostego stosu AMP, a Docker, jeśli potrzebujesz odtwarzalnej konfiguracji usług i znasz kontenery. Dokumentacja PrestaShop opisuje lokalne stosy AMP i Dockera, a instrukcja dla Windows wymienia XAMPP, Laragon, WAMP, EasyPHP i MAMP.

Windows może działać jako środowisko lokalne, ale dokumentacja PrestaShop zaznacza, że system nie jest aktywnie wspierany. Test na Windows nie potwierdza więc zgodności z oficjalnie wspieranym środowiskiem produkcyjnym. Do bliższego odwzorowania serwera Linux można rozważyć WSL lub Docker z WSL.

Wybierz narzędzie według systemu operacyjnego i możliwości uruchomienia dokładnej wersji PHP, a nie wyłącznie łatwości instalacji.

Zalecamy zapisać wersje PHP i bazy przypisane do projektu. Sama nazwa XAMPP, Laragon lub Docker nie potwierdza zgodności z konkretnym wydaniem PrestaShop.

Przed instalacją uruchom serwer WWW i bazę danych, a następnie utwórz pustą bazę przeznaczoną wyłącznie dla testowego sklepu. Stos AMP łączy serwer WWW, PHP i bazę MySQL, a phpMyAdmin może służyć do zarządzania bazą.

Na Windows w XAMPP uruchom Apache i MySQL z panelu środowiska. Jeśli Apache nie startuje, sprawdź, czy inny program nie zajmuje portu HTTP, zwykle 80 lub 8080 zależnie od konfiguracji. Jeśli baza nie startuje, sprawdź port MySQL, często 3306; lokalny pakiet może używać innych ustawień.

Przygotowanie bazy:
1. Otwórz phpMyAdmin pod adresem środowiska, często `http://localhost/phpmyadmin`.
2. Utwórz bazę, na przykład `prestashop_test`.
3. Utwórz użytkownika dla tej bazy albo użyj lokalnego konta testowego.
4. Zapisz host, port, nazwę bazy, użytkownika i hasło potrzebne instalatorowi.
5. Sprawdź, czy użytkownik może tworzyć i modyfikować tabele w tej bazie.

Dane logowania do bazy nie są tym samym co konto administratora sklepu. Nie używaj danych produkcyjnych w testowej instalacji. Przy niestandardowym porcie wpis hosta może wymagać numeru portu.

Do zwykłej instalacji pobierz oficjalny pakiet wydania PrestaShop, a nie źródła deweloperskie wymagające dodatkowego przygotowania. Dokumentacja instalacji PrestaShop 9 odróżnia pakiet wydania od wersji deweloperskiej, która wymaga pobrania zależności.

Kolejne kroki dla lokalnego pakietu AMP:
1. Pobierz wydanie z oficjalnej strony pobierania PrestaShop.
2. Rozpakuj pliki do katalogu dokumentów serwera, na przykład `C:\xampp\htdocs\prestashop`.
3. Uruchom Apache i usługę bazy danych.
4. Otwórz `http://127.0.0.1/prestashop/install`.
5. Przejdź kontrolę zgodności i wprowadź dane pustej bazy.
6. Utwórz osobne konto administratora sklepu i zakończ instalację.

Dokumentacja wskazuje adres `/install` dla pakietu wydania i `/install-dev` dla wersji deweloperskiej. Wydania PrestaShop 9 nie są już budowane ani udostępniane na GitHubie jako gotowe paczki, dlatego pobieraj instalator z oficjalnego serwisu projektu.

Instalator sprawdza zgodność serwera, łączy się z bazą i tworzy podstawową konfigurację sklepu. Wpisz host, port, nazwę bazy, użytkownika i hasło, a przed zatwierdzeniem potwierdź, że baza jest pusta.

Tabela pokazuje typowe komunikaty instalatora i pierwsze miejsce diagnozy. W przypadku błędu PHP zweryfikuj wydanie PrestaShop w oficjalnej tabeli zgodności.

Po błędzie PHP sprawdź konfigurację używaną przez serwer WWW, a nie wyłącznie wynik polecenia `php -v` w terminalu. Po instalacji zaloguj się do panelu, ustaw bezpieczne dane administratora, dodaj produkt testowy i sprawdź widok sklepu.

Błąd diagnozuj od zgodności PHP i rozszerzeń, przez połączenie z bazą, po uprawnienia do plików. Zapisz pełny komunikat i etap instalacji przed zmianą ustawień.

Procedura diagnostyczna:
- Sprawdź, czy serwer WWW i baza mają status uruchomiony w panelu środowiska.
- Zweryfikuj, czy adres sklepu otwiera katalog instalacji.
- Ustal plik `php.ini` używany przez serwer WWW i sprawdź wymagane rozszerzenia.
- Zweryfikuj host, port, nazwę bazy i uprawnienia użytkownika.
- Otwórz logi błędów Apache, Nginx lub PHP z katalogu logów pakietu.
- Po zmianie ustawień zrestartuj usługę i ponów kontrolę instalatora.

Jeśli instalator zgłasza brak `intl`, `gd` lub `curl`, aktywuj rozszerzenie w pliku konfiguracyjnym PHP używanym przez serwer WWW, a następnie uruchom usługę ponownie. Nie zmieniaj wielu ustawień naraz, ponieważ utrudnia to wskazanie przyczyny. Dokumentacja PrestaShop 9 wymienia rozszerzenia wymagane do działania sklepu.

Przed przeniesieniem sprawdź panel, widok sklepu, dane testowe, moduły oraz osobne kopie plików i bazy danych. Adres `localhost` nie jest adresem produkcyjnym i musi zostać zastąpiony konfiguracją docelowej domeny.

Lista kontroli przed migracją:
- zaloguj się do Back Office i sprawdź konto administratora;
- otwórz sklep i kartę produktu;
- sprawdź język, walutę i strefę czasową;
- sprawdź moduły, motyw i strony informacyjne;
- usuń zamówienia testowe albo oznacz je jako testowe;
- wykonaj kopię plików oraz eksport bazy;
- przygotuj docelowe PHP, bazę, domenę, SSL i konfigurację adresów.

Migracja wymaga przeniesienia plików i bazy oraz dostosowania połączenia z bazą, domeny, ścieżek i ustawień serwera. Konfigurację sklepu opisujemy w poradniku PrestaShop 8.x krok po kroku, a uruchomienie i utrzymanie omawia poradnik PrestaShop dla sklepów online.

Jeśli po testach planujesz przejść na WooCommerce, sklep internetowy na WooCommerce opisuje naszą ofertę dla tej platformy. Zakres pomocy dotyczącej istniejącego sklepu PrestaShop ustalamy osobno.

Zgodność lokalnego testu z hostingiem zależy przede wszystkim od wersji PHP, bazy i konfiguracji serwera. Rozbieżność środowisk może sprawić, że moduł zadziała lokalnie, ale zgłosi błąd po wdrożeniu.

Z perspektywy KC Mobile zalecamy zapisać wersje usług, aktywne rozszerzenia PHP i ustawienia wpływające na instalację. Przed migracją porównaj te dane z wymaganiami hostingu i wykonaj próbę na kopii sklepu.

• PrestaShop i PHP 8.0: jak sprawdzić zgodność oraz bezpiecznie zmienić wersję
• Jak wykonać i sprawdzić backup sklepu PrestaShop
• Jak włączyć debug mode w PrestaShop i bezpiecznie znaleźć błąd
• PrestaShop API: jak skonfigurować dostęp i bezpiecznie zintegrować sklep