PHP-FPM: The maximum number of processes has been reached — общий предел process.max
process.max — общий предел процессов PHP для всех пулов вместе. В Ubuntu он не задан, и PHP-FPM ограничивает только каждый пул по отдельности — настройкой pm.max_children. Если кто-то задал process.max меньше суммы pm.max_children всех пулов, PHP-FPM упирается в него и пишет The maximum number of processes has been reached: сайты отвечают медленнее, потому что запросы ждут свободного процесса. Здесь же — что делать, если PHP-FPM не может создать процесс (fork() failed) или поднять предел открытых файлов (failed to set rlimit_files).
Содержание 10
Что сделать прямо сейчас
- Посмотрите, задан ли общий предел:
grep -n 'process.max' /etc/php/8.3/fpm/php-fpm.conf. Если в начале строки стоит;, общего предела нет. - Посмотрите пределы пулов:
grep -n '^pm.max_children' /etc/php/8.3/fpm/pool.d/*.conf— и сложите числа. - Если сумма больше
process.max— поднимите или уберите общий предел.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04. В Ubuntu 26.04 стоит PHP 8.5: в путях и командах вместо 8.3 пишите 8.5. Какая версия у вас, покажет ls /etc/php/.
Как выглядит ошибка
В журнале PHP-FPM /var/log/php8.3-fpm.log:
[13-Nov-2026 10:00:00] WARNING: The maximum number of processes has been reached. Please review your configuration and consider raising 'process.max'«Достигнуто наибольшее число процессов. Проверьте настройки и подумайте, не поднять ли process.max».
WARNING— предупреждение: PHP-FPM работает, но новый процесс PHP не запустил.- Имени пула в записи нет: предел общий для всех пулов.
Найти запись: sudo grep 'process.max' /var/log/php8.3-fpm.log. Журнал читает только root, поэтому нужен sudo — как читать журнал PHP-FPM.
После записи PHP-FPM молчит, пока снова не запустит процесс. Поэтому одна запись может значить много отказов подряд.
Посетители видят то же, что при нехватке процессов в пуле: сайт отвечает медленно, а когда запрос ждёт дольше 60 секунд — 504 Gateway Timeout.
Что такое process.max
| Настройка | Где задают | Что ограничивает |
|---|---|---|
pm.max_children | в файле пула, /etc/php/8.3/fpm/pool.d/www.conf | число процессов одного пула |
process.max | только в /etc/php/8.3/fpm/php-fpm.conf, раздел [global] | число процессов всех пулов вместе |
По умолчанию process.max = 0 — общего предела нет. В Ubuntu строка закомментирована:
; process.max = 128Пока в начале стоит ;, строка не действует. Значит, если запись появилась, process.max кто-то задал: прежний администратор, панель управления или вы сами.
Пример. На сервере три сайта, у каждого свой пул с pm.max_children = 10. Вместе это 30 процессов. Если задано process.max = 20, PHP-FPM запустит не больше 20 на все три сайта. Сайту, которому процессов не хватило, придётся ждать, хотя его пул ещё не упёрся в свои 10.
Чем это отличается от записи server reached pm.max_children setting: та значит, что процессы кончились в одном пуле, у неё в начале [pool www] — разбор.
Как поменять process.max
- Откройте файл:
sudo nano /etc/php/8.3/fpm/php-fpm.conf. - Найдите строку: Ctrl+W, наберите
process.max, Enter. - Поставьте число не меньше суммы
pm.max_childrenвсех пулов, напримерprocess.max = 30. Или поставьте;в начале строки — тогда общего предела не будет. - Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
- Проверьте настройки:
sudo php-fpm8.3 -t— в ответе должно бытьtest is successful. - Перезапустите PHP-FPM:
sudo systemctl restart php8.3-fpm.
process.max задают только в php-fpm.conf. В файле пула PHP-FPM не запустится и напишет unknown entry 'process.max' — где какие настройки.
Если пишет process_max can't be negative
ERROR: process_max can't be negative
ERROR: failed to post process the configuration
ERROR: FPM initialization failed«process.max не может быть отрицательным». В строке process.max стоит число с минусом, например process.max = -1. PHP-FPM не запустился.
Поставьте 0 — без предела — или число больше нуля по шагам выше. Эти строки видны в ответе sudo php-fpm8.3 -t и в sudo journalctl -u php8.3-fpm -n 20.
Если пишет fork() failed
[13-Nov-2026 10:00:00] ERROR: fork() failed: … (11)«Не удалось создать процесс». На месте многоточия — пояснение системы, в скобках — его номер. По номеру видно причину:
| Номер | Что случилось | Что делать |
|---|---|---|
(11) | достигнут предел числа процессов: у службы (TasksMax) или во всей системе | проверьте TasksMax |
(12) | ядру не хватило памяти, чтобы создать процесс | освободите память, добавьте подкачку или уменьшите pm.max_children |
Если запись появилась при запуске, PHP-FPM останавливается — следом запись exiting, bye-bye!. Если во время работы — PHP-FPM работает дальше, но нового процесса нет, и запросы ждут.
Как проверить TasksMax
У службы в systemd есть предел — сколько процессов и потоков она может запустить. Посмотрите его:
systemctl show php8.3-fpm -p TasksMax -p TasksCurrentTasksCurrent— сколько процессов и потоков у PHP-FPM сейчас;TasksMax— предел;infinityзначит, что предела нет.
Если TasksCurrent близко к TasksMax, поднимите предел:
sudo systemctl set-property php8.3-fpm TasksMax=4096Новый предел действует сразу и сохраняется после перезагрузки. Число — пример: поставьте больше суммы pm.max_children всех пулов. Подробнее о команде — пределы службы systemd.
Если пишет failed to set rlimit_files
rlimit_files — сколько файлов и соединений может держать открытыми один процесс. Если задать больше, чем разрешает система, PHP-FPM пишет:
ERROR: failed to set rlimit_files for this pool. Please check your system limits or decrease rlimit_files. setrlimit(RLIMIT_NOFILE, 2000000): … (1)
ERROR: FPM initialization failed«Не удалось задать rlimit_files. Проверьте пределы системы или уменьшите rlimit_files». После RLIMIT_NOFILE, — число из ваших настроек. Номер (1) значит, что система не разрешила поднять предел так высоко.
Что будет, зависит от того, где задана настройка:
| Где задана | Что будет |
|---|---|
/etc/php/8.3/fpm/php-fpm.conf | PHP-FPM не запускается: следом FPM initialization failed — почему PHP-FPM не запускается |
файл пула в /etc/php/8.3/fpm/pool.d/ | процессы пула работают со старым пределом; в начале сообщения [pool www] |
Запись пула пишет сам процесс PHP. В журнале PHP-FPM её видно, только если в пуле включено catch_workers_output = yes — как включить. Тогда она внутри записи said into stderr.
Выше числа из файла /proc/sys/fs/nr_open предел не поднять даже от root. Посмотрите его:
cat /proc/sys/fs/nr_openКоманда выведет одно число, например 1048576. Поставьте rlimit_files меньше него или поставьте ; в начале строки — тогда PHP-FPM возьмёт предел системы. Затем sudo php-fpm8.3 -t и sudo systemctl restart php8.3-fpm.
Какой предел у процессов сейчас:
grep 'open files' /proc/$(pgrep -o php-fpm)/limits
grep 'open files' /proc/$(pgrep -n -u www-data php-fpm)/limitsПервая команда — для главного процесса PHP-FPM, вторая — для процесса пула www. Первое число в строке — действующий предел, второе — потолок, до которого процесс может его поднять.
Так же устроена запись failed to set rlimit_core — это предел размера файла core, который система сохраняет при падении процесса. Если запись мешает запуску, поставьте ; в начале строки rlimit_core.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
The maximum number of processes has been reached | процессы всех пулов упёрлись в process.max | поднимите или уберите process.max |
server reached pm.max_children setting | процессы кончились в одном пуле | Разбор |
unknown entry 'process.max' | process.max записан в файле пула | перенесите в php-fpm.conf |
process_max can't be negative | в process.max число с минусом | поставьте 0 или больше |
fork() failed: … (11) | достигнут предел числа процессов | проверьте TasksMax |
fork() failed: … (12) | не хватило памяти | Out of memory |
failed to set rlimit_files, следом FPM initialization failed | rlimit_files в php-fpm.conf выше, чем разрешает система | уменьшите rlimit_files |
[pool www] failed to set rlimit_files | то же в файле пула | уменьшите rlimit_files |
Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: предел process.max и fork() failed в fpm_children.c, проверка process.max в fpm_conf.c, rlimit_files в fpm_unix.c.
- Образец php-fpm.conf — на английском: process.max, rlimit_files и rlimit_core с пояснениями.
- Настройка PHP-FPM в документации PHP — на английском: все настройки.
- Справка fork(2) в Ubuntu 24.04 — на английском: ошибки EAGAIN и ENOMEM.
- Справка getrlimit(2) в Ubuntu 24.04 — на английском: RLIMIT_NOFILE и ошибка EPERM.
- Справка proc_sys_fs(5) в Ubuntu 24.04 — на английском: файл /proc/sys/fs/nr_open.
- Справка systemd.resource-control(5) в Ubuntu 24.04 — на английском: TasksMax=.
Сверено 13 ноября 2026 года.
Что почитать дальше
- server reached pm.max_childrenкогда процессы кончились в одном пуле.
- Настройки pm в PHP-FPMрежимы и числа пула.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.