Zum Inhalt springen

PHP-FPM: pm.max_children richtig einstellen

Die Warnung bedeutet: Alle PHP-FPM-Prozesse eines Pools waren gleichzeitig belegt, neue Anfragen mussten in der Warteschlange warten. Messen Sie, wie viel Arbeitsspeicher ein Prozess tatsächlich braucht, teilen Sie den für PHP verfügbaren Speicher durch diesen Wert und tragen Sie das Ergebnis als pm.max_children ein. Sind die Prozesse belegt, weil Anfragen zu lange dauern, beheben Sie zuerst die langsamen Anfragen – ein größerer Pool verschiebt den Engpass sonst nur.

Die Meldung server reached pm.max_children setting bedeutet, dass alle Arbeitsprozesse eines PHP-FPM-Pools gleichzeitig belegt waren und die nächste Anfrage warten musste. Die Lösung besteht aus zwei Schritten: Klären Sie, ob die Prozesse aus gutem Grund belegt sind (echter Besucherandrang) oder aus schlechtem (langsame Anfragen), und stellen Sie pm.max_children dann auf einen Wert ein, den der Arbeitsspeicher des Servers auch trägt.

Was sagt die Warnung genau?

PHP-FPM arbeitet mit einem oder mehreren Pools. Jeder Pool hat eine feste Obergrenze an Prozessen, und jeder Prozess bearbeitet immer nur eine Anfrage. Ist die Grenze erreicht, schreibt PHP-FPM eine Zeile wie diese ins Protokoll:

[18-Nov-2026 09:14:02] WARNING: [pool www] server reached pm.max_children setting (5), consider raising it

Unter Debian und Ubuntu liegt das Protokoll in /var/log/php8.3-fpm.log (mit Ihrer PHP-Version im Namen), bei der RHEL-Familie in /var/log/php-fpm/error.log. So zählen Sie, wie oft das passiert ist:

grep -c "reached pm.max_children" /var/log/php8.3-fpm.log

Anfragen, die keinen freien Prozess finden, gehen nicht sofort verloren. Sie warten in der Warteschlange des Sockets. Wird rechtzeitig ein Prozess frei, sieht der Besucher nur eine langsamere Seite. Wenn nicht, gibt der Webserver auf und antwortet mit 502 Bad Gateway oder 504 Gateway Timeout. Eine einzelne Warnung während einer Lastspitze ist harmlos. Eine Warnung alle paar Minuten ist ein Kapazitätsproblem.

Die Zahl in Klammern ist die aktuelle Grenze. Die 5 im Beispiel ist der Wert, den Debian und Ubuntu in /etc/php/8.3/fpm/pool.d/www.conf ausliefern – für fast jede echte Website ist er zu niedrig. Bei der RHEL-Familie heißt der Dienst php-fpm, die Pool-Datei liegt unter /etc/php-fpm.d/www.conf; die Direktiven sind dieselben.

Wie sehe ich, was der Pool gerade tut?

PHP-FPM bringt eine Statusseite mit. Sie wird in der Pool-Konfiguration eingeschaltet:

; /etc/php/8.3/fpm/pool.d/www.conf
pm.status_path = /fpm-status

Danach laden Sie den Dienst mit systemctl reload php8.3-fpm neu. Die Statusseite darf nie öffentlich erreichbar sein. Erlauben Sie den Pfad im Webserver nur für 127.0.0.1 – oder fragen Sie den Socket direkt ab, ganz ohne Webserver:

apt install libfcgi-bin
SCRIPT_NAME=/fpm-status SCRIPT_FILENAME=/fpm-status REQUEST_METHOD=GET \
  cgi-fcgi -bind -connect /run/php/php8.3-fpm.sock

Die Ausgabe sieht so aus:

pool:                 www
process manager:      dynamic
start time:           18/Nov/2026:08:01:30 +0000
start since:          4352
accepted conn:        18230
listen queue:         0
max listen queue:     14
listen queue len:     4096
idle processes:       2
active processes:     3
total processes:      5
max active processes: 5
max children reached: 7
slow requests:        0

Auf diese Zeilen kommt es an:

  • active processes: Prozesse, die in diesem Moment eine Anfrage bearbeiten.
  • listen queue: Anfragen, die gerade auf einen freien Prozess warten. Bleibt der Wert über null, warten Besucher.
  • max listen queue: die längste Warteschlange seit dem Start von PHP-FPM.
  • max children reached: wie oft der Pool seit dem Start an seine Grenze gestoßen ist.

Wichtig: pm.max_children selbst steht nicht auf der Statusseite. total processes ist die aktuelle Größe des Pools, nicht die erlaubte. Die eingestellten Werte zeigt php-fpm8.3 -tt.

Wie berechne ich pm.max_children?

Die Grenze ist eine Frage des Arbeitsspeichers. Jeder Prozess ist ein vollständiger PHP-Prozess, und alle zusammen müssen neben allem anderen auf dem Server in den RAM passen.

Messen Sie zuerst, was ein Prozess braucht. Dieser Befehl bildet den Durchschnitt über alle laufenden PHP-FPM-Prozesse:

ps --no-headers -o rss -C php-fpm8.3 | awk '{s+=$1} END {printf "%d Prozesse, Durchschnitt %.0f MB\n", NR, s/NR/1024}'
12 Prozesse, Durchschnitt 78 MB

Messen Sie unter normaler Last und nicht direkt nach einem Neustart, denn die Prozesse wachsen mit den Anfragen, die sie bearbeiten. Der Wert ist eine Schätzung nach oben: Er enthält auch gemeinsam genutzten Speicher wie den OPcache, den es nur einmal gibt. Damit liegen Sie auf der sicheren Seite, und genau das ist hier gewollt.

Legen Sie dann fest, wie viel Speicher PHP bekommen darf. Ziehen Sie vom gesamten RAM ab, was Datenbank, Webserver, andere Dienste und der Dateicache des Kernels brauchen. Auf einem Server mit 8 GB RAM und einer lokalen Datenbank, die 2,5 GB belegt, sind etwa 4 GB für PHP ein vernünftiges Budget.

pm.max_children = Speicher für PHP / Speicher je Prozess
                = 4096 MB / 78 MB
                = 52   (abgerundet auf 50)

Laufen mehrere Pools auf dem Server, teilen sie sich das Budget: Es zählt die Summe aller pm.max_children-Werte.

Welche pm-Einstellungen gehören zusammen?

Eine typische Konfiguration für das Beispiel oben:

pm = dynamic
pm.max_children = 50
pm.start_servers = 10
pm.min_spare_servers = 5
pm.max_spare_servers = 15
pm.max_requests = 500
  • pm = dynamic hält zwischen min_spare_servers und max_spare_servers freie Prozesse bereit und startet bei Bedarf weitere, höchstens bis max_children.
  • pm = static lässt immer genau max_children Prozesse laufen. Kein Aufwand fürs Starten, gleichbleibender Speicherbedarf – sinnvoll auf reinen PHP-Servern.
  • pm = ondemand startet Prozesse erst, wenn Anfragen eintreffen, und beendet sie nach pm.process_idle_timeout. Geeignet für Server mit vielen kleinen, selten genutzten Pools.
  • pm.max_requests startet einen Prozess nach dieser Anzahl von Anfragen neu. Das begrenzt die Folgen von Speicherlecks in Erweiterungen oder im Anwendungscode. Die Vorgabe ist 0, also nie.

Prüfen Sie vor dem Neuladen die Syntax, damit ein Tippfehler nicht die Website lahmlegt:

php-fpm8.3 -t
systemctl reload php8.3-fpm

Und wenn die Prozesse belegt sind, weil Anfragen zu lange dauern?

Ein Pool läuft auch dann voll, wenn jede einzelne Anfrage zu lange braucht. Fünfzig Prozesse, die jeweils drei Sekunden auf eine Datenbankabfrage warten, schaffen weniger als zehn schnelle. Wer in dieser Lage die Grenze erhöht, verstärkt den Druck auf die Datenbank und verschlimmert das Problem.

Wo die Zeit bleibt, zeigt das Slow-Log von PHP-FPM. Es schreibt für jede Anfrage, die länger als die Schwelle läuft, einen Stacktrace:

request_slowlog_timeout = 5s
slowlog = /var/log/php8.3-fpm.slow.log

Typische Ursachen sind langsame Datenbankabfragen, Aufrufe externer Schnittstellen ohne Zeitlimit und Bots, die teure Seiten in Serie abrufen. Mit request_terminate_timeout setzen Sie eine harte Obergrenze, damit eine hängende Anfrage keinen Prozess auf Dauer blockiert. Vorsicht, wenn Sie lange Aufgaben über den Webserver laufen lassen: Die Einstellung beendet auch diese.

Ob der Server insgesamt überlastet ist oder nur der Pool zu klein, zeigt die Last im Verhältnis zur Zahl der CPU-Kerne. Wie Sie die Werte lesen, steht im Artikel Load Average unter Linux verstehen.

Häufige Fehler

  • Den Wert erhöhen, ohne den Speicher zu messen. Eine Grenze von 200 bei 80 MB je Prozess braucht im schlimmsten Fall 16 GB. Hat der Server weniger, beginnt er unter Last zu swappen, oder der Kernel beendet Prozesse – oft die Datenbank.
  • Die falsche Datei bearbeiten. Jede PHP-Version hat ihr eigenes Konfigurationsverzeichnis, jeder Pool seine eigene Datei. php-fpm8.3 -tt zeigt, welche Werte tatsächlich gelten.
  • Den Webserver vergessen. Nimmt Apache oder nginx deutlich mehr gleichzeitige Verbindungen an, als PHP-FPM Prozesse hat, füllt sich die Warteschlange. Nimmt er weniger an, werden die zusätzlichen Prozesse nie genutzt.
  • Die Statusseite offen ins Internet stellen. Sie verrät interne Details und in der ausführlichen Ansicht auch die Adressen, die gerade bearbeitet werden.
  • Einen vollen Pool nur für ein PHP-Problem halten. Eine volle Festplatte oder eine blockierte Datenbank erzeugt dasselbe Bild. Läuft der Pool plötzlich voll, prüfen Sie auch die Grundlagen – etwa mit den Schritten aus Festplatte voll unter Linux: Speicherfresser finden.

Checkliste

  1. Warnungen im PHP-FPM-Protokoll zählen und notieren, wann sie auftreten.
  2. Statusseite nur für lokalen Zugriff einschalten, listen queue und max children reached ablesen.
  3. Durchschnittlichen Speicherbedarf je Prozess unter normaler Last messen.
  4. Speicherbudget für PHP festlegen und durch den Bedarf je Prozess teilen.
  5. pm.max_children und die passenden Spare-Werte setzen, mit php-fpm8.3 -t prüfen, neu laden.
  6. Slow-Log einschalten und die langsamsten Anfragen beheben.
  7. Warteschlange und Speicher einige Tage beobachten und nachjustieren.

Wie Lynx Heartbeat dabei hilft

Der Agent von Lynx Heartbeat liest die Statusseite von PHP-FPM jede Minute lokal aus und hält fest, wie viele Prozesse aktiv sind, wie lang die Warteschlange ist und ob der Pool seit der letzten Messung an seine Grenze gestoßen ist. Sie sehen den Moment, in dem der Pool vollläuft, neben Last und Arbeitsspeicher desselben Servers – und nicht erst Tage später in einer Protokolldatei. Alarme werden entprellt, eine kurze Spitze weckt also niemanden; wie das funktioniert, beschreibt der Artikel über Alarmmüdigkeit, Ruhezeiten und Eskalation. Was der Agent sonst noch misst, steht auf der Seite Funktionen.

Häufige Fragen

Was bedeutet 'server reached pm.max_children setting'?

Alle Arbeitsprozesse des PHP-FPM-Pools waren im selben Moment belegt. Weitere Anfragen werden nicht sofort abgewiesen, sondern warten in der Warteschlange des Sockets, bis ein Prozess frei wird. Besucher merken das an langsamen Seiten oder, wenn es zu lange dauert, an den Fehlern 502 oder 504 des Webservers.

Wie berechne ich pm.max_children?

Teilen Sie den Arbeitsspeicher, den Sie für PHP reservieren können, durch den Speicherbedarf eines Prozesses. Den Durchschnitt der laufenden Prozesse messen Sie mit ps. Lassen Sie genug Speicher für Datenbank, Webserver und Dateicache übrig. Beispiel: 4 GB für PHP und 80 MB je Prozess ergeben rund 50 Prozesse.

Was ist besser: pm = dynamic, static oder ondemand?

dynamic ist für die meisten Server eine solide Wahl. static spart das Starten von Prozessen und passt zu reinen PHP-Servern mit gleichmäßiger Last. ondemand startet Prozesse erst bei Bedarf und spart Speicher auf Servern mit vielen selten genutzten Pools – dafür ist die erste Anfrage langsamer.

Wird meine Website schneller, wenn ich pm.max_children erhöhe?

Nur wenn Anfragen tatsächlich auf einen freien Prozess gewartet haben und der Server noch Speicher und CPU frei hat. Sind die Prozesse wegen langsamer Datenbankabfragen oder externer Aufrufe belegt, belasten mehr Prozesse denselben Engpass noch stärker. Ein zu hoher Wert kann den Server ins Swappen treiben oder den OOM-Killer auslösen.

Server

Verwandte Artikel

Alle Artikel