Jak zwiększyć limit przesyłania plików w WordPressie

Aby zwiększyć limit przesyłania plików w WordPressie, podnieś dwa ustawienia PHP, upload_max_filesize i post_max_size, w pliku konfiguracyjnym, który Twój hosting faktycznie odczytuje. To php.ini na serwerze, którym zarządzasz, .user.ini na większości hostingów współdzielonych z PHP-FPM lub FastCGI, .htaccess tylko wtedy, gdy Apache uruchamia PHP jako moduł, albo MultiPHP INI Editor w cPanelu. Jeśli Twój serwer działa na Nginx, podnieś też client_max_body_size. Edycja wp-config.php nie zmieni limitu przesyłania.

Narzędzie do maksymalnego rozmiaru przesyłania w WordPressie zamienia jeden docelowy rozmiar na pasujące wartości dla php.ini (lub .user.ini), .htaccess i wp-config.php, więc możesz je wkleić zamiast przepisywać ręcznie.

Krok 1: Sprawdź obecny limit przesyłania

Zanim cokolwiek zmienisz, sprawdź, jaki jest obecny limit i które ustawienie go wyznacza.

• Media > Dodaj nowy. Ekran przesyłania pokazuje maksymalny rozmiar przesyłanego pliku. To ta liczba, którą chcesz podnieść.
• Narzędzia > Kondycja witryny > Informacje. Rozwiń sekcję Obsługa mediów. Dokumentacja Kondycji witryny wymienia, co tam znajdziesz: maksymalny dozwolony rozmiar danych POST, maksymalny rozmiar przesyłanego pliku oraz maksymalny efektywny rozmiar pliku, czyli mniejszą z tych dwóch wartości. Sekcja Serwer pokazuje więcej wartości PHP.

WordPress oblicza swój limit w wp_max_upload_size(), która odczytuje z PHP upload_max_filesize i post_max_size i używa mniejszej wartości. Jeśli jedna wynosi 64M, a druga 8M, Twój limit to 8M.

Krok 2: Poznaj ustawienia, które mają znaczenie

Ustawienie	Co ogranicza	Domyślnie w PHP	Gdzie można je zmienić
upload_max_filesize	Największy pojedynczy przesyłany plik	2M	php.ini, .user.ini, .htaccess, httpd.conf
post_max_size	Całe żądanie POST, razem z plikiem	8M	php.ini, .user.ini, .htaccess, httpd.conf
memory_limit	Pamięć, której PHP może używać podczas działania	128M	Wszędzie, także w wp-config.php
max_execution_time	Liczba sekund, przez które skrypt może działać	30	Wszędzie, także w wp-config.php
client_max_body_size (Nginx)	Treść żądania, którą Nginx przyjmie	1m	Tylko konfiguracja Nginx

Domyślne wartości PHP i tryby zmian pochodzą z listy dyrektyw php.ini, a domyślna wartość Nginx z dokumentacji modułu core Nginx. Większość hostingów ustawia wyższe wartości niż domyślne w PHP, dlatego swoje prawdziwe liczby odczytasz w Kondycji witryny.

upload_max_filesize i post_max_size to w terminologii PHP ustawienia INI_PERDIR: „można je ustawić w php.ini, .htaccess, httpd.conf lub .user.ini” i nigdzie indziej. memory_limit nie ogranicza rozmiaru pliku, ale WordPress potrzebuje pamięci, by tworzyć przeskalowane kopie dużych obrazków, więc duży plik może nadal zawieść z błędem wyczerpania pamięci już po dotarciu na serwer.

Krok 3: Podnieś limit we właściwym miejscu dla swojego hostingu

Twoja konfiguracja	Gdzie to ustawić	Uwagi
VPS lub serwer dedykowany	php.ini, który PHP faktycznie wczytuje	Potem zrestartuj PHP-FPM lub Apache
Hosting współdzielony z PHP-FPM lub FastCGI	.user.ini w katalogu głównym WordPressa	Zmiana może zadziałać dopiero po 5 minutach
Apache z PHP jako modułem (mod_php)	.htaccess z php_value	Pod PHP-FPM lub FastCGI powoduje błąd 500
Hosting z cPanelem	Software > MultiPHP INI Editor	Zapisuje za Ciebie php.ini, .user.ini lub .htaccess
Nginx przed PHP	client_max_body_size oraz wartości PHP	W przeciwnym razie Nginx zwraca 413
Zarządzany hosting WordPress	Panel hostingu lub wsparcie	Wiele firm ogranicza przesyłanie na poziomie platformy
Strona za Cloudflare	Własny limit przesyłania Cloudflare	100 MB w planach Free i Pro

php.ini (serwer, którym zarządzasz)

Najpierw znajdź wczytywany plik. Utwórz tymczasowy plik z zawartością <?php phpinfo();, otwórz go w przeglądarce, odczytaj wiersz „Loaded Configuration File”, a potem usuń ten plik. Edytuj wskazany php.ini:

upload_max_filesize = 128M
post_max_size = 130M
max_execution_time = 300

Następnie zrestartuj PHP, żeby wczytało zmianę. W PHP-FPM nazwa usługi zawiera wersję, na przykład sudo systemctl restart php8.3-fpm w Debianie lub Ubuntu. Przy mod_php zrestartuj Apache.

.user.ini (większość hostingów współdzielonych)

PHP odczytuje pliki .user.ini tylko wtedy, gdy działa jako CGI lub FastCGI, co obejmuje PHP-FPM. Utwórz lub edytuj .user.ini w folderze, w którym jest wp-config.php:

upload_max_filesize = 128M
post_max_size = 130M

PHP ponownie odczytuje te pliki co user_ini.cache_ttl sekund, domyślnie co 300. Odczekaj pięć minut, zanim uznasz, że nie zadziałało, albo zrestartuj PHP-FPM, jeśli możesz.

.htaccess (tylko Apache z mod_php)

php_value upload_max_filesize 128M
php_value post_max_size 130M

Podręcznik PHP opisuje te dyrektywy dla PHP działającego jako moduł Apache. Jeśli zaraz po zapisaniu tych linii strona pokazuje 500 Internal Server Error, PHP działa jako FastCGI lub PHP-FPM. Usuń te linie i użyj .user.ini.

cPanel MultiPHP INI Editor

W cPanelu otwórz Software > MultiPHP INI Editor, wybierz domenę i zmień wartości w trybie Basic Mode. Według dokumentacji cPanelu Basic Mode zapisuje ustawienia do plików php.ini, .user.ini i .htaccess tam, gdzie każdy z nich je obsługuje, więc nie musisz wiedzieć, którego używa Twój serwer.

Nginx

Nginx sprawdza rozmiar żądania, zanim zobaczy je PHP. Gdy żądanie jest większe niż client_max_body_size, Nginx zwraca 413 Request Entity Too Large. Wartość domyślna to 1m. Dodaj w bloku server wartość co najmniej tak dużą jak post_max_size:

client_max_body_size 130M;

Przetestuj i przeładuj poleceniem sudo nginx -t && sudo systemctl reload nginx. W Apache odpowiednikiem jest LimitRequestBody, którego na standardowym hostingu WordPress rzadko trzeba zmieniać.

Hostingi zarządzane i Cloudflare

Niektóre zarządzane hostingi WordPress ignorują Twój php.ini lub .user.ini i ustawiają limit dla całej platformy. Jeśli po zmianie Kondycja witryny nadal pokazuje starą liczbę, zapytaj hosting, jakie jest maksimum i czy mogą je podnieść.

Jeśli strona działa przez Cloudflare, Cloudflare ma własny limit. Jego dokumentacja cache podaje maksymalne rozmiary przesyłania: 100 MB w planach Free i Pro, 200 MB w Business i do 5 GB w Enterprise. Żadne ustawienie PHP tego nie obejdzie.

Dlaczego wp-config.php nie działa

Wiele artykułów radzi dodać do wp-config.php:

@ini_set( 'upload_max_filesize', '128M' );
@ini_set( 'post_max_size', '130M' );

Oba ustawienia mają tryb INI_PERDIR, a dokumentacja PHP mówi, że ustawień w tym trybie nie można zmieniać przez ini_set(). Znak @ ukrywa błąd, więc linie wyglądają niewinnie i niczego nie zmieniają. W wp-config.php możesz zmienić pamięć, bo memory_limit da się ustawić wszędzie:

define( 'WP_MEMORY_LIMIT', '256M' );

To pomaga, gdy duże obrazki zawodzą podczas przetwarzania. Nie zmienia maksymalnego rozmiaru przesyłanego pliku.

Krok 4: Potwierdź zmianę

Odśwież Media > Dodaj nowy i sprawdź, czy maksymalny rozmiar przesyłanego pliku pokazuje nową wartość. Jeśli nie:

• Sprawdź, czy post_max_size jest co najmniej tak duże jak upload_max_filesize. WordPress używa mniejszej wartości.
• Upewnij się, że edytujesz plik, który PHP faktycznie wczytuje. php.ini w złym folderze jest ignorowany.
• Odczekaj pięć minut po zmianie w .user.ini albo zrestartuj PHP-FPM.
• Jeśli liczba w WordPressie się zmieniła, a przesyłanie nadal kończy się błędem 413, blokada jest w Nginx, proxy Twojego hostingu albo w Cloudflare.
• Jeśli plik dociera do WordPressa, a potem pojawia się „Błąd HTTP”, problemem nie jest już rozmiar. Nasz poradnik o błędzie HTTP przy przesyłaniu obrazka w WordPressie omawia typowe przyczyny.

Jak wysoko ustawić limit?

Ustaw go na największy plik, który naprawdę musisz przesłać, z małym zapasem, i trzymaj post_max_size nieco powyżej upload_max_filesize. Duże pliki przesyłają się też dłużej, więc podnieś max_execution_time, jeśli duże pliki przekraczają czas przy wolnym łączu. Przy bardzo dużych plikach, takich jak długie filmy czy archiwa kopii zapasowych, przesyłanie przez SFTP lub wtyczkę z przesyłaniem w częściach jest zwykle bardziej niezawodne niż jedno ogromne przesyłanie przez przeglądarkę, a limit planu Cloudflare i tak może wykluczyć drogę przez przeglądarkę.

Gdy znasz docelową wartość, narzędzie do maksymalnego rozmiaru przesyłania napisze za Ciebie pasujące linie PHP. Jeśli Twój serwer działa na Nginx, dodaj samodzielnie linię Nginx z tego poradnika.