Generator php.ini

Generator php.ini

Plik php.ini steruje działaniem środowiska PHP. Odpowiednie limity pamięci, czasu wykonania i uploadu są niezbędne dla stabilnej pracy aplikacji.

Najważniejsze ustawienia

Wzajemne zależności

post_max_size musi być większe lub równe upload_max_filesize. Inaczej duże pliki zostaną odrzucone mimo podniesionego limitu uploadu. Pamięć (memory_limit) powinna być większa niż rozmiar przetwarzanego pliku.

Bezpieczeństwo

• display_errors wyłącz na produkcji — komunikaty ujawniają ścieżki i konfigurację.
• Ustaw log_errors = On i przeglądaj logi.
• Nie ustawiaj absurdalnie wysokich limitów bez potrzeby.

Jak generator składa plik php.ini

Generator pobiera wartości wpisane w formularzu i zapisuje je jako pary dyrektywa = wartość, czyli dokładnie w formacie, jaki PHP czyta przy starcie procesu. Każda linia to jedna dyrektywa, a linie rozpoczynające się od średnika są komentarzami i PHP je pomija. Gotowy wynik wklejasz do pliku php.ini albo traktujesz jako listę wartości do wpisania w panelu hostingu.

Rozmiary w php.ini podaje się w notacji skróconej: liczba plus sufiks K, M lub G, gdzie 1K to 1024 bajty, a 1M to 1024K. Liczba bez sufiksu oznacza bajty, więc wpisanie samego „64” da limit 64 bajtów, a nie 64 megabajty — to najczęstsza pomyłka przy ręcznej edycji. Narzędzie pilnuje spójności formatu i sygnalizuje, gdy zależność między limitami jest niespełniona.

Drugi element mechanizmu to kolejność i nadpisywanie. PHP czyta najpierw główny plik konfiguracyjny, a potem pliki z katalogu wskazanego przez dyrektywę scan (typowo katalog dodatkowy). Jeśli ta sama dyrektywa pojawi się dwa razy, wygrywa ostatnie wystąpienie. Wygenerowany wpis zadziała więc tylko wtedy, gdy nie kłóci się z innym plikiem konfiguracyjnym obecnym na serwerze.

Przykład krok po kroku: wgrywanie plików do 128 MB

1. Cel: chcesz przyjmować pliki o rozmiarze do 128 MB. W polu upload_max_filesize wpisujesz 128M.
2. W polu post_max_size wpisujesz 132M, czyli wartość większą od limitu pojedynczego pliku. Żądanie POST to nie tylko sam plik — dochodzą nagłówki, granice multipart i pozostałe pola formularza.
3. W polu memory_limit wpisujesz 256M. Skrypt, który wczytuje plik do pamięci, potrzebuje jej wyraźnie więcej niż sam plik zajmuje na dysku, bo dochodzą struktury tymczasowe i kopie danych.
4. Ustawiasz max_execution_time na 300 (sekundy). Wgranie pliku przez wolne łącze i jego obróbka nie zmieszczą się w krótkim domyślnym czasie.
5. Ustawiasz max_input_vars na 3000, jeśli formularz ma wiele pól. Przekroczenie tego limitu obcina dane wejściowe bez czytelnego komunikatu o błędzie.
6. Na produkcji ustawiasz display_errors = Off oraz log_errors = On, kopiujesz wygenerowaną treść do pliku konfiguracyjnego i restartujesz PHP-FPM wraz z serwerem HTTP. Efekt sprawdzasz testowym wgraniem pliku o rozmiarze bliskim 128 MB.

Tabela referencyjna dyrektyw

Praktyczne wskazówki

• Podnoś limity parami. Zmiana upload_max_filesize bez podniesienia post_max_size nie da efektu — duże żądania zostaną odrzucone jeszcze przed zapisem pliku.
• Ustawiaj wartości osobno dla środowisk. Na komputerze deweloperskim wysokie limity skracają debugowanie, na produkcji warto trzymać je jak najniżej, ale powyżej realnych potrzeb aplikacji.
• Zostaw margines na narzut. post_max_size ustawiaj nieco powyżej planowanego rozmiaru pliku, bo żądanie zawiera też pola formularza i granice multipart.
• Sprawdź efekt po wdrożeniu. Po restarcie usług potwierdź wartości testowym wgraniem pliku i odczytem konfiguracji, zamiast zakładać, że plik został wczytany.
• Nie kopiuj cudzych konfiguracji. Wysokie limity przeniesione z innego projektu obciążają serwer i częściej prowadzą do wyczerpania zasobów niż do rozwiązania problemu.

Czego narzędzie nie uwzględnia

• Limitów serwera HTTP i pośredników. Jeśli serwer frontendowy, proxy albo zapora mają własny limit rozmiaru żądania, podniesienie wartości w php.ini nic nie da — plik zostanie odrzucony wcześniej.
• Wersji PHP i różnic między nimi. Część dyrektyw zmieniała znaczenie lub domyślne wartości między wersjami, a generator nie wie, na jakiej wersji uruchomisz wynik.
• Realnych ograniczeń pamięci maszyny. Wysoki memory_limit nie tworzy pamięci — jeśli procesów jest wiele, suma limitów może przekroczyć dostępne zasoby i skończyć się zabiciem procesu.
• Polityki hostingu. Na hostingu współdzielonym część ustawień jest blokowana po stronie panelu, a inne pliki konfiguracyjne mogą nadpisywać wygenerowane wartości bez ostrzeżenia.

Najczęstsze pytania