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

PHP-FPM на сервере: настройка, пул и типичные ошибки

PHP-FPM это менеджер процессов, который принимает запросы от nginx и выполняет PHP-скрипты в отдельных воркерах. На Ubuntu 24.04 пакет ставится как php8.3-fpm, конфигурация лежит в /etc/php/8.3/fpm/, а пул по умолчанию описан в www.conf.

Опорная PHP 3 мин чтения 10 материалов в теме

Что такое 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.

bash
php -v
php -m
php --ini

Установка PHP-FPM на Ubuntu 24.04

Пакет ставится из репозитория Ubuntu вместе с расширениями для MySQL и работы с изображениями. После установки сервис php8.3-fpm запускается автоматически и слушает сокет /run/php/php8.3-fpm.sock. Проверить состояние можно через systemctl status.

bash
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. Каждый пул это отдельный набор воркеров со своим пользователем, сокетом и лимитами.

bash
ls /etc/php/8.3/fpm/pool.d/
sudo php-fpm8.3 -t

Настройка пула www.conf

Пул задаёт пользователя, от которого работают воркеры, адрес сокета и число процессов. Пользователь должен совпадать с владельцем файлов сайта, иначе PHP не сможет писать в кеш и логи. Директива pm выбирает стратегию управления процессами, для небольших серверов подходит dynamic.

ini
[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.

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, запись нужна только в каталоги кеша и загрузок.

bash
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.

bash
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, чтобы применить новые значения без простоя.

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