К содержимому

Настройка пула PHP-FPM: конфиг www.conf и его параметры

Пул PHP-FPM задаёт, от какого пользователя работает PHP, где слушает сокет и сколько процессов держит под нагрузкой. Готовый блок для /etc/php/8.3/fpm/pool.d/www.conf меняют под память сервера и проверяют через sudo php-fpm8.3 -t.

Конфиг PHP 4 мин чтения

Конфиг

/etc/php/8.3/fpm/pool.d/www.conf
[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

Как применить и проверить

bash
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-FPM на сервере: настройка, пул и типичные ошибки: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.