Come appare il messaggio
[29-Oct-2026 10:14:52] WARNING: [pool www] server reached pm.max_children setting (5), consider raising itCause frequenti
- Script lenti tengono occupati i worker a lungo: una query lenta, un'API esterna lenta, un lock.
- Un picco di traffico o dei bot colpiscono pagine PHP senza cache.
pm.max_childrenè semplicemente troppo basso per il carico normale del server.- In passato il valore è stato alzato troppo, PHP ora esaurisce la RAM e i worker vengono terminati (vedi la pagina sull'OOM).
- Richieste di lunga durata come export o import bloccano i worker.
Verifica
- Impostazioni attive del pool (senza commenti)
grep -hE '^(pm|pm\.[a-z_]+) *=' /etc/php/*/fpm/pool.d/*.conf - Quante volte il pool ha raggiunto il limite?
- Memoria media per worker PHP-FPM
ps -eo rss,cmd | awk '/[p]hp-fpm: pool/ {s+=$1; n++} END {if (n) print n " worker, " s/n/1024 " MB di media"}' - Memoria libera sul server
free -m
Soluzione
- Dimensiona il pool in base alla memoria:
pm.max_children= RAM che puoi dare a PHP divisa per la dimensione media dei worker del controllo sopra. - Impostalo nel file del pool sotto
/etc/php/<versione>/fpm/pool.d/www.conf, insieme apm.start_servers,pm.min_spare_serversepm.max_spare_serverscoerenti perpm = dynamic. - Trova le richieste lente: imposta nel pool
request_slowlog_timeout = 5seslowlog = /var/log/php-fpm-slow.loge leggi gli stack trace. - Riduci il carico: metti in cache le pagine, blocca i bot abusivi, sposta i job lunghi fuori dalle richieste web.
- Riavvia il servizio PHP-FPM della tua versione e controlla il log per vedere se l'avviso scompare.
Scenario tipico
Un negozio WooCommerce su un VPS da 4 GB di RAM di solito funziona senza problemi. Durante una promozione il log di PHP-FPM si riempie di righe "server reached pm.max_children setting (5)", le pagine si caricano lente e nginx restituisce qualche 504. Il pool ha ancora il valore predefinito del pacchetto, cinque worker. Misura prima quanta memoria usa in media un worker e calcola quanti worker ci stanno sul server.
Domande frequenti
Posso mettere pm.max_children molto alto?
No. Ogni worker usa memoria. Se il totale supera la RAM, il kernel termina processi o il server va in swap, peggio di richieste in coda.
Quale modalità pm devo usare?
dynamic è un buon default. ondemand risparmia RAM su server poco usati ma è più lento alle prime richieste, static serve per server molto carichi con memoria prevedibile.
Come vedo quanti worker sono occupati in questo momento?
Attiva nel pool pm.status_path = /fpm-status e servi la pagina solo in locale. Mostra processi attivi e inattivi, la lunghezza della coda ("listen queue") e "max children reached", cioè quante volte il limite è stato raggiunto. Un contatore sopra 0 conferma il problema.
Alzare pm.max_children aiuta se il database è lento?
Difficilmente. Più worker significano più query simultanee, il che rallenta ancora di più un database già sovraccarico. Prima risolvi la query lenta o il collo di bottiglia, per esempio con lo slow query log, e solo dopo alza il limite con moderazione.
Come riduco il carico senza aggiungere worker?
Con una cache di pagina per i visitatori anonimi, come la FastCGI cache di nginx o un plugin di cache. Le pagine in cache non richiedono PHP e i worker restano liberi per carrello e checkout. I bot si possono frenare anche con rate limit o nel robots.txt.