Поиск
Ошибки

Журнал PHP-FPM: где лежит и как читать записи

Журнал PHP-FPM в Ubuntu — файл /var/log/php8.3-fpm.log. В нём записи о работе самого PHP-FPM: запуск и остановка, новые процессы, нехватка процессов, долгие запросы. Ошибки в коде сайта туда по умолчанию не попадают — их записывает nginx в свой журнал ошибок. Если PHP-FPM не запускается, причину показывает journalctl.

≈ 11 мин чтения
Содержание 12

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

  1. Посмотрите последние записи: sudo tail -n 50 /var/log/php8.3-fpm.log.
  2. Оставьте только предупреждения и ошибки: sudo grep -E 'WARNING|ERROR|ALERT' /var/log/php8.3-fpm.log | tail -n 20.
  3. Если PHP-FPM не запускается, смотрите журнал службы: sudo journalctl -u php8.3-fpm -n 50.

Команды вводятся на сервере: подключитесь к нему по 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.logsudo tail -n 50 /var/log/php8.3-fpm.log
почему PHP-FPM не запустилсяжурнал службы в systemdsudo journalctl -u php8.3-fpm -n 50
ошибки в PHP-коде сайтажурнал ошибок nginxsudo grep 'PHP message' /var/log/nginx/error.log
на чём долго работает запросжурнал медленных запросов, если включёнexecuting too slow

Файл журнала PHP-FPM может читать только пользователь root, поэтому команды — с sudo. Путь к файлу задан в /etc/php/8.3/fpm/php-fpm.conf строкой error_log. Проверить:

grep '^error_log' /etc/php/8.3/fpm/php-fpm.conf

В ответе — error_log = /var/log/php8.3-fpm.log.

Почему ошибки запуска — в journalctl

PHP-FPM открывает файл журнала, когда уже прочитал настройки. Если в настройках ошибка, до файла дело не доходит: PHP-FPM выводит сообщение на экран, а при запуске службой этот вывод сохраняет systemd. Такие ошибки — например, unknown entry и FPM initialization failed — смотрите тремя командами:

  • sudo php-fpm8.3 -t — проверка настроек, ошибки сразу на экране;
  • sudo systemctl status php8.3-fpm — состояние службы и последние строки;
  • sudo journalctl -u php8.3-fpm -n 50 — все записи службы.

Ошибки в числах pm — must be a positive value и другие — PHP-FPM находит, когда файл уже открыт: они есть и в файле, и в journalctl. Начиная с записи fpm is running всё пишется только в файл.

Как читать запись

[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уровень записи
[pool www]пул — группа процессов PHP со своими настройками; www — пул, который Ubuntu создаёт при установке
остальноесамо сообщение

Записи без [pool …] — о PHP-FPM целиком, например о запуске. Если сообщение кончается двоеточием, текстом и числом в скобках — это пояснение системы и номер ошибки: что значит число.

Найти записи за нужный час — по дате и часу из начала строки:

sudo grep '13-Nov-2026 10:' /var/log/php8.3-fpm.log

Уровни записей

УровеньЧто значитЧто делать
NOTICEсообщение о работе: запуск, остановка, новые процессыничего, это не ошибка
WARNINGPHP-FPM работает, но что-то не так: не хватает процессов, запрос идёт слишком долго, процесс завершился аварийнонайдите запись в таблице
ERRORдействие не удалосьнайдите запись в таблице
ALERTошибка в настройках пула, с ней PHP-FPM не запускаетсяошибки настроек pm
DEBUGподробности для отладкивидны только при log_level = debug

Какие записи попадают в файл, задаёт настройка log_level в /etc/php/8.3/fpm/php-fpm.conf. По умолчанию notice: в файл идут NOTICE, WARNING, ERROR и ALERT. Если поставить warning, записей NOTICE не будет.

Записи, которые не ошибка

ЗаписьЧто значит
NOTICE: fpm is running, pid 1234PHP-FPM запущен; 1234 — номер главного процесса
NOTICE: ready to handle connectionsPHP-FPM готов принимать запросы
NOTICE: systemd monitor interval set to …msчерез сколько миллисекунд PHP-FPM сообщает systemd о своей работе
NOTICE: Terminating ...PHP-FPM получил команду остановиться: sudo systemctl stop php8.3-fpm или restart
NOTICE: Finishing ...плавная остановка: процессы доделывают начатые запросы
NOTICE: exiting, bye-bye!PHP-FPM остановлен
NOTICE: Reloading in progress ...перезагрузка настроек: sudo systemctl reload php8.3-fpm
NOTICE: reloading: execvp(…)PHP-FPM запускает себя заново с новыми настройками
NOTICE: error log file re-openedфайл журнала открыт заново после ротации
NOTICE: [pool www] child 12400 startedзапущен процесс PHP вместо завершившегося
NOTICE: [pool www] child 12345 exited with code 0 after … seconds from startпроцесс PHP завершился без ошибки

После sudo systemctl restart php8.3-fpm в журнале идут Terminating ... и exiting, bye-bye!, затем записи запуска: fpm is running и ready to handle connections. После reload — Reloading in progress ..., а следом те же записи запуска. Номера процессов и время здесь — пример.

Процессы, которые PHP-FPM запускает при старте и останавливает как лишние в режимах dynamic и ondemand, при уровне notice в журнал не попадают — режимы pm.

Записи об ошибках

Слова в записиЧто случилосьЧто делать
server reached pm.max_children settingвсе процессы PHP заняты, новые запросы ждутРазбор
seems busyPHP-FPM запускает много процессов разомРазбор
execution timed out (… sec), terminatingзапрос шёл дольше request_terminate_timeoutРазбор
executing too slowзапрос шёл дольше порога журнала медленных запросовРазбор
exited on signalпроцесс PHP завершился аварийноРазбор
exited with code 1 или другое число, кроме 0процесс PHP завершился с ошибкойРазбор
failed processes thresholdпроцессы падают один за другимРазбор
unable to bind listening socketадрес из listen занятРазбор
maximum number of processes has been reachedдостигнут общий предел процессов process.maxРазбор
said into stderrпроцесс PHP вывел сообщениекак читать

Если нужной записи нет в таблице — все ошибки PHP-FPM.

Где ошибки PHP-кода

Ошибки скриптов — PHP Fatal error, PHP Warning и другие — PHP-FPM по умолчанию отправляет в nginx вместе с ответом. nginx записывает их в свой журнал ошибок /var/log/nginx/error.log с пометкой FastCGI sent in stderr:

… [error] … FastCGI sent in stderr: "PHP message: PHP Warning:  Undefined variable $title in /var/www/example.com/index.php on line 3" while reading response header from upstream, …

Найти последние такие записи:

sudo grep 'PHP message' /var/log/nginx/error.log | tail -n 20

Как читать журнал nginx — журналы nginx. Что значат сами ошибки PHP — ошибки PHP.

Если в php.ini или в пуле (php_admin_value[error_log]) задан свой файл error_log, PHP пишет ошибки в этот файл, а не в nginx. Проверить: grep -n 'error_log' /etc/php/8.3/fpm/php.ini /etc/php/8.3/fpm/pool.d/*.conf — строки с ; в начале не действуют.

Как собрать сообщения PHP в журнал PHP-FPM

Чтобы всё, что процессы PHP выводят, попадало и в журнал PHP-FPM, включите в пуле catch_workers_output:

  1. Откройте файл пула: sudo nano /etc/php/8.3/fpm/pool.d/www.conf — вместо www.conf файл вашего пула.
  2. Найдите строку: Ctrl+W, наберите catch_workers_output, Enter.
  3. Уберите ; в начале строки, чтобы получилось catch_workers_output = yes.
  4. Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
  5. Проверьте: sudo php-fpm8.3 -t — в ответе должно быть test is successful.
  6. Перезапустите: sudo systemctl restart php8.3-fpm.

После этого в журнале PHP-FPM появятся записи:

[13-Nov-2026 10:05:00] WARNING: [pool www] child 12345 said into stderr: "… PHP message: PHP Warning:  Undefined variable $title …"

«Процесс 12345 пула www вывел сообщение». В кавычках — что вывел процесс. Уровень у таких записей — WARNING, что бы ни было внутри кавычек. Номер процесса помогает связать запись с соседними: например, с exited on signal у того же процесса.

В образце настроек PHP-FPM сказано: под большой нагрузкой эта настройка может добавить к ответу несколько миллисекунд. Включайте её, пока ищете ошибку, а потом верните ; в начало строки.

Старые записи: ротация журнала

Раз в неделю журнал переименовывается и начинается новый файл. Старые хранятся 12 недель:

ФайлЧто в нём
/var/log/php8.3-fpm.logтекущая неделя
/var/log/php8.3-fpm.log.1прошлая неделя
/var/log/php8.3-fpm.log.2.gz и дальшеболее старые, сжатые

Посмотреть список: ls -l /var/log/php8.3-fpm.log*. Искать сразу во всех, включая сжатые:

sudo zgrep 'max_children' /var/log/php8.3-fpm.log*

Пустой журнал не переименовывается. После ротации PHP-FPM получает сигнал USR1 и пишет в новый файл запись error log file re-opened.

Как записать больше подробностей

Если причина не видна, включите на время уровень debug: в журнал пойдут запуск и остановка каждого процесса.

  1. Откройте файл: sudo nano /etc/php/8.3/fpm/php-fpm.conf.
  2. Найдите строку: Ctrl+W, наберите log_level, Enter.
  3. Уберите ; в начале и запишите log_level = debug.
  4. Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X.
  5. Проверьте sudo php-fpm8.3 -t и перезапустите sudo systemctl restart php8.3-fpm.

При уровне debug время в записях — с миллионными долями секунды. Допустимые значения log_level: debug, notice, warning, error, alert. Найдёте причину — верните ; в начало строки, иначе журнал будет быстро расти.

Ошибки и как их исправить

Что видитеПричинаЧто делать
файла /var/log/php8.3-fpm.log нетна сервере другая версия PHPпосмотрите ls /var/log/*fpm* и ls /etc/php/
без sudo файл не читаетсяжурнал доступен только rootдобавьте sudo в начало команды
PHP-FPM не запускается, в файле нет новых записейошибка в настройках, файл ещё не открытсмотрите journalctl
в журнале только NOTICE о запуске, а сайт с ошибкамиошибки PHP-кода — в журнале nginxгде ошибки PHP-кода
ALERTошибка в настройках пулаошибки настроек pm
said into stderrвключён catch_workers_outputкак читать
записей за прошлые недели нет в файлежурнал прошёл ротациюищите в старых файлах

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

Источники

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

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

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