Ошибки PHP-FPM: как по записи в журнале найти причину
PHP-FPM запускает PHP-код сайта: nginx передаёт ему запросы к файлам .php и отдаёт посетителю ответ. Когда с PHP-FPM что-то не так, сайт отвечает 502 или 504, а PHP-FPM пишет запись в свой журнал. Найдите слова из записи в таблицах ниже и откройте разбор.
Содержание 7
Что сделать прямо сейчас
- Посмотрите последние записи журнала PHP-FPM:
sudo tail -n 30 /var/log/php8.3-fpm.log. - Если PHP-FPM не запускается, посмотрите журнал службы:
sudo journalctl -u php8.3-fpm -n 30. - Найдите слова из записи с
ERROR,ALERTилиWARNINGв таблицах и откройте разбор.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04. В Ubuntu 26.04 стоит PHP 8.5: в путях и командах вместо 8.3 пишите 8.5. Какая версия у вас, покажет ls /etc/php/.
Работает ли PHP-FPM сейчас, покажет sudo systemctl status php8.3-fpm: если служба работает, в ответе Active: active (running), если упала — failed.
Найдите свою ошибку
Таблицы разбиты по тому, что случилось. Найдите слова из записи в левой колонке и откройте разбор.
PHP-FPM не запускается
Эти записи видны в sudo journalctl -u php8.3-fpm -n 30 и в ответе sudo php-fpm8.3 -t.
| Слова в записи | Что случилось | Что делать |
|---|---|---|
FPM initialization failed | PHP-FPM не запустился, причина — строкой выше | Разбор |
failed to open configuration file | нет файла настроек | Разбор |
unknown entry '…' | опечатка в имени настройки | Разбор |
unable to parse value for entry | у настройки неверное значение | Разбор |
No pool defined | PHP-FPM не нашёл ни одного пула | Разбор |
Nothing matches the include pattern | в папке пулов нет файлов .conf | Разбор |
unable to bind listening socket | адрес из listen занят или его нет | Разбор |
Another FPM instance seems to already listen on | на сокете уже работает другой PHP-FPM | Разбор |
cannot get uid for user '…' | в пуле указан пользователь, которого нет | Разбор |
please specify user and group other than root | пул нельзя запускать от root | Разбор |
pm.max_children must be a positive value | ошибка в числах pm | Разбор |
cannot be greater than pm.max_children | запасных процессов больше предела | Разбор |
process_max can't be negative | в process.max число с минусом | Разбор |
failed to set rlimit_files | предел открытых файлов выше, чем разрешает система | Разбор |
Сайт работает медленно или с ошибками
Эти записи — в журнале PHP-FPM /var/log/php8.3-fpm.log.
| Слова в записи | Что случилось | Что делать |
|---|---|---|
server reached pm.max_children setting | все процессы пула заняты | Разбор |
seems busy | свободных процессов мало, PHP-FPM запускает новые | Разбор |
The maximum number of processes has been reached | процессы всех пулов упёрлись в process.max | Разбор |
fork() failed | PHP-FPM не смог создать процесс | Разбор |
execution timed out (… sec), terminating | PHP-FPM остановил долгий запрос | Разбор |
executing too slow (… sec), logging | запрос идёт дольше порога журнала медленных запросов | Разбор |
exited on signal 11 (SIGSEGV) | процесс PHP упал | Разбор |
exited on signal 9 (SIGKILL) | процесс завершила система, проверьте память | Разбор |
exited with code 70, child failed to initialize | процесс PHP не смог запуститься | Разбор |
failed processes threshold … is reached | много процессов упало за короткое время, PHP-FPM перезапускается | Разбор |
failed to setuid, failed to setgid | процесс не смог сменить пользователя | Разбор |
В журнале ошибок nginx
Эти записи PHP-FPM отправляет в nginx вместе с ответом. Они в /var/log/nginx/error.log после слов FastCGI sent in stderr.
| Слова в записи | Что случилось | Что делать |
|---|---|---|
Primary script unknown | PHP-FPM не нашёл файл, в браузере File not found. | Разбор |
Access to the script '…' has been denied | в PHP-FPM ушёл не файл .php, в браузере Access denied. | Разбор |
Unable to open primary script | нет прав на файл или файла нет | Разбор |
PHP message: PHP Fatal error | ошибка в PHP-коде сайта | Ошибки PHP |
Записи, которые не ошибка
| Слова в записи | Что значит |
|---|---|
fpm is running, pid … | PHP-FPM запустился |
ready to handle connections | PHP-FPM готов принимать запросы |
Terminating ..., exiting, bye-bye! | PHP-FPM остановили: например, systemctl stop или restart |
Reloading in progress ... | PHP-FPM перечитывает настройки |
exited with code 0 | процесс PHP завершился без ошибки, PHP-FPM запустил новый |
error log file re-opened | журнал начат заново после ротации |
Все такие записи с пояснениями — в разборе журнала.
Что видит браузер
| В браузере | Что случилось | Что делать |
|---|---|---|
502 Bad Gateway | PHP-FPM не запущен или nginx не может к нему подключиться | Разбор |
504 Gateway Timeout | PHP-FPM не ответил за 60 секунд | Разбор |
File not found. | PHP-FPM не нашёл файл по пути из nginx | Разбор |
Access denied. | PHP-FPM отказался выполнять файл | Разбор |
403 Forbidden и ниже nginx | запрет в nginx, PHP-FPM ни при чём | Разбор |
Как читать запись в журнале PHP-FPM
[13-Nov-2026 10:00:00] WARNING: [pool www] server reached pm.max_children setting (5), consider raising it| Часть | Что значит |
|---|---|
[13-Nov-2026 10:00:00] | дата и время по часам сервера |
WARNING | уровень: NOTICE — сведения, WARNING — предупреждение, ERROR — ошибка, ALERT — ошибка, из-за которой PHP-FPM не запустится |
[pool www] | пул — группа процессов PHP со своими настройками; в Ubuntu пул один, www |
| текст после пула | что случилось |
Если в конце записи пояснение и число в скобках, например : … (98), — это номер ошибки системы: что значит число в скобках.
Журнал PHP-FPM читает только root, поэтому команды с sudo. Где лежат старые записи и как собрать в журнал сообщения PHP — журнал PHP-FPM.
Коды выхода
Как проверить настройки
После любой правки файлов в /etc/php/8.3/fpm/ проверьте их:
sudo php-fpm8.3 -tЕсли всё верно, в ответе test is successful. Если нет — строка с ошибкой: найдите её в таблице. Затем перезапустите PHP-FPM: sudo systemctl restart php8.3-fpm.
Если сайт на виртуальном хостинге
На виртуальном хостинге PHP-FPM настраивает хостер, и журнала PHP-FPM у вас нет. Посмотрите, есть ли в панели хостинга журнал ошибок сайта и выбор версии PHP. Если в журнале есть запись с этой страницы, напишите в поддержку хостинга и приложите её.
Ошибки PHP-кода сайта разобраны отдельно — ошибки PHP.
Что почитать дальше
- Журнал PHP-FPMгде лежит и как читать записи.
- Настройки pm в PHP-FPMсколько процессов держать и как выбрать режим.
- 502 Bad Gatewayесли nginx не получил ответ от PHP-FPM.
- Ошибки PHPошибки в PHP-коде сайта.
- Блок для PHP в nginxкак nginx передаёт запросы в PHP-FPM.
- Ошибки Laravelесли PHP-FPM работает, а сайт на Laravel отвечает 500.