Настройка пула PHP-FPM: конфиг www.conf и его параметры
Пул PHP-FPM задаёт, от какого пользователя работает PHP, где слушает сокет и сколько процессов держит под нагрузкой. Готовый блок для /etc/php/8.3/fpm/pool.d/www.conf меняют под память сервера и проверяют через sudo php-fpm8.3 -t.
Конфиг
[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 = 20
pm.start_servers = 4
pm.min_spare_servers = 2
pm.max_spare_servers = 6
pm.max_requests = 500
request_terminate_timeout = 60s
Что заменить под свой сервер
8.3- установленная версия PHP
pm.max_children = 20- память под PHP, делённая на средний размер процесса (обычно 40-80 МБ)
pm.start_servers = 4- должно быть между min_spare_servers и max_spare_servers
Как применить и проверить
sudo php-fpm8.3 -t
sudo systemctl reload php8.3-fpm
Пользователь, группа и сокет пула
Строки user и group задают пользователя, от которого работают процессы пула. На Ubuntu 24.04 пакет php8.3-fpm создаёт пользователя www-data, и nginx тоже работает от него, поэтому файлы сайта должны быть ему доступны. Директива listen указывает unix-сокет, через который nginx передаёт запросы в PHP. listen.owner и listen.group выставляют владельца сокета, чтобы nginx мог к нему подключиться. Если сменить пользователя пула, проверьте права на /var/www/example.com и на сокет, иначе получите 502.
pm и pm.max_children: сколько процессов держать
pm = dynamic включает режим, в котором FPM держит от pm.min_spare_servers до pm.max_spare_servers свободных процессов и запускает новые до pm.max_children. pm.max_children считают как память, которую можно отдать PHP, делённую на средний размер процесса, обычно 40-80 МБ. Средний размер показывает ps -C php-fpm8.3 -o rss,cmd, RSS выводится в килобайтах. Значение 20 в конфиге подходит серверу, где под PHP выделено около 1 ГБ при процессе 50 МБ.
pm.start_servers, min_spare_servers и max_spare_servers
pm.start_servers задаёт число процессов, запускаемых при старте службы. Оно должно быть между pm.min_spare_servers и pm.max_spare_servers, иначе php-fpm8.3 -t выдаст ошибку. pm.min_spare_servers держит минимум свободных процессов, pm.max_spare_servers ограничивает их сверху, чтобы лишние завершались. При pm.max_children = 20 рабочий набор: start_servers = 4, min_spare_servers = 2, max_spare_servers = 6.
pm.max_requests и request_terminate_timeout
pm.max_requests = 500 перезапускает процесс после 500 обработанных запросов, это сдерживает утечки памяти в расширениях. Значение 0 отключает перезапуск, и процесс живёт до перезагрузки службы. request_terminate_timeout = 60s обрывает запрос, который выполняется дольше 60 секунд. Держите его чуть меньше fastcgi_read_timeout в nginx: если PHP-FPM оборвёт запрос первым, nginx отдаст 502, если nginx сработает раньше, вы увидите 504.
Проверка и применение конфига
Перед перезагрузкой проверьте синтаксис: sudo php-fpm8.3 -t читает /etc/php/8.3/fpm/php-fpm.conf и все файлы из pool.d. Ошибка в директиве или в порядке start_servers остановит проверку с указанием файла и строки. Затем примените конфиг командой sudo systemctl reload php8.3-fpm: служба перечитает пулы без разрыва текущих соединений. Полный перезапуск systemctl restart php8.3-fpm нужен только при смене listen или пользователя.
Как понять, что процессов не хватает
Когда все процессы пула заняты, новые запросы ждут в очереди сокета, и nginx отвечает 504 после fastcgi_read_timeout. В логе /var/log/php8.3-fpm.log появляется строка WARNING: [pool www] server reached pm.max_children setting (5), consider raising it. Число 5 в скобках это текущее значение pm.max_children, у пакетного пула оно именно такое. Если в логе ваше значение, поднимите pm.max_children после замера RSS, а не вслепую.
Где ошибаются, когда правят конфиг
-
Ставят pm.start_servers больше pm.max_spare_servers или меньше pm.min_spare_servers. php-fpm8.3 -t завершается с ошибкой, и reload не проходит.
Держите start_servers между min_spare_servers и max_spare_servers, например 4 при 2 и 6.
-
Поднимают pm.max_children до сотни, не глядя на память. Сервер уходит в swap, и время ответа растёт у всех сайтов.
Считайте max_children как доступную PHP память, делённую на средний RSS из ps -C php-fpm8.3 -o rss,cmd.
-
Ставят request_terminate_timeout больше fastcgi_read_timeout в nginx. Долгий скрипт получает 504, хотя PHP продолжает работу.
Делайте request_terminate_timeout чуть меньше fastcgi_read_timeout, тогда PHP-FPM завершит запрос сам.
-
Меняют пул и делают systemctl restart php8.3-fpm на рабочем сайте. Текущие запросы обрываются.
После php-fpm8.3 -t применяйте sudo systemctl reload php8.3-fpm, перезапуск оставьте для смены listen или пользователя.
Deploykin
Как это делается в Deploykin
В Deploykin версия PHP выбирается для каждого сайта отдельно, а авто-тюнинг подбирает настройки PHP-FPM, MySQL и Nginx под ресурсы сервера. Рекомендации применяются в один клик.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Как посчитать pm.max_children для своего сервера?
Возьмите память, которую готовы отдать PHP, и разделите на средний размер процесса. Размер покажет ps -C php-fpm8.3 -o rss,cmd, RSS в килобайтах, обычно 40-80 МБ на процесс.
Почему nginx отдаёт 504, а не 502?
504 значит, что все процессы пула заняты и запрос ждёт в очереди сокета дольше fastcgi_read_timeout. 502 бывает, когда FPM не запущен, сокета нет или у nginx нет прав на сокет.
Где лежит конфиг пула и лог PHP-FPM?
Пулы лежат в /etc/php/8.3/fpm/pool.d/, основной файл пула www это www.conf. Лог пишется в /var/log/php8.3-fpm.log.
Что означает WARNING: server reached pm.max_children setting?
Это запись в логе FPM о том, что все процессы пула заняты и новые ждут. Поднимите pm.max_children после замера RSS процессов.
Нужен ли reload после правки www.conf?
Да, изменения читаются при reload или restart службы. Сначала выполните sudo php-fpm8.3 -t, затем sudo systemctl reload php8.3-fpm.
Ещё по теме
- Руководство · PHP Где находится php.ini и как настроить PHP-FPM на Ubuntu 24.04 Пошаговая настройка php.ini для PHP 8.3 и PHP-FPM на Ubuntu 24.04: где лежит файл, команды проверки, правка лимитов и перезагрузка службы.
- Руководство · PHP PHP 8.3 на Ubuntu 24.04: установка и настройка PHP-FPM Пошаговая установка и настройка PHP 8.3 с PHP-FPM на Ubuntu 24.04: команды, правка пула www, проверка версии и работы сайта.
- Руководство · PHP Настройка nginx и PHP-FPM на Ubuntu 24.04 Настройте nginx и PHP-FPM на Ubuntu 24.04: проверка PHP 8.3, конфиг сайта с fastcgi_pass, пул www, перезагрузка и проверка через curl.
- Руководство · PHP PHP2Shell: две критические уязвимости в PHP и как их закрыть Две критические уязвимости PHP от 21 октября 2026 года позволяют выполнить код на сервере без авторизации. Какие версии уязвимы, как проверить сервер и обновиться.
- Руководство · PHP Как обновить PHP на Ubuntu до патч-релиза Как обновить PHP 8.2-8.5 на Ubuntu до последнего патч-релиза: проверить версию и репозиторий, обновить пакеты ветки, перезапустить PHP-FPM и включить автообновление.
- Ошибка · PHP Ошибка php-fpm permission denied: причины и исправление Разбираем ошибку php-fpm permission denied: почему PHP-FPM не запускается и не читает сокет, как проверить права на /run/php и /var/www, исправить конфиг пула и…
PHP-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы