Bezpieczny upgrade PrestaShop – poradnik aktualizacji
Bezpieczny upgrade PrestaShop przebiega etapami: wybór wersji docelowej, pełna kopia zapasowa, aktualizacja na kopii sklepu, wdrożenie produkcyjne i plan na wypadek awarii. Każdy etap ma jeden cel: zaktualizować sklep bez utraty zamówień, klientów i konfiguracji.
Jak przygotować aktualizację PrestaShop?
Aktualizacja PrestaShop to coś więcej niż podmiana plików. Silnik, moduły i motyw aktualizuje się osobno, a każdy z tych elementów ma własne wymagania. Dlatego przygotowanie zaczyna się od ustalenia, skąd i dokąd sklep ma przejść. Dopiero wtedy można ocenić serwer i dodatki.

Wybór wersji i ścieżki aktualizacji
Przed rozpoczęciem aktualizacji warto sprawdzić wersję działającego sklepu w „Parametry zaawansowane → Informacje”. Potem wybiera się konkretną wersję docelową i ścieżkę, którą obsługuje aktualizator. Sama dostępność najnowszej wersji niczego jeszcze nie przesądza.
Aktualizacja w obrębie jednej linii wersji jest zwykle prostsza niż przejście do nowej wersji głównej. StartPresta wykonuje taką aktualizację sklepu PrestaShop 9 w obrębie gałęzi, na przykład z 9.1.2 do 9.1.12. Gdy bezpośrednia ścieżka nie jest wspierana albo sklep ma rozległe modyfikacje, rozwiązaniem jest migracja do odrębnej instalacji. Wymaga ona mapowania danych i uzgodnienia zamówień.
Stabilne wydanie PrestaShop 9.2 ukazało się 30 września 2026 r. Wybór tej wersji wymaga jednak potwierdzenia, że dodatki i procesy sklepu z nią współpracują.
Wymagania serwera i wersji PHP
Przygotowanie sklepu internetowego do zmiany wymaga sprawdzenia wymagań serwera dla dokładnej wersji docelowej: PHP, bazy danych, rozszerzeń, pamięci i limitu czasu wykonywania skryptów. Różne wydania mogą mieć różne wymagania. Dla PrestaShop 9 dokumentacja podaje:
- Baza danych: co najmniej MySQL 5.7 albo MariaDB 10.2.
- Pamięć PHP: zalecany limit co najmniej 512 MB.
- Serwer WWW: Apache 2.4 lub nowszy, dopuszczalny jest też Nginx.
PrestaShop 9.0 wymaga co najmniej PHP 8.1 i obsługuje PHP 8.2–8.4, a dokumentacja tego wydania zaleca PHP 8.4. Jeżeli aktualizacja ma być uruchamiana z terminala, wersję PHP dla serwera WWW i dla wiersza poleceń (CLI) sprawdza się osobno. PHP na działającym sklepie nie zmienia się tylko na próbę.
Zgodność modułów, motywu i integracji
Kompatybilność modułów PrestaShop potwierdza się dla konkretnej wersji sklepu, wersji PHP i wydania każdego dodatku. Lista w „Moduły → Menedżer modułów” ułatwia inwentaryzację, bo zbiera zainstalowane moduły PrestaShop w jednym miejscu. Sam przycisk „Aktualizuj” nie dowodzi jednak, że zamówienia będą obsługiwane poprawnie.
Ta sama zasada dotyczy motywu. Przed zmianą sprawdza się jego wersję, motyw potomny, własne szablony i nadpisania kodu, bo aktualizator silnika nie zapewnia ich zgodności automatycznie.
Najwięcej uwagi wymagają elementy wpływające na bezpieczeństwo sprzedaży: moduły płatności, dostaw, faktur i ERP, a także zadania cron, webhooki i połączenia API. Krok, który często się pomija: gdy krytyczny moduł nie ma zgodnej wersji, lepiej odłożyć zmianę, uzyskać poprawkę albo zaplanować jego zastąpienie.
Jak wykonać i sprawdzić pełną kopię zapasową?
Kopia zapasowa pozwala wrócić do poprzedniego stanu, ale tylko wtedy, gdy jest kompletna i da się ją odtworzyć. Składa się z dwóch części: bazy i plików. Brak jednej z nich sprawia, że działającego sklepu nie da się przywrócić.

Eksport bazy danych sklepu
Baza danych sklepu przechowuje między innymi zamówienia, klientów, produkty, stany magazynowe i konfigurację, dlatego sama kopia plików nie wystarczy. Eksport można wykonać na kilka sposobów:
- phpMyAdmin: wybór bazy sklepu, potem „Eksport → Szybki → SQL” i zapis pliku.sql lub.sql.gz.
- Panel hostingu: wbudowany eksport, przydatny przy dużej bazie.
- mysqldump: narzędzie wiersza poleceń do zrzutu bazy, również przy dużych bazach.
Eksport bazy danych sklepu i kopia plików powinny przedstawiać możliwie ten sam stan sklepu. Gdy pochodzą z różnych momentów, odtworzenie zamówień i konfiguracji może się nie udać.
Archiwizacja plików i konfiguracji
phpMyAdmin obsługuje wyłącznie bazę. Kodu, modułów, motywu, obrazów i dokumentów nie archiwizuje, więc kopię zapasową sklepu uzupełnia się, pobierając pliki przez SFTP, FTP lub menedżer plików hostingu. Archiwum powinno zawierać:
- Katalogi sklepu: config/, modules/, themes/, img/, override/ i translations/.
- Modyfikacje i konfigurację: własne zmiany, pliki konfiguracyjne oraz.htaccess.
- Opis punktu przywracania: data kopii oraz wersje PrestaShop i PHP.
Archiwum i eksport bazy przechowuje się poza publicznym katalogiem sklepu, z ograniczonym dostępem. Pliki z hasłami nie mogą być publicznie dostępne. Dodatkowy egzemplarz kopii warto trzymać poza serwerem sklepu, bo w razie awarii serwera kopia przepadłaby razem z nim.
Próba odtworzenia kopii
Poprawność kopii zapasowej potwierdza dopiero jej odtworzenie: pliki i bazę wgrywa się na środowisko testowe, a potem sprawdza panel, produkty, koszyk, zamówienia oraz konfigurację płatności i dostaw. Przy odtwarzaniu przydają się zapisane informacje o rozszerzeniach PHP, ustawieniach serwera, przekierowaniach, zadaniach cron i parametrach bazy.
Kopia utworzona przez aktualizator nie zastępuje niezależnej kopii plików i bazy wykonanej tuż przed zmianą. Zwykłe kopie automatyczne zostają dodatkowym zabezpieczeniem, a ich okres przechowywania dopasowuje się do częstotliwości zamówień. Ręczną kopię przed aktualizacją przewiduje też usługa aktualizacji sklepu PrestaShop 1.7.
Jak przeprowadzić aktualizację na kopii sklepu?
Gdy kopia jest sprawdzona, aktualizację przeprowadza się najpierw na odtworzonym sklepie, a nie na produkcji. Tam wychodzą na jaw błędy, których klienci nie powinni zobaczyć. Na produkcję zmiana trafia dopiero po pozytywnych testach.
Przygotowanie środowiska testowego
Bezpiecznie zaktualizować PrestaShop można dopiero na rzeczywistym sklepie odtworzonym pod osobnym adresem, z osobną bazą, na serwerze skonfigurowanym podobnie jak produkcja. Czysta instalacja z tym samym motywem nie odzwierciedla wszystkich procesów sklepu. Na kopii testowej trzeba zadbać o kilka rzeczy:
- Ograniczony dostęp: hasło lub ustawienia serwera oraz ochrona danych osobowych klientów.
- Blokada indeksowania: kopia nie może trafić do wyników wyszukiwania.
- Odłączone operacje: bez prawdziwych płatności, wysyłek, produkcyjnych zadań cron i webhooków.
- Oddzielna poczta: testowe zamówienia nie wysyłają wiadomości do klientów.
Jeżeli kopia nie odtwarza się poprawnie albo wyraźnie różni się od produkcji, środowisko trzeba naprawić przed próbą aktualizacji. W przeciwnym razie wynik testu nie będzie wiarygodny.
Na takim odizolowanym serwerze pracuje się również przy aktualizacji PrestaShop na serwerze testowym, dzięki czemu działający sklep nie ma przestojów.
Przebieg aktualizacji krok po kroku
Proces aktualizacji prowadzi się oficjalnym modułem Update Assistant, dawniej znanym jako 1-Click Upgrade. Nazwa „autoupgrade” wciąż pojawia się w starszych elementach technicznych. Najpierw należy upewnić się, że aktualizator obsługuje wersję docelową, i wyjaśnić jego ostrzeżenia. Przy przejściu z 9.0.x lub 9.1.x do 9.2 oficjalny komunikat wskazuje Update Assistant w wersji 7.6.6. Upgrade PrestaShop uruchomiony z panelu może przerwać limit czasu żądania WWW, natomiast tryb CLI wymaga terminala i czytania logów. Po zakończeniu należy zachować logi, wyczyścić pamięć podręczną zgodnie z instrukcją wydania i sprawdzić, czy w logach nie ma błędów.
Testy zamówień, płatności i integracji
Testy obejmują pełne zamówienie: produkt, koszyk, dostawę, płatność testową, zmianę statusu, wiadomość e-mail i dokument sprzedaży. Sprawdza się też stronę główną, wyszukiwarkę, konto klienta i panel. Dla integracji obowiązują dodatkowe próby:
- Każda metoda płatności: wynik udany, odrzucony i oczekujący; ponowne powiadomienie operatora nie może utworzyć drugiego zamówienia ani drugiego obciążenia.
- Dostawy: etykiety i numery śledzenia, bez wysyłania prawdziwych zleceń do przewoźnika.
- ERP: ceny, stany magazynowe i statusy, bez zleceń dla prawdziwego magazynu.
W polskim sklepie porównuje się z zamówieniem i danymi operatora płatności kwoty brutto i netto, VAT, zaokrąglenia oraz walutę PLN. Różnica ujawnia się przy rabatach i kosztach dostawy, dlatego wartość koszyka trzeba zestawić z kwotą końcową zamówienia.
Polecane produkty
Jak wdrożyć zmianę bez utraty zamówień?
Gdy aktualizacja przeszła testy na kopii, można przejść do produkcji. Wcześniej trzeba potwierdzić kilka rzeczy: aktualizacja kopii zakończyła się sukcesem, krytyczne testy zostały zaliczone, sprawdzona kopia jest dostępna, a do hostingu, bazy i logów jest dostęp.

Okno wdrożeniowe i zatrzymanie zapisów
Bezpieczna aktualizacja PrestaShop wymaga planu ustalonego wcześniej. Na produkcji aktualizacja nie może kolidować z ruchem klientów, dlatego wdrożenie przebiega w tej kolejności:
- Okno wdrożeniowe: termin poza szczytem zamówień, osoba podejmująca decyzje i kryteria przerwania prac.
- Tryb konserwacji: włączony na czas zmiany, z ograniczeniem zapisów klientów.
- Koordynacja zadań: wstrzymane procesy zmieniające zamówienia i stany magazynowe.
- Końcowa kopia: pliki i baza zapisane tuż przed wdrożeniem.
Moment zatrzymania zapisów trzeba zanotować dokładnie. Zamówienia zapisane po wykonaniu końcowej kopii zniknęłyby po przywróceniu starej bazy.
Kontrola przed ponownym otwarciem sklepu
Po wdrożeniu sprawdza się panel, zgodność wersji bazy i kodu, koszyk oraz bezpieczne zamówienie z płatnością. Działająca strona główna nie potwierdza jeszcze, że sprzedaż przebiega poprawnie. Normalny ruch i zadania automatyczne wracają dopiero wtedy, gdy statusy zamówień, powiadomienia, dostawy i synchronizacja stanów magazynowych działają bez zarzutu.
W trybie wielosklepowym lub wielojęzycznym kontrolę powtarza się dla każdego używanego sklepu, języka, waluty, grupy klientów, cennika, magazynu i domeny.
Monitoring bezpieczeństwa, SEO i wydajności
Po otwarciu sklepu porównuje się liczbę zamówień, sumy sprzedaży i stany magazynowe ze stanem sprzed wdrożenia. Przez kolejne godziny obserwuje się spóźnione powiadomienia płatnicze, logi PHP i HTTP oraz zadania cron. Wydajność ocenia się, porównując czas odpowiedzi, logi i działanie pamięci podręcznej przed zmianą i po niej. Nowy numer wersji sam w sobie nie oznacza szybszego sklepu.
Kontrola SEO obejmuje adresy URL, metadane, przekierowania 301, adresy kanoniczne, hreflang, robots.txt i mapę witryny. W prezentacji oferty sprawdza się cenę całkowitą, informacje o dostawie i dane wymagane przy obniżkach.
Co zrobić po nieudanej aktualizacji?
Awaria podczas aktualizacji nie musi oznaczać utraty danych, o ile kolejne kroki wykonuje się w odpowiedniej kolejności. Najpierw diagnoza, potem odtworzenie zgodnego stanu, na końcu uzgodnienie transakcji.
Diagnoza przyczyny awarii
Nieudanej aktualizacji nie uruchamia się ponownie w ciemno. Najpierw należy zebrać ślady i ustalić, czego dotyczą błędy: plików, bazy, serwera, motywu czy modułu. Do zabezpieczenia są:
- Komunikat aktualizatora: wraz z momentem, w którym proces się zatrzymał.
- Logi: PHP, serwera WWW i aplikacji.
- Kopia stanu: logi i kopia do porównania, gdy wersja kodu nie zgadza się z wersją bazy.
Błąd 500 lub biały ekran mogą wynikać z błędu PHP, braku pamięci, niezgodnego dodatku, pamięci podręcznej albo przerwanego procesu. Diagnozę zaczyna się od logów, a nie od przypadkowej podmiany plików. Ręczna zmiana identyfikatora wersji bazy bez ustalenia stanu migracji może ukryć niedokończone zmiany.
Odtworzenie zgodnego stanu sklepu
Przed przywróceniem kopii należy zachować stan plików, bazy i logów po awarii. Dzięki temu da się ustalić, jakie zamówienia lub płatności powstały po punkcie przywracania.
Powrót wymaga zgodnego zestawu kodu, bazy i plików użytkownika. Wgranie samych starych plików nie cofa zmian w strukturze bazy.
Wybrany punkt przywracania najlepiej odtworzyć najpierw w osobnym środowisku i przetestować. Dopiero wtedy przywraca się produkcję i sprawdza panel, koszyk, zamówienia, statusy i integracje.
Uzgodnienie transakcji i ponowne uruchomienie
Gdy sklep jest niedostępny, należy ograniczyć ruch i sprawdzić u operatora płatności, czy pobrano środki mimo braku zamówienia w panelu. Identyfikatory transakcji i czas awarii trzeba zapisać. Po przywróceniu kopii uzgadnia się płatności, zamówienia, zwroty, faktury, nadania kurierskie i stany magazynowe, bo przywrócenie bazy nie cofa operacji wykonanych poza sklepem.
Płatności i wysyłek nie ponawia się automatycznie, jeśli operator lub przewoźnik mógł już je zrealizować. Sklep otwiera się ponownie dopiero po wyjaśnieniu rozbieżności i przejrzeniu logów.
Najczęściej zadawane pytania
Moduły aktualizuje się pojedynczo lub w kontrolowanych grupach i testuje po każdej zmianie, co ułatwia znalezienie przyczyny awarii. Przed aktualizacją modułu warto zachować jego konfigurację i pliki, bo zmiana może usunąć własne modyfikacje kodu. Moduł płatności może wyglądać poprawnie, a mimo to źle obsługiwać powiadomienia operatora. Wyłączenie krytycznego modułu na produkcji bez testów może przerwać sprzedaż.
Należy zachować komunikat aktualizatora, logi PHP, serwera WWW i aplikacji oraz moment zatrzymania procesu. Katalogów kopii aktualizatora nie usuwa się przed diagnozą. Gdy brakuje zdjęć produktów, można spróbować ponownie wygenerować miniatury w sekcji obrazów panelu. Jeśli aktualizator nie pokazuje nowej wersji, trzeba sprawdzić zgodność PHP, gotowość wydania do aktualizacji i wersję aktualizatora.
Kopia obejmuje eksport bazy i archiwum plików. Bezpośrednio przed aktualizacją wykonuje się ją jako dodatkową, niezależnie od zwykłych kopii automatycznych. Przy dużej liczbie plików archiwizowanie w panelu hostingu może być ograniczone parametrami serwera. Wtedy pliki można pobrać przez SFTP lub FTP.



