Журнал PHP-FPM: где лежит и как читать записи
Журнал PHP-FPM в Ubuntu — файл /var/log/php8.3-fpm.log. В нём записи о работе самого PHP-FPM: запуск и остановка, новые процессы, нехватка процессов, долгие запросы. Ошибки в коде сайта туда по умолчанию не попадают — их записывает nginx в свой журнал ошибок. Если PHP-FPM не запускается, причину показывает journalctl.
Содержание 12
Что сделать прямо сейчас
- Посмотрите последние записи:
sudo tail -n 50 /var/log/php8.3-fpm.log. - Оставьте только предупреждения и ошибки:
sudo grep -E 'WARNING|ERROR|ALERT' /var/log/php8.3-fpm.log | tail -n 20. - Если 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.log | sudo tail -n 50 /var/log/php8.3-fpm.log |
| почему PHP-FPM не запустился | журнал службы в systemd | sudo journalctl -u php8.3-fpm -n 50 |
| ошибки в PHP-коде сайта | журнал ошибок nginx | sudo 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 | сообщение о работе: запуск, остановка, новые процессы | ничего, это не ошибка |
WARNING | PHP-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 1234 | PHP-FPM запущен; 1234 — номер главного процесса |
NOTICE: ready to handle connections | PHP-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 busy | PHP-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:
- Откройте файл пула:
sudo nano /etc/php/8.3/fpm/pool.d/www.conf— вместоwww.confфайл вашего пула. - Найдите строку: Ctrl+W, наберите
catch_workers_output, Enter. - Уберите
;в начале строки, чтобы получилосьcatch_workers_output = yes. - Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano).
- Проверьте:
sudo php-fpm8.3 -t— в ответе должно бытьtest is successful. - Перезапустите:
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 у того же процесса.
; в начало строки.Старые записи: ротация журнала
Раз в неделю журнал переименовывается и начинается новый файл. Старые хранятся 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: в журнал пойдут запуск и остановка каждого процесса.
- Откройте файл:
sudo nano /etc/php/8.3/fpm/php-fpm.conf. - Найдите строку: Ctrl+W, наберите
log_level, Enter. - Уберите
;в начале и запишитеlog_level = debug. - Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X.
- Проверьте
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.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: формат записей в zlog.c, записи запуска и сигналов в fpm.c, fpm_events.c и fpm_process_ctl.c, вывод процессов в fpm_stdio.c.
- Образец php-fpm.conf — на английском: error_log и log_level.
- Образец настроек пула www.conf — на английском: catch_workers_output и decorate_workers_output.
- Настройка PHP-FPM в документации PHP — на английском: все настройки.
- Пакет PHP в Debian — на английском: путь к журналу и правила ротации.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Журналы nginxгде nginx пишет ошибки PHP-кода.
- Ошибки PHPчто значат Fatal error, Warning и другие.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.