Поиск
Ошибки

PHP-FPM: unknown entry и unable to parse value — ошибка в строке файла настроек

PHP-FPM читает файлы настроек по строкам. Если имя слева от знака = ему незнакомо, он пишет unknown entry. Если имя верное, но значение записано не так, — unable to parse value. В квадратных скобках в начале сообщения — файл и номер строки с ошибкой. Пока её не исправить, PHP-FPM не запустится.

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

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

  1. Проверьте настройки: sudo php-fpm8.3 -t — в ответе будет строка с ошибкой.
  2. Посмотрите в квадратных скобках файл и номер строки, например [/etc/php/8.3/fpm/pool.d/site1.conf:7].
  3. Откройте файл сразу на этой строке: 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 failedPHP-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_bufferingyes или 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.confdebug, 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 или 30s30 секунд
5m5 минут
1h1 час
1d1 день

Буква — одна, маленькая, сразу после числа. 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 valueenv[…] без значения: 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 sectionphp_value[…] в php-fpm.confперенесите в пул
must be a positive valueноль или отрицательное число в pm.…Разбор

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

Источники

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

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

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