PrestaShop max_input_vars: Dlaczego produkty z wieloma kombinacjami nie chcą się zapisać

Zrozumienie max_input_vars w PrestaShop

Jeśli kiedykolwiek próbowałeś zapisać produkt z dziesiątkami lub setkami kombinacji w PrestaShop i napotkałeś ciche niepowodzenie, częściowy zapis lub tajemniczy błąd, winowajcą jest niemal na pewno dyrektywa PHP max_input_vars. To ustawienie kontroluje, ile poszczególnych pól formularza PHP zaakceptuje w pojedynczym żądaniu POST. Gdy PrestaShop przesyła formularz produktu, który przekracza ten limit, każde pole powyżej progu jest po cichu odrzucane, co prowadzi do niekompletnych zapisów, brakujących kombinacji lub danych, które po prostu znikają bez widocznego komunikatu o błędzie.

Domyślnie większość instalacji PHP ma ustawiony max_input_vars na 1000. Dla prostego bloga czy strony informacyjnej to więcej niż wystarczająco. Jednak w przypadku PrestaShop strony edycji produktów mogą generować tysiące pól formularza, szczególnie gdy w grę wchodzą kombinacje, pola wielojęzyczne i niestandardowe cechy. Zrozumienie tej dyrektywy, umiejętność obliczenia wartości, jakiej faktycznie potrzebuje Twój sklep, i prawidłowe zastosowanie poprawki zaoszczędzą Ci godzin debugowania.

Dlaczego PrestaShop potrzebuje wysokich wartości max_input_vars

Formularz edycji produktu w PrestaShop jest jednym z najbardziej złożonych formularzy w jakiejkolwiek platformie e-commerce. Każda kombinacja produktu generuje wiele pól formularza: jedno dla wpływu na cenę, jedno dla wpływu na wagę, jedno dla ilości, jedno dla referencji, jedno dla EAN-13, jedno dla UPC, jedno dla MPN, jedno dla minimalnej ilości, jedno dla progu niskiego stanu, jedno dla daty dostępności i kilka kolejnych w zależności od konfiguracji. Pojedyncza kombinacja może łatwo wygenerować od 15 do 25 pól formularza.

Teraz pomnóż to przez liczbę kombinacji. Koszulka dostępna w 5 rozmiarach i 10 kolorach ma 50 kombinacji. Przy 20 polach na kombinację daje to już 1000 pól tylko dla zakładki kombinacji. Dodaj podstawowe pola produktu, pola SEO dla każdego języka, wartości cech, ceny specjalne i inne zakładki, a łatwo osiągniesz 1500 do 2000 pól dla umiarkowanie złożonego produktu.

W przypadku sklepów sprzedających produkty z rozbudowanymi zestawami atrybutów, takich jak elektronika z różnymi pojemnościami pamięci, kolorami, opcjami RAM i wariantami regionalnymi, pojedynczy produkt może mieć 200 lub więcej kombinacji, generując ponad 4000 pól formularza. Domyślny limit 1000 jest zdecydowanie niewystarczający.

Objawy zbyt niskiej wartości max_input_vars

Najbardziej frustrującym aspektem osiągnięcia limitu max_input_vars jest to, że PHP nie wyrzuca żadnego błędu. Po cichu obcina dane wejściowe. Oznacza to, że zobaczysz szereg mylących objawów bez wyraźnej wskazówki, co poszło nie tak.

Najczęstszym objawem jest znikanie kombinacji po zapisie. Tworzysz 80 kombinacji, klikasz zapisz, a po przeładowaniu strony widocznych jest tylko 40. Formularz przesłał wszystkie 80, ale PHP przetworzył tylko pierwszą część danych POST przed osiągnięciem limitu, więc pozostałe kombinacje nigdy nie dotarły do serwera.

Innym częstym objawem jest częściowy zapis danych produktu. Zakładka z podstawowymi informacjami zapisuje się poprawnie, ale dane cenowe, SEO lub kombinacji są tracone. Dzieje się tak, ponieważ pola formularza są przesyłane w określonej kolejności, a wszystkie pola pojawiające się po punkcie obcięcia zostają odrzucone.

Możesz również doświadczyć sytuacji, gdy strona produktu po prostu przeładowuje się bez zapisywania, lub PrestaShop wyświetla ogólny błąd, taki jak „Wystąpił błąd podczas aktualizacji produktu." W PrestaShop 1.7 i 8.x strona produktu oparta na Symfony może wyświetlać błędy walidacji dla wymaganych pól, które w rzeczywistości były wypełnione, ale zostały obcięte przez PHP.

Mniej oczywisty objaw dotyczy sklepów wielojęzycznych. Jeśli Twój sklep obsługuje 5 języków, każde pole tekstowe jest mnożone przez 5. Produkt, który zapisuje się poprawnie w sklepie jednojęzycznym, nie zapisuje się w wielojęzycznym, ponieważ dodatkowe pola językowe przesuwają łączną liczbę powyżej limitu.

Jak sprawdzić aktualną wartość max_input_vars

Przed dokonaniem zmian zweryfikuj swoje aktualne ustawienie. Utwórz plik PHP w głównym katalogu PrestaShop (pamiętaj, aby usunąć go potem ze względów bezpieczeństwa):

<?php phpinfo(); ?>

Otwórz ten plik przez przeglądarkę i wyszukaj max_input_vars. Zobaczysz zarówno Local Value (co jest aktualnie aktywne), jak i Master Value (wartość domyślna z php.ini). Zwróć uwagę na Local Value, ponieważ może się różnić od Master Value, jeśli konfiguracja .htaccess lub per-katalogowa ją nadpisuje.

Alternatywnie, możesz sprawdzić z poziomu panelu administracyjnego PrestaShop. Przejdź do Zaawansowane, następnie Informacje. Sekcja konfiguracji PHP wyświetla kluczowe ustawienia PHP, w tym max_input_vars. PrestaShop 1.7.7 i nowsze wersje wyświetlają również ostrzeżenie na tej stronie, jeśli wartość jest uznawana za zbyt niską.

Obliczanie potrzebnej wartości max_input_vars

Zamiast ślepo ustawiać wysoką liczbę, możesz oszacować wartość wymaganą przez Twój sklep. Użyj tego wzoru jako punktu wyjścia:

Wymagana wartość = (liczba kombinacji x pola na kombinację) + podstawowe pola produktu + (pola tekstowe x liczba języków) + margines bezpieczeństwa

Jako praktyczny przykład rozważ sklep z 3 językami i produktem mającym 100 kombinacji. Obliczenie wyglądałoby tak: 100 kombinacji pomnożone przez 20 pól każda daje 2000. Podstawowe pola produktu ze wszystkich zakładek dają około 200. Pola tekstowe (nazwa, opis, meta tytuł, meta opis, link rewrite i inne) pomnożone przez 3 języki dodają kolejne 150. Dodanie 20% marginesu bezpieczeństwa daje łącznie około 2820.

Dla większości sklepów PrestaShop ustawienie max_input_vars na 10000 zapewnia wystarczający zapas. Sklepy z produktami mającymi ponad 300 kombinacji lub działające w więcej niż 5 językach powinny rozważyć wartość 20000 lub nawet 50000. Narzut pamięciowy wyższej wartości jest znikomy na nowoczesnych serwerach.

Jak zwiększyć max_input_vars

Metoda 1: php.ini (Zalecana)

Jeśli masz dostęp do konfiguracji PHP na serwerze, edycja php.ini jest najczystszym podejściem. Znajdź plik php.ini (wynik phpinfo() powie dokładnie, który plik jest załadowany) i znajdź lub dodaj następującą linię:

max_input_vars = 10000

Po zapisaniu pliku zrestartuj serwer WWW lub usługę PHP-FPM, aby zmiana zaczęła działać. Na Apache z mod_php zrestartuj Apache. Na Nginx z PHP-FPM zrestartuj usługę php-fpm. Dokładne polecenie zależy od systemu operacyjnego i wersji PHP.

Metoda 2: .htaccess (Apache z mod_php lub mod_fcgid)

Jeśli nie masz dostępu do php.ini, na przykład na hostingu współdzielonym, możesz spróbować dodać dyrektywę do pliku .htaccess w głównym katalogu PrestaShop:

php_value max_input_vars 10000

Ta metoda działa tylko wtedy, gdy PHP działa jako moduł Apache (mod_php). Jeśli Twój hosting używa PHP-FPM lub CGI, ta dyrektywa spowoduje błąd 500 Internal Server Error. W takim przypadku natychmiast usuń tę linię i spróbuj następnej metody.

Metoda 3: .user.ini (PHP-FPM / CGI)

Dla serwerów z PHP-FPM utwórz lub edytuj plik .user.ini w głównym katalogu PrestaShop:

max_input_vars = 10000

Pamiętaj, że zmiany w .user.ini nie działają natychmiast. PHP cachuje ten plik przez okres zdefiniowany przez user_ini.cache_ttl, który domyślnie wynosi 300 sekund (5 minut). Odczekaj co najmniej 5 minut po zapisaniu pliku przed testowaniem.

Metoda 4: Panel hostingowy

Wielu dostawców hostingu udostępnia ustawienia PHP przez swój panel sterowania. W cPanelu przejdź do „Select PHP Version" lub „MultiPHP INI Editor" i poszukaj max_input_vars. W Plesku przejdź do PHP Settings dla swojej domeny. DirectAdmin i inne panele mają podobne opcje. Jest to często najłatwiejsza metoda na hostingu współdzielonym.

Komplikacja z łatką Suhosin

Suhosin to łatka bezpieczeństwa PHP, która była powszechna na starszych serwerach, szczególnie tych działających na PHP 5.x. Nakłada ona własny zestaw limitów wejściowych, które nadpisują standardowe ustawienie max_input_vars. Nawet jeśli zwiększysz max_input_vars do 10000, Suhosin może nadal wymuszać niższy limit poprzez własne dyrektywy.

Ustawienia specyficzne dla Suhosin, które musisz dostosować, to:

suhosin.post.max_vars = 10000
suhosin.request.max_vars = 10000

Muszą być ustawione oprócz standardowego max_input_vars. Jeśli wynik phpinfo() pokazuje sekcję Suhosin, jesteś dotknięty tym problemem i musisz dostosować wszystkie trzy wartości. Ustawienia Suhosin mogą być zazwyczaj zmieniane tylko w php.ini, nie w .htaccess ani .user.ini.

Na nowoczesnych instalacjach PHP 7.x i 8.x Suhosin jest rzadko obecny. Jeśli używasz aktualnej wersji PHP, niemal na pewno nie musisz się tym martwić. Jednak jeśli korzystasz ze starszego konta na hostingu współdzielonym, które nie było aktualizowane, warto to sprawdzić.

Alternatywne podejścia dla produktów z ponad 500 kombinacjami

Choć zwiększenie max_input_vars rozwiązuje bezpośredni problem, sklepy z ekstremalnie dużą liczbą kombinacji na produkt powinny rozważyć alternatywne podejścia, które zmniejszają liczbę pól formularza lub całkowicie omijają to ograniczenie.

Import kombinacji przez CSV

Wbudowana funkcjonalność importu PrestaShop przetwarza kombinacje przez przesyłanie plików, a nie przesyłanie formularzy, całkowicie omijając limit max_input_vars. Przygotuj plik CSV z danymi kombinacji i zaimportuj go przez back office w sekcji Zaawansowane, Import. Jest to często najbardziej praktyczne podejście dla produktów z setkami kombinacji.

Użyj API Webservice PrestaShop

API webservice PrestaShop pozwala tworzyć i aktualizować kombinacje programistycznie. Żądania API nie podlegają limitowi max_input_vars, ponieważ używają strukturalnych ładunków XML lub JSON zamiast danych POST zakodowanych formularzem. To podejście wymaga wiedzy technicznej, ale skaluje się do dowolnej liczby kombinacji.

Podziel duże produkty

W niektórych przypadkach z biznesowego punktu widzenia sensowniej jest podzielić produkt z ponad 500 kombinacjami na kilka produktów. Produkt z 5 rozmiarami i 100 kolorami mógłby zostać podzielony na 5 produktów, po jednym na rozmiar, każdy ze 100 opcjami kolorystycznymi. To nie tylko pozwala uniknąć ograniczenia technicznego, ale często poprawia również doświadczenie klienta.

Zarządzaj kombinacjami partiami

Jeśli musisz korzystać z formularza w back office, twórz kombinacje w mniejszych partiach. Generuj 50 kombinacji na raz, zapisz, następnie generuj kolejne 50. Jest to żmudne, ale pozwala uniknąć osiągnięcia limitu bez konieczności zmian konfiguracji serwera.

Weryfikacja poprawki

Po zwiększeniu max_input_vars zweryfikuj, czy zmiana zadziałała. Sprawdź ponownie phpinfo() i potwierdź, że Local Value odpowiada temu, co ustawiłeś. Następnie przetestuj, edytując swój najbardziej złożony produkt, wprowadzając drobną zmianę i zapisując. Wszystkie kombinacje i dane powinny zostać zachowane.

Jeśli problem utrzymuje się po zwiększeniu wartości, sprawdź te dodatkowe możliwości. Twój dostawca hostingu może nadpisywać Twoje ustawienia konfiguracją globalną. Instancja PHP obsługująca Twoją stronę może być inna niż ta pokazywana w CLI phpinfo(). Może istnieć limit serwera WWW, taki jak LimitRequestBody Apache lub client_max_body_size Nginx, który również obcina żądanie. Niektóre firewalle aplikacji webowych (WAF) lub wtyczki bezpieczeństwa (jak ModSecurity) nakładają własne limity na rozmiar danych POST i liczbę parametrów.

Powiązane ustawienia PHP do sprawdzenia

Przy okazji dostosowywania max_input_vars przejrzyj te powiązane ustawienia, które również mogą powodować problemy z dużymi formularzami produktów:

post_max_size: Ustawia maksymalny rozmiar danych POST w bajtach. Jeśli dane formularza przekraczają ten limit (zazwyczaj gdy produkty mają wiele dużych pól tekstowych w wielu językach), cały POST jest odrzucany. Ustaw na co najmniej 32M dla PrestaShop.

memory_limit: Przetwarzanie tysięcy pól formularza wymaga pamięci. Jeśli PHP wyczerpie pamięć podczas parsowania danych wejściowych, żądanie nie powiedzie się. Zalecana wartość dla PrestaShop to 256M lub 512M.

max_execution_time: Zapisywanie produktu z wieloma kombinacjami wiąże się z licznymi zapytaniami do bazy danych. Jeśli operacja zapisu trwa dłużej niż dozwolony czas wykonania, zostanie przerwana w trakcie procesu, prowadząc do częściowych zapisów. Ustaw na co najmniej 300 sekund dla sklepów ze złożonymi produktami.

max_input_nesting_level: PrestaShop używa zagnieżdżonych tablic w danych formularzy (na przykład pola wielojęzyczne używają tablic jak name[1], name[2]). Domyślny poziom zagnieżdżenia 64 jest zazwyczaj wystarczający, ale jeśli napotkasz problemy z głęboko zagnieżdżonymi strukturami formularzy, zwiększ go do 128 lub 256.

Uwagi specyficzne dla wersji PrestaShop

W PrestaShop 1.6 strona produktu jest całkowicie oparta na starszym kodzie PHP z tradycyjnym przesyłaniem formularzy. Problem z max_input_vars dotyczy wszystkich operacji na stronie produktu. Nie ma obejścia poza zwiększeniem limitu lub użyciem importów.

PrestaShop 1.7 wprowadził częściowo opartą na Symfony stronę produktu. Choć architektura się zmieniła, bazowe przesyłanie formularzy nadal korzysta z danych POST i podlega tym samym limitom PHP. Komponent formularzy Symfony może wyświetlać bardziej informacyjne komunikaty o błędach, gdy brakuje pól, ale przyczyna źródłowa jest taka sama.

PrestaShop 8.x zawiera całkowicie przeprojektowaną stronę produktu z nową strukturą formularzy Symfony. Zarządzanie kombinacjami zostało znacząco przebudowane — kombinacje są teraz zarządzane przez dedykowany interfejs, który ładuje i zapisuje dane przez AJAX w mniejszych partiach. Ta zmiana architektury naturalnie zmniejsza wpływ max_input_vars na dane kombinacji, choć główny formularz produktu może nadal być dotknięty w sklepach wielojęzycznych z wieloma cechami.

PrestaShop 9.x kontynuuje trend w kierunku obsługi danych opartej na AJAX, dalej zmniejszając zależność od masowego przesyłania formularzy. Jednak max_input_vars pozostaje istotny dla operacji zbiorczych i starszych modułów, które nadal korzystają z tradycyjnego przesyłania formularzy.

Zapobieganie przyszłym problemom

Ustaw max_input_vars na hojną wartość podczas początkowej instalacji PrestaShop, zamiast czekać na pojawienie się problemów. Wartość 20000 jest bezpieczna praktycznie dla wszystkich scenariuszy i nie ma znaczącego wpływu na wydajność. Udokumentuj to ustawienie w swoich notatkach konfiguracyjnych serwera, aby przyszłe migracje serwera je zachowały.

Jeśli jesteś dostawcą hostingu lub administratorem systemów zarządzającym wieloma instalacjami PrestaShop, rozważ ustawienie max_input_vars = 20000 jako domyślnej wartości w swoich szablonach konfiguracji PHP. Ta pojedyncza zmiana eliminuje jedno z najczęstszych zgłoszeń wsparcia związanych z zarządzaniem produktami w PrestaShop.

Monitoruj logi błędów po wprowadzeniu zmian. Choć samo obcięcie max_input_vars nie generuje błędów PHP, niektóre wersje PrestaShop logują ostrzeżenia, gdy wykrywają, że otrzymane dane nie odpowiadają oczekiwanym danym. Te wpisy w logach mogą pomóc zidentyfikować, czy limit jest nadal osiągany pomimo zwiększenia wartości.