Администрирование PHP через FastCGI Process Manager

Расширенные примеры настройки и диагностики PHP-FPM

1. Динамическое изменение пула без перезагрузки (reload)

При изменении конфигурации пула можно выполнить graceful reload без потери активных соединений:

sudo systemctl reload php8.1-fpm

Результат: служба перечитывает файлы конфигурации, текущие процессы завершают обработку запросов, новые процессы запускаются с новыми параметрами. Эквивалентная команда для init.d:

sudo /etc/init.d/php8.1-fpm reload

2. Настройка PHP-FPM с использованием TCP-сокета вместо Unix-сокета

Иногда требуется делить пул между несколькими серверами. Используйте TCP-сокет:

[www]
listen = 127.0.0.1:9000
listen.allowed_clients = 127.0.0.1

В Nginx:

fastcgi_pass 127.0.0.1:9000;

Результат: запросы проходят через TCP loopback. Unix-сокет быстрее, TCP удобнее для сетевого разделения.

3. Ограничение количества одновременных запросов на воркер

Параметр pm.max_requests определяет, сколько запросов обработает один процесс до его перезапуска. Это помогает бороться с утечками памяти:

[www]
pm.max_requests = 1000

Мониторинг используйте команду:

ps aux | grep php-fpm

Вы увидите, что каждый процесс завершает работу после 1000 запросов и заменяется новым.

4. Использование пула с разными версиями PHP

На одном сервере можно установить несколько версий PHP (например, 7.4 и 8.1) и запустить для каждого свой PHP-FPM с разными пулами. В Nginx для разных location укажите соответствующий сокет:

location ~ \.php$ {
    # Основная версия PHP 8.1
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
}

location /legacy/ {
    location ~ \.php$ {
        fastcgi_pass unix:/run/php/php7.4-fpm.sock;
    }
}

Такой подход используется при миграции проектов на новую версию PHP.

5. Профилирование медленных запросов

Включите логирование медленных запросов (slow log) для выявления узких мест в PHP-скриптах:

[www]
request_slowlog_timeout = 5s
slowlog = /var/log/php/slow.log

Пример записи в slow.log:

[12-Jun-2025 10:15:22] [pool www] pid 12345
script_filename = /var/www/html/index.php
[0x00007f1234567890] sleep() /var/www/html/index.php:10
[0x00007f1234567891] main() /var/www/html/index.php:1

Результат показывает, что скрипт выполнялся дольше 5 секунд из-за вызова sleep() в строке 10.

6. Мониторинг пула через Unix-сокет с помощью socat

Используйте утилиту socat для отправки команды статуса в PHP-FPM:

echo "GET /status" | sudo socat - UNIX-CONNECT:/run/php/php8.1-fpm.sock

Результат (фрагмент):

pool:                 www
process manager:      dynamic
start time:           12/Jun/2025:10:00:00 +0000
start since:          915
accepted conn:        1024
listen queue:         0
max listen queue:     0
listen queue len:     128
idle processes:       2
active processes:     1
total processes:      3
max active processes: 5
max children reached: 0
slow requests:        0

7. Настройка пула для использования переменных окружения

Передавайте переменные окружения из веб-сервера в PHP с помощью директивы env:

[www]
env[APP_ENV] = production
env[DB_HOST] = localhost
env[DB_NAME] = myapp

В коде PHP доступ через getenv('APP_ENV'). Полезно для разделения конфигураций разработки и продакшна.

8. Решение проблемы “Unable to create child process”

Ошибка возникает при нехватке памяти или превышении лимита пользовательских процессов. Проверьте системные лимиты:

ulimit -u   # лимит пользовательских процессов
cat /proc/sys/kernel/pid_max

Увеличьте лимит в /etc/security/limits.conf:

www-data soft nproc 1024
www-data hard nproc 2048

После изменения перезапустите PHP-FPM. Если проблема сохраняется, уменьшите pm.max_children.

9. Использование pm.status_path для автоматического мониторинга (Prometheus)

Создайте exporter для сбора метрик. Включите статусную страницу в формате JSON:

pm.status_path = /status?json

Пример ответа:

{"pool":"www","process-manager":"dynamic","start-time":1718183200,"start-since":200,"accepted-conn":500,"listen-queue":0,"max-listen-queue":0,"listen-queue-len":128,"idle-processes":2,"active-processes":1,"total-processes":3,"max-active-processes":4,"max-children-reached":0,"slow-requests":0}

С помощью скрипта (Python, bash) парсите JSON и передайте в Prometheus или любой другой мониторинг.

10. Изоляция пулов по сети namespace

Для усиления безопасности можно запустить каждый пул в отдельном namespace с помощью systemd. Создайте сервисный файл для каждого пула (например, /etc/systemd/system/php8.1-fpm@.service):

[Unit]
Description=PHP-FPM for %i
After=network.target

[Service]
Type=notify
ExecStart=/usr/sbin/php-fpm8.1 --nodaemonize --fpm-config /etc/php/8.1/fpm/pool.d/%i.conf
PrivateTmp=true
ProtectSystem=full

Затем запустите экземпляр для пула site2:

sudo systemctl start php8.1-fpm@site2

Этот метод используется в контейнеризированных средах для максимальной изоляции.