Поиск
Ошибки

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).

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

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

  1. Посмотрите, задан ли общий предел: grep -n 'process.max' /etc/php/8.3/fpm/php-fpm.conf. Если в начале строки стоит ;, общего предела нет.
  2. Посмотрите пределы пулов: grep -n '^pm.max_children' /etc/php/8.3/fpm/pool.d/*.conf — и сложите числа.
  3. Если сумма больше 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

  1. Откройте файл: sudo nano /etc/php/8.3/fpm/php-fpm.conf.
  2. Найдите строку: Ctrl+W, наберите process.max, Enter.
  3. Поставьте число не меньше суммы pm.max_children всех пулов, например process.max = 30. Или поставьте ; в начале строки — тогда общего предела не будет.
  4. Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
  5. Проверьте настройки: sudo php-fpm8.3 -t — в ответе должно быть test is successful.
  6. Перезапустите PHP-FPM: sudo systemctl restart php8.3-fpm.
Каждый процесс PHP занимает память. Если поднять предел выше, чем выдержит сервер, память кончится и система начнёт завершать процессы — Out of memory. Сколько процессов выдержит память — посчитайте по размеру процесса.

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 TasksCurrent
  • TasksCurrent — сколько процессов и потоков у 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.confPHP-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 failedrlimit_files в php-fpm.conf выше, чем разрешает системауменьшите rlimit_files
[pool www] failed to set rlimit_filesто же в файле пулауменьшите rlimit_files

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

Источники

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

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

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