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.
Содержание 14
- Что сделать прямо сейчас
- Как выглядит ошибка
- Правило для режима dynamic
- Как исправить числа
- Если пишет must be a positive value
- Если пишет cannot be greater than pm.max_children
- Если пишет max_spare_servers must not be less than min_spare_servers
- Если пишет start_servers must not be less than min_spare_servers
- Если пишет the process manager is missing
- Режимы static и ondemand
- Записи во время работы
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Проверьте настройки:
sudo php-fpm8.3 -t— в ответе будет строкаALERTс ошибкой. - Посмотрите в ней имена настроек и числа в скобках — это значения из файла пула.
- Исправьте числа по правилу, снова
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_children | 5 | больше процессов PHP-FPM не запустит |
pm.start_servers | 2 | сколько процессов запустить при старте |
pm.min_spare_servers | 1 | если свободных процессов меньше, PHP-FPM добавит новые |
pm.max_spare_servers | 3 | если свободных больше, лишние 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.
Как исправить числа
- Откройте файл пула:
sudo nano /etc/php/8.3/fpm/pool.d/www.conf— вместоwww.confфайл пула из сообщения: имя пула стоит после[pool. - Найдите строки: Ctrl+W, наберите
pm.max_children, Enter. Остальные строки pm — ниже. - Поправьте числа по правилу выше.
- Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
- Проверьте:
sudo php-fpm8.3 -t— в ответе должно бытьtest is successful. - Перезапустите:
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.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: проверка чисел pm в fpm_conf.c, запуск и остановка процессов в fpm_process_ctl.c.
- Образец настроек пула www.conf — на английском: pm и все числа pm с пояснениями.
- Настройка PHP-FPM в документации PHP — на английском: все настройки пула.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Режимы pm в PHP-FPMчто значат числа pm и как их выбрать.
- server reached max_childrenесли процессов не хватает.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.