Поиск
Ошибки

Ошибки PHP-FPM: как по записи в журнале найти причину

PHP-FPM запускает PHP-код сайта: nginx передаёт ему запросы к файлам .php и отдаёт посетителю ответ. Когда с PHP-FPM что-то не так, сайт отвечает 502 или 504, а PHP-FPM пишет запись в свой журнал. Найдите слова из записи в таблицах ниже и откройте разбор.

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

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

  1. Посмотрите последние записи журнала PHP-FPM: sudo tail -n 30 /var/log/php8.3-fpm.log.
  2. Если PHP-FPM не запускается, посмотрите журнал службы: sudo journalctl -u php8.3-fpm -n 30.
  3. Найдите слова из записи с 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 failedPHP-FPM не запустился, причина — строкой вышеРазбор
failed to open configuration fileнет файла настроекРазбор
unknown entry '…'опечатка в имени настройкиРазбор
unable to parse value for entryу настройки неверное значениеРазбор
No pool definedPHP-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() failedPHP-FPM не смог создать процессРазбор
execution timed out (… sec), terminatingPHP-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 unknownPHP-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 connectionsPHP-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 GatewayPHP-FPM не запущен или nginx не может к нему подключитьсяРазбор
504 Gateway TimeoutPHP-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.

Коды выхода

КодГде видноЧто значит
78у службы: sudo systemctl status php8.3-fpmPHP-FPM не запустился из-за ошибки в настройках — разбор
70в журнале: child … exited with code 70процесс PHP не смог запуститься — разбор
0в журнале: child … exited with code 0процесс PHP завершился без ошибки

Как проверить настройки

После любой правки файлов в /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.

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

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