PHP-FPM: No pool defined — PHP-FPM не нашёл ни одного пула
Пул — это группа процессов PHP-FPM со своими настройками: адресом, пользователем, числом процессов. Пулы описаны в отдельных файлах, и PHP-FPM подключает их строкой include. Если он не нашёл ни одного пула, запускать нечего, и он пишет No pool defined. Верните файл пула или поправьте строку include.
Содержание 11
- Что сделать прямо сейчас
- Как выглядит ошибка
- Где PHP-FPM ищет пулы
- Если файл пула переименовали или удалили
- Если строку include закомментировали
- Если пишет Unable to include
- Если пишет Nothing matches the include pattern
- Если пишет failed to include more than 5 files recursively
- Ошибки и как их исправить
- Источники
- Что почитать дальше
Что сделать прямо сейчас
- Посмотрите, какие файлы пулов есть:
ls /etc/php/8.3/fpm/pool.d/. - Если там нет ни одного файла с окончанием
.conf, верните файл пула — как это сделать. - Проверьте настройки:
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.
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 failed | PHP-FPM не запустился | Разбор |
Тексты сообщений сверены по исходному коду PHP 8.3.6 — эта версия стоит в Ubuntu 24.04.
Источники
- Исходный код PHP-FPM в PHP 8.3.6 — на английском: подключение файлов и проверка пулов в fpm_conf.c.
- Образец настроек пула www.conf — на английском: все настройки пула с пояснениями.
- Пакет php8.3-fpm в Ubuntu 24.04 — файлы пакета, в том числе pool.d/www.conf.
- Сборка пакета PHP в Debian — на английском: как пакет готовит php-fpm.conf и www.conf.
Сверено 13 ноября 2026 года.
Что почитать дальше
- Настройки PHP для одного сайтакак сделать отдельный пул для сайта.
- Режимы pm в PHP-FPMчто значат числа процессов.
- Ошибки PHP-FPMвсе ошибки PHP-FPM на одной странице.