Поиск
Ошибки

PHP-FPM: No pool defined — PHP-FPM не нашёл ни одного пула

Пул — это группа процессов PHP-FPM со своими настройками: адресом, пользователем, числом процессов. Пулы описаны в отдельных файлах, и PHP-FPM подключает их строкой include. Если он не нашёл ни одного пула, запускать нечего, и он пишет No pool defined. Верните файл пула или поправьте строку include.

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

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

  1. Посмотрите, какие файлы пулов есть: ls /etc/php/8.3/fpm/pool.d/.
  2. Если там нет ни одного файла с окончанием .conf, верните файл пула — как это сделать.
  3. Проверьте настройки: sudo php-fpm8.3 -t — в ответе должно быть test is successful. Затем 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] WARNING: Nothing matches the include pattern '/etc/php/8.3/fpm/pool.d/*.conf' from /etc/php/8.3/fpm/php-fpm.conf at line ….
[13-Nov-2026 10:00:00] ERROR: No pool defined. at least one pool section must be specified in config file
[13-Nov-2026 10:00:00] ERROR: failed to post process the configuration
[13-Nov-2026 10:00:00] ERROR: FPM initialization failed

Первая строка — «ни один файл не подходит под шаблон из строки include». Вторая — «не задан ни один пул: в настройках должен быть хотя бы один раздел пула». Дальше — следствия: PHP-FPM не запустился (FPM initialization failed), сайты отвечают 502.

Эти строки видны в sudo systemctl status php8.3-fpm, sudo journalctl -u php8.3-fpm -n 30 и sudo php-fpm8.3 -t.

Где PHP-FPM ищет пулы

Главный файл настроек — /etc/php/8.3/fpm/php-fpm.conf. В его конце строка:

include=/etc/php/8.3/fpm/pool.d/*.conf

Она значит: «подключи все файлы из папки pool.d, имя которых кончается на .conf». В Ubuntu в этой папке лежит файл пула www.conf. Пул начинается строкой с именем в квадратных скобках — [www], — и все настройки ниже, до следующих квадратных скобок, относятся к нему.

Проверьте строку include:

grep -n '^include' /etc/php/8.3/fpm/php-fpm.conf

В ответе — номер строки и сама строка. Если ответ пустой, строку закомментировали — поставили ; в начале — или удалили.

Если файл пула переименовали или удалили

Под шаблон *.conf подходят только файлы с окончанием .conf. Если файл переименовали, например в www.conf.old или www.conf.bak, PHP-FPM его не видит.

ls -l /etc/php/8.3/fpm/pool.d/
  • Если файл есть под другим именем — верните окончание .conf: sudo mv /etc/php/8.3/fpm/pool.d/www.conf.bak /etc/php/8.3/fpm/pool.d/www.conf.
  • Если файла нет, создайте его заново: sudo nano /etc/php/8.3/fpm/pool.d/www.conf — и вставьте настройки ниже.

Файл пула www.conf с настройками Ubuntu 24.04 по умолчанию:

[www]
user = www-data
group = www-data
listen = /run/php/php8.3-fpm.sock
listen.owner = www-data
listen.group = www-data
pm = dynamic
pm.max_children = 5
pm.start_servers = 2
pm.min_spare_servers = 1
pm.max_spare_servers = 3

Сохраните и выйдите: Ctrl+O, Enter, Ctrl+X (редактор nano). Что значат числа pm — режимы pm в PHP-FPM.

Если раньше в пуле были свои настройки — другой сокет, пользователь, лимиты, — впишите их снова. Иначе сайт может не найти PHP-FPM: проверьте fastcgi_pass в настройках сайта в nginx.

Если строку include закомментировали

Откройте главный файл: sudo nano /etc/php/8.3/fpm/php-fpm.conf. Найдите строку с include: Ctrl+W, наберите include=, Enter. Если в начале строки ; — уберите его. Если строки нет — допишите в конец файла:

include=/etc/php/8.3/fpm/pool.d/*.conf

Можно описать пул и прямо в php-fpm.conf — раздел с именем в квадратных скобках в конце файла. Но держать пулы в pool.d удобнее: каждый сайт в своём файле.

Если пишет Unable to include

ERROR: [/etc/php/8.3/fpm/pool.d/site1.conf:7] unknown entry 'pm.max_childen'
ERROR: Unable to include /etc/php/8.3/fpm/pool.d/site1.conf from /etc/php/8.3/fpm/php-fpm.conf at line …

«Не удалось подключить файл site1.conf из php-fpm.conf». Файл найден, но в нём ошибка. Сама ошибка — строкой выше: в квадратных скобках — файл и номер строки. Имя файла, номер строки и опечатка здесь — пример. Что значат такие строки — unknown entry и неверные значения.

Если строкой выше failed to open configuration file '…': … (13), у PHP-FPM нет прав прочитать этот файл. Посмотрите владельца и права: ls -l /etc/php/8.3/fpm/pool.d/.

Если пишет Nothing matches the include pattern

WARNING: Nothing matches the include pattern '/etc/php/8.3/fpm/pool.d/*.conf' from /etc/php/8.3/fpm/php-fpm.conf at line ….

«Ни один файл не подходит под шаблон». Это предупреждение: PHP-FPM продолжает читать настройки. Если пул описан где-то ещё, PHP-FPM запустится. Если нет — следом будет No pool defined.

Проверьте, что путь в строке include ведёт в существующую папку и в ней есть файлы .conf. Если в строке include путь к одному файлу, без звёздочки, а файла нет, сообщение то же.

Похожая ошибка — Unable to globalize '…' (ret=…) from … at line ….: PHP-FPM не смог прочитать папку из шаблона, например из-за прав. Проверьте права на папку: ls -ld /etc/php/8.3/fpm/pool.d.

Если пишет failed to include more than 5 files recursively

ERROR: failed to include more than 5 files recursively

«Не удалось подключить больше 5 файлов по цепочке». Файл подключает файл, тот — следующий, и так больше 5 раз. Так бывает, если шаблон include захватывает сам главный файл: например, в php-fpm.conf написано include=/etc/php/8.3/fpm/*.conf — под шаблон попадает и php-fpm.conf. Он подключает себя снова и снова.

Верните путь к папке пулов: include=/etc/php/8.3/fpm/pool.d/*.conf. Если строки include есть и в файлах пулов, проверьте, куда ведут они.

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

Что видитеПричинаЧто делать
No pool defined. at least one pool section must be specified in config fileне найден ни один пулпроверьте файлы пулов
Nothing matches the include patternпод шаблон include не подходит ни один файлпроверьте папку и окончание .conf
Unable to include … from … at line …ошибка в подключаемом файле или его нетсмотрите строку выше
Unable to globalize '…'PHP-FPM не прочитал папку из шаблонапроверьте права на папку
failed to include more than 5 files recursivelyфайл подключает сам себяпоправьте шаблон include
FPM initialization failedPHP-FPM не запустилсяРазбор

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

Источники

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

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

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