Jak naprawić błąd Function putenv() was disabled w PrestaShop 1.7, 8.x, 9.x

Błąd Function putenv() was disabled by the domain protection module potrafi zaskoczyć w najmniej oczekiwanym momencie – szczególnie po tym, jak sklep działał bez zarzutu przez długi czas. W tym wpisie wyjaśniam skąd się bierze ten problem i jak go szybko rozwiązać.

Co to właściwie jest putenv()?

putenv() to wbudowana funkcja PHP służąca do ustawiania zmiennych środowiskowych w czasie działania skryptu. PrestaShop korzysta z niej m.in. podczas obsługi lokalizacji i tłumaczeń – wywołuje ją przy ustawianiu locale dla danego języka sklepu. Bez tej funkcji sklep nadal może działać, ale w logach zaczynają pojawiać się ostrzeżenia, a w niektórych konfiguracjach błędy mogą być widoczne bezpośrednio na stronie – co oczywiście jest niedopuszczalne na produkcji.

Skąd się bierze ten błąd?

Problem jest charakterystyczny dla hostingów współdzielonych, które używają mechanizmu separacji domen (ang. domain protection). Mechanizm ten izoluje poszczególne domeny od siebie na poziomie systemu operacyjnego, co jest dobrą praktyką bezpieczeństwa – ale przy okazji blokuje pewne funkcje PHP, w tym właśnie putenv(). Najbardziej popularnym przypadkiem jest hosting Cyber Folks oraz Hostido, który od pewnego momentu zaczął automatycznie włączać tę opcję przy każdej nowo dodanej domenie lub subdomenie. Efekt? Sklep działał bez problemu, dodałeś subdomenę albo przepinałeś domenę – i nagle zaczął sypać ostrzeżeniami.Pełna treść ostrzeżenia wygląda tak:

Jak rozwiązać problem – panel DirectAdmin (Cyber Folks lub Hostido)

Rozwiązanie jest bardzo proste i nie wymaga żadnych modyfikacji w kodzie sklepu. Wystarczy wyłączyć separację domen w panelu hostingowym.

1. Zaloguj się do panelu DirectAdmin – zazwyczaj dostępny jest pod adresem nazwadomeny.pl:2222 lub nazwadomeny.pl:2223
2. Przejdź do sekcji Ustawienia domen
3. Znajdź domenę swojego sklepu na liście
4. Zmień opcję Separacja domen z TAK na NIE
5. Zapisz zmiany

A co jeśli mam inny panel hostingowy?

Nie każdy hosting korzysta z DirectAdmin. Poniżej zebrałem, gdzie szukać tej opcji w innych popularnych panelach:

Panel hostingowy	Gdzie szukać ustawienia
DirectAdmin (Cyber Folks)	Ustawienia domen – Separacja domen – NIE
cPanel	PHP Selector lub ModSecurity – sprawdź wyłączone funkcje PHP
Plesk	Domeny – ustawienia PHP – Wyłączone funkcje
HestiaCP	Brak wbudowanej separacji domen – sprawdź konfigurację PHP-FPM w /etc/php/X.X/fpm/pool.d/
Własny serwer (VPS/dedyk)	Plik php.ini lub php-fpm.conf – dyrektywa disable_functions

Rozwiązanie alternatywne – własny serwer lub brak dostępu do panelu

Jeśli masz dostęp do pliku php.ini lub konfiguracji PHP-FPM, sprawdź czy putenv nie figuruje na liście zablokowanych funkcji:Usuń putenv z tej listy i zrestartuj PHP-FPM:

Czy warto martwić się tym błędem?

Tak. Choć sklep często działa pozornie normalnie mimo tego ostrzeżenia, to:

• błąd może pojawiać się na stronie dla klientów (zależnie od konfiguracji wyświetlania błędów PHP)
• w niektórych wersjach PrestaShop niepoprawne ustawianie locale może powodować problemy z generowaniem faktur PDF lub tłumaczeniami maili
• nagromadzone ostrzeżenia w logach utrudniają diagnozowanie rzeczywistych problemów

Masz inne pytania dotyczące konfiguracji PrestaShop lub problemów z hostingiem? Zostaw komentarz poniżej.