PHP-FPM на сервере: настройка, пул и типичные ошибки
PHP-FPM это менеджер процессов, который принимает запросы от nginx и выполняет PHP-скрипты в отдельных воркерах. На Ubuntu 24.04 пакет ставится как php8.3-fpm, конфигурация лежит в /etc/php/8.3/fpm/, а пул по умолчанию описан в www.conf.
Что такое PHP-FPM и зачем он нужен
PHP-FPM (FastCGI Process Manager) держит пул процессов PHP и общается с веб-сервером по протоколу FastCGI через Unix-сокет или TCP-порт. nginx не умеет выполнять PHP сам, поэтому передаёт запрос в FPM, получает готовый HTML и отдаёт его клиенту. В отличие от mod_php процессы PHP живут отдельно от nginx, их число и лимиты памяти задаются в конфиге пула.
Проверка версии и установленных модулей
Версию PHP и загруженные расширения проверяют через CLI, это тот же бинарник, что и у FPM, но с другим ini. Команда php --ini показывает, какие файлы конфигурации читаются. Если php -v выдаёт не ту версию, проверьте альтернативы через update-alternatives --config php.
php -v
php -m
php --ini
Установка PHP-FPM на Ubuntu 24.04
Пакет ставится из репозитория Ubuntu вместе с расширениями для MySQL и работы с изображениями. После установки сервис php8.3-fpm запускается автоматически и слушает сокет /run/php/php8.3-fpm.sock. Проверить состояние можно через systemctl status.
sudo apt update
sudo apt install -y php8.3-fpm php8.3-mysql php8.3-curl php8.3-mbstring php8.3-xml
sudo systemctl status php8.3-fpm
Структура конфигурации FPM
Главный файл /etc/php/8.3/fpm/php.ini задаёт параметры самого PHP, а каталог /etc/php/8.3/fpm/pool.d/ содержит описания пулов. По умолчанию там один файл www.conf. Каждый пул это отдельный набор воркеров со своим пользователем, сокетом и лимитами.
ls /etc/php/8.3/fpm/pool.d/
sudo php-fpm8.3 -t
Настройка пула www.conf
Пул задаёт пользователя, от которого работают воркеры, адрес сокета и число процессов. Пользователь должен совпадать с владельцем файлов сайта, иначе PHP не сможет писать в кеш и логи. Директива pm выбирает стратегию управления процессами, для небольших серверов подходит dynamic.
[www]
user = www-data
group = www-data
listen = /run/php/php8.3-fpm.sock
listen.owner = www-data
listen.group = www-data
listen.mode = 0660
pm = dynamic
pm.max_children = 20
pm.start_servers = 4
pm.min_spare_servers = 2
pm.max_spare_servers = 6
pm.max_requests = 500
Связка с nginx
nginx передаёт запросы с расширением .php в FPM через директиву fastcgi_pass, указывая тот же сокет, что в пуле. Блок location ~ \.php$ должен стоять после location /, иначе статика обработается неправильно. После правки конфигурации проверьте её через sudo nginx -t и перезагрузите nginx.
server {
listen 80;
server_name example.com;
root /var/www/example.com;
index index.php index.html;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
include snippets/fastcgi-php.conf;
fastcgi_pass unix:/run/php/php8.3-fpm.sock;
}
}
Права на сокет и файлы сайта
Ошибка Permission denied при подключении к сокету означает, что nginx и FPM работают от разных пользователей или у сокета неверные права. Владельцем файлов сайта должен быть тот же www-data, что указан в пуле. Каталоги получают права 755, файлы 644, запись нужна только в каталоги кеша и загрузок.
sudo chown -R www-data:www-data /var/www/example.com
sudo find /var/www/example.com -type d -exec chmod 755 {} \;
sudo find /var/www/example.com -type f -exec chmod 644 {} \;
Применение изменений и перезагрузка
Перед перезагрузкой проверьте синтаксис конфигурации командой sudo php-fpm8.3 -t. Команда reload перечитывает конфиг без обрыва текущих запросов, restart полностью останавливает и запускает сервис. Изменения в php.ini тоже требуют перезагрузки FPM.
sudo php-fpm8.3 -t
sudo systemctl reload php8.3-fpm
Частые ошибки
-
В
fastcgi_passуказан сокет другой версии PHP, напримерphp8.2-fpm.sock, а установлен только 8.3.Сверьте путь в nginx с директивой
listenв/etc/php/8.3/fpm/pool.d/www.confи приведите их к одному значению. -
Файлы сайта принадлежат
root, а пул работает отwww-data, поэтому PHP не может писать в кеш и загрузки.Выполните
sudo chown -R www-data:www-data /var/www/example.comи проверьте права на каталоги записи. -
После правки
php.iniизменения не применяются, потому что сервис не перезагружен.Выполните
sudo systemctl reload php8.3-fpmи убедитесь, чтоphp --iniуказывает на отредактированный файл. -
pm.max_childrenвыставлен слишком большим, и сервер уходит в swap под нагрузкой.Рассчитайте лимит от доступной памяти и среднего размера процесса PHP, начните с 10-20 воркеров и следите за потреблением.
Deploykin
Как это делается в Deploykin
В Deploykin версия PHP выбирается для каждого сайта отдельно, а авто-тюнинг подбирает настройки PHP-FPM, MySQL и Nginx под ресурсы сервера. Рекомендации применяются в один клик.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем PHP-FPM отличается от mod_php?
FPM запускает PHP отдельными процессами и общается с nginx по FastCGI, а mod_php встраивает интерпретатор в Apache. FPM позволяет гибко задавать число воркеров и изолировать сайты по пулам.
Где находится конфигурация PHP-FPM на Ubuntu 24.04?
Основной файл: /etc/php/8.3/fpm/php.ini, пулы лежат в /etc/php/8.3/fpm/pool.d/, по умолчанию там www.conf.
Как проверить синтаксис конфигурации FPM?
Выполните sudo php-fpm8.3 -t. Команда выведет configuration file ... test is successful или укажет файл и строку с ошибкой.
Почему nginx отдаёт 502 при работающем PHP-FPM?
Чаще всего не совпадает путь к сокету в fastcgi_pass и listen или у сокета неверные права. Проверьте journalctl -u php8.3-fpm и error.log nginx.
Нужно ли перезагружать FPM после изменения php.ini?
Да, php.ini читается при старте воркеров. Выполните sudo systemctl reload php8.3-fpm, чтобы применить новые значения без простоя.