Wis de PHP-geheugenwaarschuwing van Nextcloud op de webserver.

Als het beheerdersoverzicht van Nextcloud aangeeft dat de PHP-geheugenlimiet lager is dan 512 MB, php.inikan het verhogen van deze waarde de waarschuwing mogelijk niet verhelpen. Nextcloud controleert de PHP-omgeving die de webinterface bedient, terwijl PHP via de commandoregel een andere configuratie kan gebruiken. Stel de limiet in memory_limitvoor de actieve web-PHP-service, herstart deze service en controleer de waarde in het beheerdersoverzicht van Nextcloud.

Volgens de beheerdershandleiding van Nextcloud 35, geraadpleegd op 10 oktober 2026, moet de geheugenlimiet voor PHP minimaal 512 MB zijn. Dit is een limiet per script, geen garantie dat elk PHP-proces zoveel geheugen zal gebruiken. Het verhogen van de limiet kan ervoor zorgen dat geheugenintensieve verzoeken worden afgehandeld, maar het voegt geen fysiek RAM-geheugen toe; op een kleine server kunnen te veel gelijktijdige PHP-processen nog steeds het systeemgeheugen uitputten.

Leg eerst uit hoe Nextcloud PHP uitvoert.

Voordat u de configuratie wijzigt, moet u uw webstack en PHP-versie identificeren. In het Nextcloud Admin-overzicht kunt u de PHP-versie noteren als deze wordt weergegeven. In een shell php --iniworden de configuratiebestanden weergegeven die door het PHP-programma op de commandoregel worden gebruikt, maar dit geeft niet aan welk bestand PHP-FPM of Apache gebruikt voor browserverzoeken.

php --version
php --ini

Bij een typische Debian- of Ubuntu-installatie leest PHP-FPM vaak `php/php/php` /etc/php/<version>/fpm/php.ini, terwijl Apache's mod_php vaak `php/php/php` leest . De CLI /etc/php/<version>/apache2/php.ini-configuratie bevindt zich meestal onder ` php /etc/php/<version>/cli/php.ini/ ...<version>8.3

In de handleiding van Nextcloud staat ook vermeld dat kant-en-klare implementaties zoals AIO, Snap, NCP of Community Docker vooraf geconfigureerde PHP-omgevingen bieden. Gebruik voor deze installaties de door de implementatie ondersteunde configuratiemethode in plaats van aan te nemen dat een configuratie op hostniveau php.inivan toepassing is.

Stel de PHP-geheugenlimiet voor de webserver in op 512 MB of hoger.

PHP-FPM met Nginx of Apache

Maak een back-up van de actieve FPM-configuratie en bewerk vervolgens het bestand php.ini. Op Debian of Ubuntu kan een commando er als volgt uitzien; pas de versie en het pad aan naar uw server:

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

Zoek de bestaande memory_limitrichtlijn en stel deze in op minimaal 512 MB:

memory_limit = 512M

Bewerk de bestaande instructie in plaats van meerdere concurrerende kopieën toe te voegen. Als een PHP-FPM-poolconfiguratie deze instelling gebruikt php_admin_value[memory_limit], kan die instelling op poolniveau voorrang krijgen; controleer het actieve poolbestand als de waarschuwing blijft verschijnen.

Start de bijbehorende PHP-FPM-service opnieuw op, zodat nieuwe webverzoeken de bijgewerkte instelling gebruiken. De service kan bijvoorbeeld de volgende naam hebben php8.3-fpm:

sudo systemctl restart php8.3-fpm

Als Apache PHP-FPM gebruikt, start dan PHP-FPM opnieuw en herlaad of herstart Apache alleen als uw webserverconfiguratie ook is gewijzigd. Gebruik de juiste servicenamen van uw distributie.

Apache met mod_php

Als Apache PHP als module laadt, bewerk dan de Apache SAPI-configuratie, meestal /etc/php/8.3/apache2/php.iniop Debian of Ubuntu. Stel de juiste instellingen in memory_limit = 512M, sla het bestand op en herstart Apache met de servicenaam die voor uw besturingssysteem geschikt is.

sudo systemctl restart apache2

Bewerk het FPM-bestand niet als de actieve webserver mod_php gebruikt, en omgekeerd. De PHP-configuratie die door de webserver wordt geladen, is relevant voor de waarschuwing in het beheerdersoverzicht.

Officiële Nextcloud Docker-image

De officiële Nextcloud Docker-image documenteert een PHP_MEMORY_LIMITomgevingsvariabele met een standaardwaarde van 512M. Stel deze in in uw Compose-bestand of andere configuratie voor containerimplementatie en maak de container vervolgens opnieuw aan of werk deze bij via die implementatiemethode. Handmatige wijzigingen in een draaiende container kunnen verloren gaan wanneer deze wordt vervangen. Andere images en orchestratieplatformen kunnen andere instellingen gebruiken, dus raadpleeg de documentatie voor de image die u daadwerkelijk gebruikt.

Controleer of de wijziging de webinterface heeft bereikt.

Meld u aan als beheerder en open de beheerdersinstellingen opnieuw > Overzicht . Controleer of de geheugenwaarschuwing verdwenen is en of de gerapporteerde PHP-limiet minimaal 512 MB bedraagt. Vernieuw de pagina na het herstarten van de service; een eerder geladen pagina kan nog steeds de status 'verouderd' weergeven.

Als er nog steeds een lager getal wordt weergegeven, controleer dan de volgende mogelijke oorzaken in deze volgorde:

• Foutieve SAPI: het CLI-bestand is gewijzigd, maar PHP-FPM of Apache gebruikt een andere configuratie.
• Onjuiste PHP-versie: de actieve webservice gebruikt een andere versie dan degene die php.iniu hebt bewerkt.
• Override: een FPM-pool, hostingcontrolepaneel of lokale PHP-configuratie overschrijft de globale instelling.
• De service is niet opnieuw opgestart: de bestaande PHP-workers gebruiken nog steeds de vorige configuratie.
• Containerconfiguratie: het bewerkte hostbestand is niet in de container gekoppeld of de container is niet opnieuw aangemaakt na het wijzigen van de omgeving.

De CLI-uitvoer php --iniblijft nuttig voor cron- en OCC-taken, maar kan de webwaarde niet zelfstandig verifiëren. Laat geen openbare phpinfo()pagina op de server staan; gebruik in plaats daarvan het beveiligde Nextcloud-beheeroverzicht of de beveiligde diagnostische tools van uw hostingprovider.

Wanneer een hogere limiet niet voldoende is

De richtlijn van 512 MB van Nextcloud is een minimale configuratieaanbeveling, geen universele formule voor de benodigde capaciteit. Grote previews, importen of app-specifieke bewerkingen kunnen meer geheugen vereisen, maar een aanzienlijke verhoging van de limiet kan ertoe leiden dat elk PHP-proces meer RAM-geheugen verbruikt. Als de host begint te swappen of het besturingssysteem PHP-workers beëindigt, verlaag dan de PHP-FPM-concurrency of voeg geheugencapaciteit toe in plaats van de limiet per proces te blijven verhogen. Controleer het werkelijke RAM-gebruik tijdens normale piekbelasting voordat u een hogere waarde kiest.

Als de waarschuwing verdwijnt maar de oorspronkelijke bewerking nog steeds mislukt, zoek dan naar een specifiekere PHP-fout in het Nextcloud-logboek en de logboeken van de webserver of PHP-FPM. Een waarschuwing over een geheugenlimiet heeft betrekking op de maximale toewijzing van geheugen per proces door PHP; deze waarschuwing diagnosticeert geen ongerelateerde uploadlimieten, time-outs, schijfproblemen of applicatiefouten.

Officiële referenties

• Nextcloud 35: PHP voorbereiden en PHP ini-instellingen configureren
• Nextcloud 35: Systeemgeheugenvereisten
• PHP-handleiding: memory_limit-richtlijn
• Officiële Nextcloud Docker-image: PHP-configuratie