PHP-FPM: FPM initialization failed — PHP-FPM не запускается
FPM initialization failed — «PHP-FPM не запустился». Это итог: сама причина — в строке над этим сообщением. PHP-FPM не запустился, поэтому сайты на PHP отвечают 502 Bad Gateway. Найдите строку-причину, исправьте настройку и запустите PHP-FPM снова.
Содержание 13
- Что сделать прямо сейчас
- Как выглядит ошибка
- Где увидеть причину
- Как проверить настройки
- Что написано строкой выше
- Если пишет failed to open configuration file
- Если пишет failed to post process the configuration
- Если пишет the global prefix does not exist
- Код выхода 78
- Как запустить PHP-FPM после исправления
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Посмотрите строки перед
FPM initialization failed:sudo journalctl -u php8.3-fpm -n 30. - Проверьте настройки:
sudo php-fpm8.3 -t— команда покажет ту же причину. - Найдите строку-причину в таблице и откройте разбор.
Команды вводятся на сервере: подключитесь к нему по SSH (как подключиться). Команды — для PHP 8.3 из Ubuntu 24.04. В Ubuntu 26.04 стоит PHP 8.5: в путях и командах вместо 8.3 пишите 8.5. Какая версия у вас, покажет ls /etc/php/.
Как выглядит ошибка
[13-Nov-2026 10:00:00] ERROR: [/etc/php/8.3/fpm/pool.d/site1.conf:7] unknown entry 'pm.max_childen'
[13-Nov-2026 10:00:00] ERROR: Unable to include /etc/php/8.3/fpm/pool.d/site1.conf from /etc/php/8.3/fpm/php-fpm.conf at line …
[13-Nov-2026 10:00:00] ERROR: failed to load configuration file '/etc/php/8.3/fpm/php-fpm.conf'
[13-Nov-2026 10:00:00] ERROR: FPM initialization failedСтроки идут от причины к итогу. Здесь первая — причина: в файле пула site1.conf, в строке 7, опечатка в имени настройки. Остальные — следствия: «не удалось подключить site1.conf», «не удалось загрузить настройки», «PHP-FPM не запустился». Имя файла и номер строки — пример.
Решайте с первой строки с ERROR или ALERT. Исправите её — следствия пропадут сами.
Где увидеть причину
Ошибки запуска PHP-FPM видны в трёх местах:
| Где | Команда |
|---|---|
| состояние службы и последние строки | sudo systemctl status php8.3-fpm |
| журнал службы | sudo journalctl -u php8.3-fpm -n 30 |
| проверка настроек | sudo php-fpm8.3 -t |
Пока PHP-FPM запускается, он пишет сообщения на экран, а служба сохраняет их в свой журнал. Если ошибка случилась до того, как PHP-FPM открыл свой файл журнала /var/log/php8.3-fpm.log, в этом файле её не будет — смотрите journalctl. Как устроены команды — systemctl и journalctl.
Как проверить настройки
sudo php-fpm8.3 -tКоманда читает все файлы настроек и проверяет их, но PHP-FPM не запускает и сайты не трогает. Если всё верно, ответ — NOTICE: configuration file /etc/php/8.3/fpm/php-fpm.conf test is successful. Если нет — строки с ошибками, как при запуске.
Проверка находит ошибки записи, неверные значения, ошибки в настройках pm, неизвестных пользователей и группы. Не находит — занятый порт или сокет: адрес она не занимает. Если -t отвечает test is successful, а PHP-FPM не запускается, смотрите unable to bind listening socket.
С ключом -tt PHP-FPM дополнительно выводит значения всех настроек — каждую строкой NOTICE:. Так видно, какое значение он на самом деле прочитал.
Что написано строкой выше
| Строка выше | Что случилось | Что делать |
|---|---|---|
unable to bind listening socket for address | адрес из listen занят | Разбор |
Another FPM instance seems to already listen on | сокет занят другим PHP-FPM | Разбор |
already used in another pool | у двух пулов один адрес | Разбор |
No pool defined. | не найден ни один пул | Разбор |
Unable to include | ошибка в файле пула или в строке include | Разбор |
unknown entry | опечатка или настройка не в своём разделе | Разбор |
unable to parse value for entry | неверное значение настройки | Разбор |
cannot get uid for user | нет такого пользователя | Разбор |
cannot get gid for group | нет такой группы | Разбор |
please specify user and group other than root | пул настроен на root | Разбор |
pm.max_children, pm.min_spare_servers, pm.start_servers | ошибка в числах процессов | Разбор |
slowlog | ошибка в настройках журнала медленных запросов | Разбор |
failed to set rlimit_files | лимит открытых файлов выше системного | Разбор |
Если пишет failed to open configuration file
ERROR: failed to open configuration file '/etc/php/8.3/fpm/php-fpm.conf': … (2)«Не удалось открыть файл настроек». Число 2 в скобках — файла нет. Проверьте, есть ли он:
ls -l /etc/php/8.3/fpm/Если вы запускали PHP-FPM вручную с ключом -y и путём к файлу, проверьте путь. Если файл удалили, верните его из копии.
Если пишет failed to post process the configuration
ERROR: failed to post process the configuration«Не удалось обработать настройки». Файлы прочитаны, но значения не подходят друг к другу: например, ошибка в числах процессов pm или у двух пулов один адрес. Причина — строкой выше: найдите её в таблице.
Если пишет the global prefix does not exist
ERROR: the global prefix '…' does not exist or is not a directory«Папки из настройки prefix нет или это не папка». Настройка prefix задаёт папку, от которой считаются пути без / в начале. Создайте эту папку или поправьте prefix в /etc/php/8.3/fpm/php-fpm.conf. Такая же проверка есть у пула: [pool www] the prefix '…' does not exist or is not a directory — тогда правьте prefix в файле пула.
Код выхода 78
Если PHP-FPM не запустился, он завершается с кодом 78. Число 78 видно в ответе sudo systemctl status php8.3-fpm. 78 значит «ошибка в настройках»: причина — в журнале, строкой выше.
После sudo php-fpm8.3 -t код покажет echo $?: 0 — настройки в порядке, 78 — есть ошибка.
Как запустить PHP-FPM после исправления
- Проверьте настройки:
sudo php-fpm8.3 -t— в ответе должно бытьtest is successful. - Запустите службу:
sudo systemctl restart php8.3-fpm. - Проверьте:
sudo systemctl status php8.3-fpm— в строкеActive:должно бытьactive (running). - Откройте сайт. Если он отвечает 502, смотрите 502 Bad Gateway.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
FPM initialization failed | PHP-FPM не запустился | смотрите строку выше |
failed to open configuration file '…': … (2) | нет файла настроек | проверьте путь |
failed to load configuration file | ошибка в одном из файлов настроек | смотрите строку выше |
failed to post process the configuration | значения не подходят друг к другу | смотрите строку выше |
the global prefix '…' does not exist or is not a directory | нет папки из prefix | создайте папку |
в systemctl status код 78 | ошибка в настройках | найдите причину в журнале |
-t пишет test is successful, а PHP-FPM не запускается | адрес занят | Разбор |
Тексты сообщений и коды сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: запуск и коды выхода в fpm.c и fpm_main.c, чтение настроек в fpm_conf.c, журнал в zlog.c.
- Настройка PHP-FPM в документации PHP — на английском: все настройки.
- Пакет php8.3-fpm в Ubuntu 24.04 — версия PHP-FPM и файлы пакета.
Сверено 13 ноября 2026 года.
Что почитать дальше
- 502 Bad Gatewayчто видит посетитель, пока PHP-FPM не работает.
- Журнал PHP-FPMгде журнал и как читать его строки.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.