PHP-FPM: unknown entry и unable to parse value — ошибка в строке файла настроек
PHP-FPM читает файлы настроек по строкам. Если имя слева от знака = ему незнакомо, он пишет unknown entry. Если имя верное, но значение записано не так, — unable to parse value. В квадратных скобках в начале сообщения — файл и номер строки с ошибкой. Пока её не исправить, PHP-FPM не запустится.
Содержание 10
Что сделать прямо сейчас
- Проверьте настройки:
sudo php-fpm8.3 -t— в ответе будет строка с ошибкой. - Посмотрите в квадратных скобках файл и номер строки, например
[/etc/php/8.3/fpm/pool.d/site1.conf:7]. - Откройте файл сразу на этой строке:
sudo nano +7 /etc/php/8.3/fpm/pool.d/site1.conf— вместо 7 и пути возьмите свои. Исправьте строку по таблицам ниже, сноваsudo php-fpm8.3 -tиsudo systemctl restart php8.3-fpm.
Команды вводятся на сервере: подключитесь к нему по 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| Часть | Что значит |
|---|---|
[/etc/php/8.3/fpm/pool.d/site1.conf:7] | файл и номер строки с ошибкой |
unknown entry 'pm.max_childen' | «неизвестная запись pm.max_childen» — PHP-FPM не знает такого имени |
Unable to include … | файл пула не загружен из-за ошибки в нём; номер строки здесь — строка include= в php-fpm.conf |
failed to load configuration file | настройки не загружены |
FPM initialization failed | PHP-FPM не запустился |
Первая строка — главная, остальные — её последствия. Пути и номера здесь — пример.
Эти строки видны в ответе sudo php-fpm8.3 -t, в sudo systemctl status php8.3-fpm и в sudo journalctl -u php8.3-fpm -n 30. Служба при этом не работает: в строке Active — failed. Что ещё бывает перед FPM initialization failed — разбор.
sudo php-fpm8.3 -t перед каждым перезапуском. Она находит эти ошибки, пока PHP-FPM ещё работает со старыми настройками и сайт открывается.Если пишет unknown entry
«Неизвестная запись». PHP-FPM не знает имени слева от =. Большие и маленькие буквы в имени он не различает: PM.MAX_CHILDREN и pm.max_children для него одно и то же. Что бывает в такой строке:
| Что в строке | Почему не подходит | Как исправить |
|---|---|---|
опечатка: pm.max_childen, request_terminate_timout | такого имени нет | сверьте имя |
настройка PHP: memory_limit = 256M, upload_max_filesize = 64M | это настройки php.ini, PHP-FPM их так не принимает | php_admin_value[memory_limit] = 256M — настройки PHP в пуле |
в файле пула: error_log, log_level, process.max, emergency_restart_threshold | эти настройки задают только в php-fpm.conf | перенесите в php-fpm.conf |
в php-fpm.conf в разделе [global]: pm.max_children, user, listen | эти настройки действуют только в пуле | перенесите в файл пула |
Как проверить имя настройки
Все имена настроек пула есть в файле /etc/php/8.3/fpm/pool.d/www.conf — с пояснениями, в строках с ; в начале. Найдите похожее имя:
grep -n 'max_children' /etc/php/8.3/fpm/pool.d/www.confВместо max_children — часть имени из сообщения. Общие настройки так же ищите в /etc/php/8.3/fpm/php-fpm.conf. Список всех настроек с пояснениями — в документации PHP, на английском.
Какие настройки где задают
| Где | Настройки |
|---|---|
только /etc/php/8.3/fpm/php-fpm.conf, раздел [global] | pid, error_log, log_level, log_limit, log_buffering, syslog.ident, syslog.facility, emergency_restart_threshold, emergency_restart_interval, process_control_timeout, process.max, daemonize, events.mechanism, systemd_interval |
| и там, и в пуле | process.priority, rlimit_files, rlimit_core |
только в пуле, после строки с именем пула, например [www] | все остальные: user, group, listen, все pm.…, request_terminate_timeout, slowlog, catch_workers_output, clear_env, security.limit_extensions и другие |
Файлы пулов лежат в /etc/php/8.3/fpm/pool.d/. Их подключает последняя строка php-fpm.conf: include=/etc/php/8.3/fpm/pool.d/*.conf.
Если в пуле нужна настройка PHP
Настройки PHP — лимит памяти, размер загружаемых файлов, показ ошибок — задают в пуле через php_value или php_admin_value. Имя настройки пишут в квадратных скобках:
php_admin_value[memory_limit] = 256M
php_admin_value[upload_max_filesize] = 64M
php_admin_flag[log_errors] = on| Запись | Для чего |
|---|---|
php_admin_value[…] | настройка, которую код сайта не сможет поменять через ini_set() |
php_value[…] | настройка, которую код сайта может поменять |
php_admin_flag[…], php_flag[…] | то же для настроек «да или нет»: значение on или off |
Так настройки действуют только на сайты этого пула. Подробнее — настройки PHP для одного сайта.
Если пишет unable to parse value for entry
ERROR: [/etc/php/8.3/fpm/pool.d/site1.conf:12] unable to parse value for entry 'clear_env': invalid boolean value«Не удалось разобрать значение настройки clear_env». Имя верное, но значение записано не так. После двоеточия — что именно не так:
| Конец сообщения | Какие настройки | Как записать |
|---|---|---|
invalid boolean value | «да или нет»: catch_workers_output, clear_env, decorate_workers_output, process.dumpable; в php-fpm.conf — daemonize, log_buffering | yes или no; подойдут и on и off. Ноль не подходит: clear_env = 0 даёт эту ошибку |
is not a valid number (greater or equal than zero) | числа: все pm.max_…, pm.start_servers, pm.min_spare_servers, listen.backlog, rlimit_files, request_slowlog_trace_depth; в php-fpm.conf — process.max, log_limit | только цифры: 50, а не 50k. Для rlimit_files слово unlimited тоже не подходит |
unknown suffix used in time value | время: request_terminate_timeout, request_slowlog_timeout, pm.process_idle_timeout; в php-fpm.conf — emergency_restart_interval, process_control_timeout | как записать время |
invalid time value | время | после = пусто — допишите время |
invalid process manager (static, dynamic or ondemand) | pm | одно из трёх: static, dynamic или ondemand — режимы pm |
must be greater than zero or 'unlimited' | rlimit_core | число больше нуля или unlimited |
invalid value for 'log_level' | log_level в php-fpm.conf | debug, notice, warning, error или alert |
Can't use '$pool' when the pool is not defined | строка с $pool в php-fpm.conf, в разделе [global] | $pool заменяется именем пула и работает только в файле пула |
Отрицательное число PHP-FPM здесь пропустит, но потом остановится на проверке: must be a positive value.
Как записать время
| Запись | Что значит |
|---|---|
30 или 30s | 30 секунд |
5m | 5 минут |
1h | 1 час |
1d | 1 день |
Буква — одна, маленькая, сразу после числа. 30sec, 5min и 30S PHP-FPM не примет. Дробную часть он отбрасывает: 1.5m — это одна минута, пишите 90s.
Если пишет value is NULL for a ZEND_INI_PARSER_ENTRY
ERROR: [/etc/php/8.3/fpm/pool.d/site1.conf:7] value is NULL for a ZEND_INI_PARSER_ENTRY«У записи нет значения». В строке нет знака =, например pm.max_children 50. Запишите pm.max_children = 50.
Если пишет unknown directive
Ошибки в строках с квадратными скобками — php_admin_value[…], php_flag[…], env[…]:
| Что видите | Что значит | Как исправить |
|---|---|---|
unknown directive 'php_values' | неизвестное имя перед скобками; здесь большие и маленькие буквы различаются | одно из имён: php_value, php_admin_value, php_flag, php_admin_flag, env, строчными буквами |
You must provide a key for field 'php_value' | в скобках пусто: php_value[] = 256M | впишите имя настройки: php_value[memory_limit] = 256M |
Array are not allowed in the global section | строка со скобками в php-fpm.conf, в разделе [global] | перенесите её в файл пула |
empty value | env[…] без значения: env[PATH] = | допишите значение или удалите строку |
error while parsing 'php_flag[display_errors]' : invalid boolean value | в php_flag или php_admin_flag не on и не off, например 0 | запишите php_flag[display_errors] = off |
В начале каждого из этих сообщений — файл и номер строки, как в примере выше.
Ошибки и как их исправить
| Что видите | Причина | Что делать |
|---|---|---|
unknown entry '…' | опечатка или настройка не на своём месте | сверьте имя |
unknown entry 'memory_limit' | настройка php.ini в пуле | php_admin_value |
unknown entry 'error_log' в файле пула | общая настройка в пуле | перенесите в php-fpm.conf |
unable to parse value for entry '…': invalid boolean value | вместо yes или no другое значение | запишите yes или no |
… is not a valid number (greater or equal than zero) | в числе буквы | только цифры |
… unknown suffix used in time value | неверная буква после числа | как записать время |
value is NULL for a ZEND_INI_PARSER_ENTRY | нет знака = | допишите = |
unknown directive '…' | неверное имя перед скобками | проверьте имя |
Array are not allowed in the global section | php_value[…] в php-fpm.conf | перенесите в пул |
must be a positive value | ноль или отрицательное число в pm.… | Разбор |
Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: разбор строк настроек и проверка значений в fpm_conf.c.
- Образец настроек пула www.conf — на английском: все настройки пула, php_value и php_admin_value.
- Настройка PHP-FPM в документации PHP — на английском: общие настройки и настройки пула.
Сверено 13 ноября 2026 года.
Что почитать дальше
- FPM initialization failedвсе причины, по которым PHP-FPM не запускается.
- Режимы pm в PHP-FPMчто значат числа pm и как их выбрать.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.