Wyczyść ostrzeżenie Nextcloud dotyczące pamięci PHP na serwerze WWW

Jeśli w panelu administracyjnym Nextcloud pojawi się komunikat, że limit pamięci PHP jest poniżej 512 MB, zwiększenie wartości w losowym wierszu poleceń php.inimoże nie usunąć ostrzeżenia. Nextcloud sprawdza środowisko PHP obsługujące interfejs webowy, podczas gdy PHP z wiersza poleceń może załadować inną konfigurację. Ustaw memory_limitdla aktywnej usługi PHP, uruchom ponownie tę usługę i zweryfikuj wartość w panelu administracyjnym Nextcloud.

Instrukcja administracyjna NextCloud 35, sprawdzona 10 października 2026 r., podaje, że limit pamięci PHP powinien wynosić co najmniej 512 MB. Jest to limit nałożony na skrypt, a nie obietnica, że ​​każdy proces PHP będzie go zużywał. Podniesienie limitu może umożliwić zakończenie żądań intensywnie wykorzystujących pamięć, ale nie zwiększa fizycznej pamięci RAM; na małym serwerze zbyt wielu równoczesnych procesów PHP może nadal wyczerpać pamięć systemową.

Najpierw zidentyfikuj, w jaki sposób NextCloud uruchamia PHP

Przed edycją konfiguracji zidentyfikuj swój stos internetowy i wersję PHP. Zanotuj wersję PHP, jeśli jest wyświetlana w przeglądzie administracyjnym Nextcloud. W powłoce php --iniwyświetla pliki konfiguracyjne używane przez plik binarny PHP w wierszu poleceń, ale nie udowadnia, którego pliku PHP-FPM lub Apache używa do żądań przeglądarki.

php --version
php --ini

W typowej konfiguracji Debiana lub Ubuntu, PHP-FPM często odczytuje /etc/php/<version>/fpm/php.ini, podczas gdy Apache'owy mod_php często odczytuje /etc/php/<version>/apache2/php.ini. Konfiguracja CLI jest zazwyczaj w /etc/php/<version>/cli/php.ini. Zastąp <version>zainstalowaną wersją PHP, taką jak 8.3. Inne systemy operacyjne i panele sterowania mogą używać innych ścieżek.

W podręczniku Nextcloud zaznaczono również, że gotowe wdrożenia, takie jak AIO, Snap, NCP czy Community Docker, zapewniają wstępnie skonfigurowane środowiska PHP. W przypadku tych instalacji należy użyć metody konfiguracji obsługiwanej przez dane wdrożenie, zamiast zakładać, że obowiązuje konfiguracja na poziomie hosta php.ini.

Ustaw limit pamięci PHP na 512 MB lub więcej

PHP-FPM z Nginx lub Apache

Utwórz kopię zapasową aktywnej konfiguracji FPM, a następnie edytuj jej php.iniplik. W systemie Debian lub Ubuntu polecenie może wyglądać następująco; dostosuj wersję i ścieżkę do swojego serwera:

sudo cp /etc/php/8.3/fpm/php.ini /etc/php/8.3/fpm/php.ini.backup
sudo nano /etc/php/8.3/fpm/php.ini

Znajdź istniejącą memory_limitdyrektywę i ustaw ją na co najmniej 512 MB:

memory_limit = 512M

Edytuj istniejącą dyrektywę zamiast dodawać kilka konkurujących kopii. Jeśli konfiguracja puli PHP-FPM ustawia php_admin_value[memory_limit], to ustawienie na poziomie puli może mieć pierwszeństwo; sprawdź aktywny plik puli, jeśli ostrzeżenie nadal występuje.

Uruchom ponownie pasującą usługę PHP-FPM, aby nowe żądania sieciowe korzystały ze zaktualizowanego ustawienia. Na przykład usługa może mieć nazwę php8.3-fpm:

sudo systemctl restart php8.3-fpm

Jeśli Apache używa PHP-FPM, zrestartuj PHP-FPM i przeładuj lub zrestartuj Apache'a tylko wtedy, gdy konfiguracja serwera WWW również uległa zmianie. Użyj poprawnych nazw usług dla swojej dystrybucji.

Apache z mod_php

Jeśli Apache ładuje PHP jako moduł, edytuj konfigurację Apache SAPI, zazwyczaj /etc/php/8.3/apache2/php.iniw Debianie lub Ubuntu. Ustaw memory_limit = 512M, zapisz plik i uruchom ponownie Apache, używając nazwy usługi dla swojego systemu operacyjnego:

sudo systemctl restart apache2

Nie edytuj pliku FPM, jeśli aktywny serwer WWW korzysta z mod_php i odwrotnie. Konfiguracja PHP załadowana przez serwer WWW jest istotna dla ostrzeżenia Admin Overview.

Oficjalny obraz Nextcloud Docker

Oficjalny obraz Nextcloud Docker dokumentuje PHP_MEMORY_LIMITzmienną środowiskową, której domyślna wartość to 512M. Ustaw ją w pliku Compose lub innej konfiguracji wdrożenia kontenera, a następnie utwórz lub zaktualizuj kontener za pomocą tej metody wdrożenia. Ręczna edycja w działającym kontenerze może zostać utracona po jego zastąpieniu. Inne obrazy i platformy orkiestracji mogą używać innych ustawień, dlatego postępuj zgodnie z dokumentacją obrazu, który faktycznie uruchamiasz.

Sprawdź, czy zmiana dotarła do interfejsu internetowego

Zaloguj się jako administrator i ponownie otwórz Ustawienia administracyjne > Przegląd . Sprawdź, czy ostrzeżenie o pamięci zniknęło i czy zgłoszony limit PHP wynosi co najmniej 512 MB. Odśwież stronę po ponownym uruchomieniu usługi; wcześniej załadowana strona może nadal mieć status nieaktualnej.

Jeśli nadal wyświetlana jest niższa liczba, sprawdź kolejno poniższe prawdopodobne przyczyny:

• Nieprawidłowy SAPI: plik CLI został zmieniony, ale PHP-FPM lub Apache używa innej konfiguracji.
• Nieprawidłowa wersja PHP: aktywna usługa sieciowa używa innej wersji niż ta, którą php.iniedytowałeś.
• Nadpisanie: pula FPM, panel sterowania hostingiem lub lokalna konfiguracja PHP nadpisują ustawienia globalne.
• Usługa nie została ponownie uruchomiona: istniejące procesy PHP nadal korzystają z poprzedniej konfiguracji.
• Konfiguracja kontenera: edytowany plik hosta nie jest zamontowany w kontenerze lub kontener nie został utworzony ponownie po zmianie jego środowiska.

Dane wyjściowe interfejsu CLI php --inipozostają przydatne dla zadań cron i OCC, ale nie mogą samodzielnie zweryfikować wartości web. Unikaj pozostawiania publicznej phpinfo()strony na serwerze; zamiast tego skorzystaj z chronionego panelu administratora Nextcloud lub bezpiecznej diagnostyki hosta.

Kiedy wyższy limit nie wystarcza

Zalecenia NextCloud dotyczące 512 MB to minimalna zalecana konfiguracja, a nie uniwersalna formuła ustalania rozmiaru. Duże podglądy, importy lub operacje specyficzne dla aplikacji mogą wymagać więcej pamięci RAM, ale znaczne zwiększenie limitu może sprawić, że każdy proces PHP będzie zużywał więcej pamięci RAM. Jeśli host rozpocznie wymianę lub system operacyjny zakończy procesy PHP, należy zmniejszyć współbieżność PHP-FPM lub zwiększyć pojemność pamięci RAM zamiast stale zwiększać limit dla każdego procesu. Przed wybraniem wyższej wartości należy sprawdzić rzeczywiste użycie pamięci RAM podczas normalnej, szczytowej aktywności.

Jeśli ostrzeżenie zniknie, ale pierwotna operacja nadal się nie powiedzie, poszukaj bardziej szczegółowego błędu PHP w logach Nextcloud, serwera WWW lub PHP-FPM. Ostrzeżenie o limicie pamięci dotyczy limitu alokacji pamięci dla procesu w PHP; nie diagnozuje ono niezwiązanych z tym limitów przesyłania, przekroczeń limitów czasu, obciążenia dysku ani błędów aplikacji.

Oficjalne źródła

• Nextcloud 35: Przygotowanie PHP i konfiguracja ustawień PHP ini
• NextCloud 35: Wymagania dotyczące pamięci systemowej
• Podręcznik PHP: dyrektywa memory_limit
• Oficjalny obraz Nextcloud Docker: konfiguracja PHP