Jak zainstalować PrestaShop na lokalnym serwerze — XAMPP krok po kroku | WebMajka

Jak zainstalować PrestaShop na lokalnym serwerze — kompletny przewodnik

Instalacja PrestaShop na własnym komputerze to najszybszy sposób, by poznać ten silnik sklepowy bez ponoszenia kosztów hostingu, rejestracji domeny czy czekania na migrację. PrestaShop na localhost pozwala dowolnie testować motywy, moduły, konfiguracje podatków czy integracje płatności — a gdy sklep jest gotowy, wystarczy przenieść bazę i pliki na serwer produkcyjny. W tym poradniku przeprowadzę cię krok po kroku przez cały proces: od pobrania XAMPP, przez konfigurację PHP, utworzenie bazy danych, aż po finalne uruchomienie sklepu pod adresem http://localhost/prestashop. Cała instalacja zajmuje około 20–30 minut, a efekt to pełnoprawny sklep gotowy do testów.

Wymagania — co musisz mieć przed startem

Zanim zaczniesz instalację PrestaShop, upewnij się, że twój komputer spełnia minimalne wymagania. PrestaShop 8.x (aktualna wersja) wymaga PHP 7.2.5 lub nowszego (rekomendowane PHP 8.1), MySQL 5.6+ lub MariaDB 10.4+, około 200 MB wolnego miejsca na plikach sklepu plus dane. System operacyjny nie ma znaczenia — XAMPP działa na Windows, macOS i Linuksie. Dodatkowo przyda się edytor kodu (Visual Studio Code jest darmowy i świetny) oraz klient FTP (na razie niepotrzebny, ale przyda się później). Sam PrestaShop pobierzesz z oficjalnej strony — najnowsza stabilna wersja to 8.1.x.

Krok 1 — Pobierz i zainstaluj XAMPP

XAMPP to najpopularniejszy pakiet zawierający Apache, MySQL, PHP i phpMyAdmin w jednej instalacji. Wejdź na apachefriends.org, pobierz wersję z PHP 8.1 dla swojego systemu i uruchom instalator. W kreatorze zaznacz komponenty: Apache, MySQL, PHP, phpMyAdmin (pozostałe możesz odznaczyć). Zainstaluj XAMPP w domyślnej ścieżce C:\xampp — trzymanie go poza Program Files unika problemów z prawami dostępu Windows.

Po instalacji uruchom XAMPP Control Panel jako administrator i wystartuj moduły Apache i MySQL przyciskiem Start. Jeśli Apache nie rusza, prawdopodobnie port 80 jest zajęty (np. przez Skype lub IIS). Sprawdź dostępność, otwierając w przeglądarce http://localhost — zobaczysz stronę powitalną XAMPP, a http://localhost/phpmyadmin pokaże panel bazy danych.

# Sprawdzenie, co blokuje port 80 (Windows CMD)
netstat -ano | findstr :80

# Zatrzymanie World Wide Web Publishing Service
net stop w3svc

Krok 2 — Konfiguracja PHP pod PrestaShop XAMPP

Domyślna konfiguracja PHP w XAMPP jest zbyt restrykcyjna dla PrestaShop. Otwórz plik C:\xampp\php\php.ini w edytorze i zmień następujące wartości:

memory_limit = 512M
max_execution_time = 300
post_max_size = 128M
upload_max_filesize = 128M
max_input_vars = 10000
allow_url_fopen = On

Następnie włącz wymagane rozszerzenia PHP — odkomentuj (usuń ;) linie:

extension=curl
extension=gd
extension=intl
extension=mbstring
extension=openssl
extension=pdo_mysql
extension=soap
extension=zip

Po zapisaniu php.ini zrestartuj Apache w XAMPP Control Panel. Braki rozszerzeń to najczęstsza przyczyna błędów instalacji PrestaShop — szczególnie intl (międzynarodowe formaty) i gd (obsługa obrazów).

Krok 3 — Utworzenie bazy danych w phpMyAdmin

PrestaShop wymaga pustej bazy MySQL. Wejdź na http://localhost/phpmyadmin, kliknij zakładkę Bazy danych i utwórz nową bazę. Alternatywnie wykonaj zapytanie SQL ręcznie:

CREATE DATABASE prestashop
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;

CREATE USER 'prestauser'@'localhost' IDENTIFIED BY 'SilneHaslo123!';
GRANT ALL PRIVILEGES ON prestashop.* TO 'prestauser'@'localhost';
FLUSH PRIVILEGES;

Zapisz nazwę bazy, login i hasło — przydadzą się w kreatorze instalacji PrestaShop. Na lokalnym serwerze możesz używać domyślnego użytkownika root bez hasła, ale dobry nawyk tworzenia dedykowanego użytkownika przyda się przy migracji na produkcję.

Krok 4 — Rozpakowanie plików PrestaShop

Pobierz archiwum PrestaShop ze strony prestashop-project.org — dostaniesz plik prestashop_8.x.x.zip. Rozpakuj go do katalogu C:\xampp\htdocs\prestashop\:

cd C:\xampp\htdocs
mkdir prestashop
# rozpakuj archiwum do tego folderu

W środku znajdziesz kolejne archiwum prestashop.zip (na starszych wersjach) oraz Install_PrestaShop.html. Rozpakuj wewnętrzny ZIP do tego samego folderu. Struktura powinna wyglądać tak: htdocs/prestashop/index.php, htdocs/prestashop/admin/, htdocs/prestashop/classes/ itd.

Krok 5 — Uruchomienie kreatora instalacji

Otwórz w przeglądarce http://localhost/prestashop/install/. Powita cię kolorowy kreator w 6 krokach:

1. Wybór języka — zaznacz polski, instalator przetłumaczy się.

2. Umowa licencyjna — zaakceptuj OSL 3.0 oraz AFL 3.0.

3. Zgodność systemu — kreator sprawdzi PHP, rozszerzenia, uprawnienia. Wszystkie wskaźniki muszą być zielone — w razie czerwonego wróć do kroku 2.

4. Dane sklepu — nazwa sklepu, branża, kraj, strefa czasowa. Konto administratora: email + hasło (zapisz je!).

5. Konfiguracja bazy danych — wprowadź dane z poprzedniego kroku:

- Adres serwera: localhost

- Nazwa bazy: prestashop

- Użytkownik: prestauser lub root

- Hasło: (twoje)

- Prefiks tabel: ps_ (domyślny)

6. Instalacja sklepu — PrestaShop tworzy strukturę tabel, wgrywa dane demo. Proces trwa 2–5 minut.

Po zakończeniu zobaczysz komunikat sukcesu z linkami do Front Office i Back Office.

Krok 6 — Zabezpieczenia po instalacji

Zanim zaczniesz pracę, wykonaj kilka obowiązkowych operacji:

# Usuń folder install (wymóg bezpieczeństwa)
cd C:\xampp\htdocs\prestashop
rmdir /S install

# Zmień nazwę folderu admin na trudniejszą do odgadnięcia
ren admin admin123xyz

Po zmianie nazwy panelu administracyjnego wejdziesz pod adres http://localhost/prestashop/admin123xyz/. Zapisz ten adres — PrestaShop wymusza niestandardową nazwę jako dodatkową warstwę ochrony. Na lokalnym środowisku to nie ma dużego znaczenia, ale dobry nawyk przyda się na produkcji.

PrestaShop konfiguracja email na localhost

Domyślnie PrestaShop próbuje wysyłać maile przez SMTP — ale lokalny serwer nie ma wyjścia na zewnątrz. Są dwa rozwiązania:

1. Zapis do pliku (najłatwiejsze) — w panelu admin: Konfiguracja sklepu → Ustawienia zaawansowane → E-mail wybierz "Nigdy nie wysyłaj wiadomości". Zamiast tego maile zapisują się jako logi.

2. Fake Sendmail + Mailtrap — zainstaluj Mailtrap.io (darmowy), w PrestaShop wpisz dane SMTP Mailtrap. Wszystkie wiadomości trafią do skrzynki testowej — idealnie do sprawdzania szablonów zamówień, rejestracji, newslettera.

Dla prestashop konfiguracja e mail produkcyjnej (gdy przeniesiesz sklep na hosting) użyjesz SMTP dostawcy poczty — np. mail.twojadomena.pl port 587 TLS.

Najczęstsze problemy i ich rozwiązania

Podczas instalacji PrestaShop mogą pojawić się typowe błędy:

• "Allowed memory size exhausted" — zwiększ memory_limit w php.ini do 1024M.
• Biała strona po instalacji — włącz tryb debug: w pliku config/defines.inc.php zmień define('_PS_MODE_DEV_', false); na true.
• Brak rozszerzenia intl — odkomentuj extension=intl w php.ini i zrestartuj Apache.
• Nieskończone przekierowanie na HTTPS — w panelu admin wyłącz SSL, bo localhost nie ma certyfikatu.
• Błąd 500 na panelu admin — sprawdź plik .htaccess (może wymagać mod_rewrite) oraz uprawnienia folderów.
• Błąd bazy danych "Table already exists" — wyczyść bazę (DROP DATABASE prestashop;) i powtórz instalację.

Podobne problemy z konfiguracją opisaliśmy też w artykule o instalacji WordPress lokalnie.

Optymalizacja PrestaShop na XAMPP

Domyślnie PrestaShop na localhost działa wolno — bo tryb dev wyłącza cache. Po zakończeniu testów włącz cache w panelu admin: Ustawienia zaawansowane → Wydajność:

• Smarty: Cache: Tak, Force compilation: Nigdy
• Caching: Use cache: Tak, Caching system: FileSystem
• Media servers: zostaw puste na localhost

To przyspieszy ładowanie 3–5 razy. Po każdej zmianie motywu wyczyść cache ręcznie (zielony przycisk Clear cache w prawym górnym rogu).

Przeniesienie sklepu z localhost na hosting produkcyjny

Gdy sklep jest gotowy, przenieś go na serwer produkcyjny:

1. Eksport bazy — w phpMyAdmin: Eksport → SQL → Wykonaj → zapisz plik .sql.

2. Spakowanie plików — cały folder htdocs/prestashop do ZIP.

3. Import na serwerze — wgraj ZIP przez FTP, rozpakuj. Bazę utwórz na hostingu i zaimportuj plik SQL.

4. Edycja config — w pliku app/config/parameters.php zmień dane bazy danych na produkcyjne.

5. Aktualizacja URL — w tabeli ps_configuration zmień PS_SHOP_DOMAIN i PS_SHOP_DOMAIN_SSL na nową domenę.

Dla klientów oferujemy kompletne wdrożenie sklepu internetowego wraz z pozycjonowaniem w Kielcach — od XAMPP przez produkcję po pierwsze zamówienia.

Podsumowanie — PrestaShop krok po kroku na XAMPP

Instalacja PrestaShop na lokalnym serwerze to świetny punkt startu przygody z własnym sklepem. W 30 minut masz w pełni funkcjonalny silnik e-commerce: panel administracyjny, integracje z płatnościami, obsługa katalogów, podatków, klientów. Pamiętaj o trzech kluczowych elementach: właściwa konfiguracja PHP (rozszerzenia + limity pamięci), dedykowana baza MySQL, usunięcie folderu install po zakończeniu kreatora. Gdy sklep będzie gotowy, migracja na produkcję to kwestia kilku zapytań SQL i edycji jednego pliku konfiguracyjnego.