Поиск
Ошибки

PHP-FPM: ошибки настроек pm — must be a positive value, cannot be greater than pm.max_children

Строки pm в пуле PHP-FPM задают, сколько процессов PHP держать запущенными. При запуске PHP-FPM проверяет, что числа согласованы между собой. Если нет — пишет ALERT с именами и значениями настроек и не запускается. Поправьте числа по правилу: pm.min_spare_servers ≤ pm.start_servers ≤ pm.max_spare_servers ≤ pm.max_children.

≈ 9 мин чтения
Содержание 14

Что сделать прямо сейчас

  1. Проверьте настройки: sudo php-fpm8.3 -t — в ответе будет строка ALERT с ошибкой.
  2. Посмотрите в ней имена настроек и числа в скобках — это значения из файла пула.
  3. Исправьте числа по правилу, снова sudo php-fpm8.3 -t и sudo systemctl restart php8.3-fpm.

Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04. В Ubuntu 26.04 стоит PHP 8.5: в путях и командах вместо 8.3 пишите 8.5. Какая версия у вас, покажет ls /etc/php/.

Как выглядит ошибка

[13-Nov-2026 10:00:00] ALERT: [pool www] pm.start_servers(10) must not be less than pm.min_spare_servers(1) and not greater than pm.max_spare_servers(3)
[13-Nov-2026 10:00:00] ERROR: failed to post process the configuration
[13-Nov-2026 10:00:00] ERROR: FPM initialization failed

«В пуле www pm.start_servers (10) должно быть не меньше pm.min_spare_servers (1) и не больше pm.max_spare_servers (3)». В скобках — значения из файла пула. Вторая и третья строки — последствия: настройки не приняты, PHP-FPM не запустился. Числа здесь — пример.

Номера строки в сообщении нет: PHP-FPM сверяет числа между собой, когда прочитал все файлы. Найдите строки pm во всех пулах:

grep -n '^pm' /etc/php/8.3/fpm/pool.d/*.conf

Эти записи видны в ответе sudo php-fpm8.3 -t, в sudo systemctl status php8.3-fpm и в sudo journalctl -u php8.3-fpm -n 30.

Правило для режима dynamic

В Ubuntu 24.04 пул www работает в режиме pm = dynamic. В нём четыре числа:

СтрокаВ Ubuntu 24.04Что значит
pm.max_children5больше процессов PHP-FPM не запустит
pm.start_servers2сколько процессов запустить при старте
pm.min_spare_servers1если свободных процессов меньше, PHP-FPM добавит новые
pm.max_spare_servers3если свободных больше, лишние PHP-FPM остановит

Свободный процесс — тот, что сейчас не выполняет запрос и готов принять следующий.

Числа должны идти так:

1 ≤ pm.min_spare_servers ≤ pm.start_servers ≤ pm.max_spare_servers ≤ pm.max_children

Пример согласованных чисел для сервера побольше:

pm.max_children = 20
pm.start_servers = 4
pm.min_spare_servers = 2
pm.max_spare_servers = 6

Сколько ставить pm.max_children для вашего объёма памяти — как выбрать pm.max_children.

Как исправить числа

  1. Откройте файл пула: sudo nano /etc/php/8.3/fpm/pool.d/www.conf — вместо www.conf файл пула из сообщения: имя пула стоит после [pool.
  2. Найдите строки: Ctrl+W, наберите pm.max_children, Enter. Остальные строки pm — ниже.
  3. Поправьте числа по правилу выше.
  4. Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
  5. Проверьте: sudo php-fpm8.3 -t — в ответе должно быть test is successful.
  6. Перезапустите: sudo systemctl restart php8.3-fpm.

Если пишет must be a positive value

ALERT: [pool www] pm.max_children must be a positive value

«pm.max_children должно быть больше нуля». В строке ноль или отрицательное число — или строки нет совсем: тогда PHP-FPM считает значение нулём. Так же PHP-FPM пишет и о других числах:

СообщениеКогдаЧто сделать
pm.max_children must be a positive valueв любом режимепоставьте число от 1, например pm.max_children = 5
pm.min_spare_servers(0) must be a positive valueв режиме dynamicпоставьте от 1
pm.max_spare_servers(0) must be a positive valueв режиме dynamicпоставьте от 1 и не меньше pm.min_spare_servers
pm.max_spawn_rate must be a positive valueв режиме dynamicпоставьте от 1 или удалите строку: по умолчанию 32

Если в числе буквы, например 5k, ошибка будет другой — is not a valid number.

Если пишет cannot be greater than pm.max_children

ALERT: [pool www] pm.min_spare_servers(2) and pm.max_spare_servers(10) cannot be greater than pm.max_children(5)

«pm.min_spare_servers и pm.max_spare_servers не могут быть больше pm.max_children». Свободных процессов не может быть больше, чем процессов всего. Уменьшите pm.max_spare_servers или поднимите pm.max_children. Так бывает, когда уменьшили pm.max_children, а остальные числа оставили.

Если пишет max_spare_servers must not be less than min_spare_servers

ALERT: [pool www] pm.max_spare_servers(1) must not be less than pm.min_spare_servers(2)

«pm.max_spare_servers не может быть меньше pm.min_spare_servers». Числа перепутаны местами: наименьшее число свободных процессов больше наибольшего. Поменяйте их местами.

Если пишет start_servers must not be less than min_spare_servers

Сообщение — в примере выше. Число процессов при запуске должно быть между pm.min_spare_servers и pm.max_spare_servers. Поставьте pm.start_servers в этих пределах или удалите строку.

Если строки pm.start_servers нет или в ней 0, PHP-FPM вычислит число сам и напишет:

NOTICE: [pool www] pm.start_servers is not set. It's been set to 2.

Это не ошибка. PHP-FPM взял середину между pm.min_spare_servers и pm.max_spare_servers, дробную часть отбросил.

Если пишет the process manager is missing

ALERT: [pool www] the process manager is missing (static, dynamic or ondemand)

«Не задан режим управления процессами». В пуле нет строки pm. Допишите её, например pm = dynamic. Если строка есть, но с другим словом, сообщение будет другим — invalid process manager.

Режимы static и ondemand

В режиме pm = static PHP-FPM держит ровно pm.max_children процессов. Остальные числа pm в этом режиме не проверяются и не действуют.

В режиме pm = ondemand процессы запускаются, когда приходят запросы, и останавливаются после простоя. Числа pm.start_servers и pm.…_spare_servers в нём не действуют. Свои ошибки:

СообщениеЧто значитЧто сделать
pm.process_idle_timeout(0s) must be greater than 0sвремя простоя до остановки процесса — нольпоставьте, например, pm.process_idle_timeout = 10s или удалите строку: по умолчанию 10 секунд
ondemand process manager can ONLY be used when events.mechanism is either epoll (Linux) or kqueue (*BSD).в /etc/php/8.3/fpm/php-fpm.conf задан events.mechanism = select или pollудалите строку events.mechanism: в Linux PHP-FPM сам выберет epoll

Чем отличаются режимы и какой выбрать — три режима pm.

Записи во время работы

Эти записи появляются, когда PHP-FPM уже работает. Сайт открывается, но PHP-FPM сообщает, что процессов мало.

WARNING: [pool www] seems busy (you may need to increase pm.start_servers, or pm.min/max_spare_servers), spawning 8 children, there are 0 idle, and 12 total children

«Пул www, похоже, занят: возможно, нужно поднять pm.start_servers или pm.min_spare_servers и pm.max_spare_servers. Запускаю 8 процессов, свободных 0, всего 12». Свободных процессов меньше pm.min_spare_servers, и PHP-FPM несколько проверок подряд добавляет новые. Запись бывает при всплеске посещений. Если она повторяется, поднимите pm.min_spare_servers и pm.max_spare_servers, соблюдая правило выше.

WARNING: [pool www] server reached pm.max_children setting (5), consider raising it

«Достигнут предел pm.max_children». Все процессы заняты, новые запросы ждут — разбор server reached max_children.

Прежде чем поднимать pm.max_children, проверьте свободную память: каждый процесс PHP занимает память, и при нехватке ядро начнёт останавливать процессы — Out of memory: Killed process.

Ошибки и как их исправить

Что видитеПричинаЧто делать
pm.max_children must be a positive valueноль, отрицательное число или нет строкипоставьте от 1
pm.min_spare_servers(…) must be a positive valueноль в режиме dynamicпоставьте от 1
… cannot be greater than pm.max_children(…)свободных больше, чем всегоуменьшите spare или поднимите max_children
pm.max_spare_servers(…) must not be less than pm.min_spare_servers(…)числа перепутаныпоменяйте местами
pm.start_servers(…) must not be less than …start_servers вне пределовпоставьте между min и max
pm.start_servers is not setстроки нет, число вычисленоне ошибка
the process manager is missingнет строки pmдопишите pm = dynamic
pm.process_idle_timeout(0s) must be greater than 0sноль в режиме ondemandпоставьте 10s
seems busyмало свободных процессовподнимите spare
server reached pm.max_children settingвсе процессы занятыРазбор

Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.

Источники

Сверено 13 ноября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше