PHP-FPM: execution timed out, terminating — PHP-FPM остановил долгий запрос
В пуле PHP-FPM задан лимит времени на один запрос — request_terminate_timeout. Запрос работал дольше, и PHP-FPM остановил процесс, который его выполнял. Посетитель получил 502 Bad Gateway. В записи названы скрипт и адрес страницы: ускорьте этот запрос или поднимите лимит.
Содержание 11
Что сделать прямо сейчас
- Посмотрите в записи скрипт и адрес страницы — это медленный запрос.
- Узнайте, на чём он долго работает, — журнал медленных запросов.
- Если запросу и правда нужно больше времени — например, это импорт или отчёт, — поднимите лимит.
Команды вводятся на сервере: подключитесь к нему по 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:30] WARNING: [pool www] child 12345, script '/var/www/example.com/index.php' (request: "GET /index.php") execution timed out (30.004512 sec), terminating
[13-Nov-2026 10:00:30] WARNING: [pool www] child 12345 exited on signal 15 (SIGTERM) after 412.334012 seconds from start
[13-Nov-2026 10:00:30] NOTICE: [pool www] child 12400 started| Часть | Что значит |
|---|---|
[pool www] | пул, в котором работал запрос |
child 12345 | номер процесса PHP |
script '…' | файл PHP, который выполнялся |
request: "GET /index.php" | метод и адрес запроса; если у адреса были параметры, они после ? |
execution timed out (30.004512 sec), terminating | «время вышло: 30 секунд, останавливаю» |
Вторая строка — процесс остановлен сигналом 15, SIGTERM. Время в ней — сколько процесс прожил с запуска, а не сколько шёл запрос. Третья — PHP-FPM запустил новый процесс вместо остановленного. Номера и время здесь — пример.
Время считается с момента, когда процесс принял запрос. В него входит всё: работа скрипта, ожидание базы данных и ответов других серверов.
Что видит посетитель
Процесс остановлен, не успев отдать страницу, — nginx получает оборванный ответ и показывает 502 Bad Gateway. В журнале ошибок nginx в это время — строка с prematurely closed.
Если запрос работает дольше, чем nginx готов ждать, раньше будет 504 Gateway Timeout: nginx перестаёт ждать ответа через 60 секунд — так задано по умолчанию в fastcgi_read_timeout.
Где задан лимит
Лимит — строка request_terminate_timeout в файле пула, например /etc/php/8.3/fpm/pool.d/www.conf. Посмотреть:
grep -n 'request_terminate_timeout' /etc/php/8.3/fpm/pool.d/*.confЕсли в начале строки ;, строка не действует. По умолчанию лимит 0 — выключен: в Ubuntu 24.04 строка ;request_terminate_timeout = 0 закомментирована.
Как записать время:
| Запись | Что значит |
|---|---|
30 или 30s | 30 секунд |
5m | 5 минут |
1h | 1 час |
0 | лимита нет |
Другие окончания, например 30sec или 5min, PHP-FPM не примет и не запустится — unable to parse value.
Почему PHP не остановил скрипт сам
У PHP есть свой лимит — max_execution_time, по умолчанию 30 секунд. Но в Linux в него не входит ожидание: ответа базы данных, другого сервера по сети, sleep(). Скрипт, который долго ждёт, может работать намного дольше 30 секунд — подробнее.
request_terminate_timeout считает время по часам, поэтому останавливает и такие скрипты.
Как поменять лимит
- Откройте файл пула:
sudo nano /etc/php/8.3/fpm/pool.d/www.conf— вместоwww.confфайл вашего пула. - Найдите строку: Ctrl+W, наберите
request_terminate_timeout, Enter. - Уберите
;в начале и задайте время, например:
request_terminate_timeout = 120s- Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
- Проверьте:
sudo php-fpm8.3 -t— в ответе должно бытьtest is successful. - Перезапустите:
sudo systemctl restart php8.3-fpm.
Лимит действует на все сайты пула. Если долго работает только одна часть сайта — например, импорт товаров, — вынесите её в отдельный пул со своим лимитом: отдельный пул PHP-FPM.
Как согласовать лимиты
Запрос проходит три лимита:
| Где | Настройка | По умолчанию |
|---|---|---|
| PHP | max_execution_time | 30 секунд, без ожидания |
| PHP-FPM | request_terminate_timeout | 0 — выключен |
| nginx | fastcgi_read_timeout | 60 секунд |
Если поднимаете request_terminate_timeout выше 60 секунд, поднимите и fastcgi_read_timeout в настройках сайта в nginx — иначе посетитель получит 504 раньше. Как это сделать — какие таймауты за это отвечают.
Как найти, на чём скрипт работает долго
Включите журнал медленных запросов: PHP-FPM запишет, какие функции выполнялись, когда запрос шёл дольше заданного времени — например, 10 секунд. Как включить — как найти медленные скрипты PHP. Как читать записи — executing too slow.
Время в журнале медленных запросов ставьте меньше request_terminate_timeout: иначе процесс остановят раньше, чем PHP-FPM запишет, чем он занят. Если поставить больше, PHP-FPM не запустится — ошибка настроек slowlog.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
execution timed out (… sec), terminating | запрос работал дольше request_terminate_timeout | найдите медленный запрос или поднимите лимит |
exited on signal 15 (SIGTERM) после такой строки | PHP-FPM остановил процесс по лимиту | смотрите строку выше |
сайт отвечает 502, в журнале nginx prematurely closed | процесс остановлен во время запроса | Разбор 502 |
| сайт отвечает 504 | nginx перестал ждать раньше PHP-FPM | согласуйте лимиты |
server reached max_children рядом | процессы заняты долгими запросами | Разбор |
Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: проверка лимита в fpm_request.c, запись о завершении процесса в fpm_children.c.
- Образец настроек пула www.conf — на английском: request_terminate_timeout и запись времени.
- Настройка PHP-FPM в документации PHP — на английском: все настройки пула.
- Модуль fastcgi в nginx — на английском: fastcgi_read_timeout.
Сверено 13 ноября 2026 года.
Что почитать дальше
- 504 Gateway Timeoutесли nginx не дождался PHP.
- executing too slow в PHP-FPMкак читать журнал медленных запросов.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.