Upstream-серверы PHP-FPM: настройка веб-сервера

Как распределять нагрузку между несколькими серверами PHP-FPM?

Если требуется масштабирование или отказоустойчивость, можно указать несколько серверов в блоке upstream. По умолчанию nginx использует алгоритм round-robin. Поддерживаются также least_conn, ip_hash и random.

upstream php_backend {
    server 10.0.0.1:9000 weight=3;
    server 10.0.0.2:9000;
    server 10.0.0.3:9000 backup;
}

server {
    ...
    location ~ \.php$ {
        fastcgi_pass php_backend;
        ...
    }
}
  

Upstream php fpm (настройка upstream для php-fpm в nginx)

Параметр weight задаёт вес сервера (по умолчанию 1). backup делает сервер резервным - он используется только когда основные серверы недоступны. Для сессионной привязки (sticky sessions) применяется ip_hash:

upstream php_backend {
    ip_hash;
    server 10.0.0.1:9000;
    server 10.0.0.2:9000;
}
  

запустить локальный сервер php (запуск локального сервера php)

Когда использовать: при росте нагрузки, необходимости горизонтального масштабирования или отказоустойчивости.

Как повысить производительность с помощью Unix-сокета?

Unix-сокеты быстрее TCP, так как не требуют сетевого стека. Они подходят, когда nginx и PHP-FPM работают на одном сервере. Убедитесь, что PHP-FPM настроен на прослушивание сокета (например, listen = /run/php/php8.2-fpm.sock). В nginx достаточно указать путь к сокету.

upstream php_backend {
    server unix:/var/run/php/php8.2-fpm.sock;
}
  

Php non thread safe (php non-thread-safe (не потокобезопасная версия))

Случаи использования: выделенные серверы с одним PHP-FPM, минимальная задержка, отсутствие сетевой изоляции.

Как уменьшить накладные расходы на соединения с помощью keepalive?

По умолчанию nginx открывает новое соединение для каждого запроса к PHP-FPM. Директива keepalive в блоке upstream позволяет переиспользовать соединения, снижая задержки и нагрузку на CPU. Для включения необходимо добавить keepalive и в location указать fastcgi_keep_conn on;.

upstream php_backend {
    server unix:/var/run/php/php8.2-fpm.sock;
    keepalive 32;
}

server {
    location ~ \.php$ {
        fastcgi_pass php_backend;
        fastcgi_keep_conn on;
        ...
    }
}
  

Rewritecond request filename php (правило rewritecond для php в .htaccess)

Число 32 - максимальное количество idle-соединений, хранящихся в пуле. Настройка особенно эффективна при высокой частоте запросов.

Когда применять: высоконагруженные сайты, где каждый миллисекунд задержки имеет значение.

Как настроить таймауты для долгих PHP-скриптов?

Таймауты контролируются директивами fastcgi_connect_timeout, fastcgi_send_timeout, fastcgi_read_timeout. По умолчанию значения обычно 60 секунд. Если скрипты выполняются дольше (например, генерация отчётов), увеличьте таймауты в контексте location.

location ~ \.php$ {
    fastcgi_pass php_backend;
    fastcgi_connect_timeout 30s;
    fastcgi_send_timeout 120s;
    fastcgi_read_timeout 300s;
    ...
}
  

Apache 2.4 php 8.2 (настройка apache 2.4 с php 8.2)

Значение fastcgi_read_timeout должно быть больше максимального времени выполнения скрипта, заданного в max_execution_time PHP.

Цель: корректная обработка длительных операций (импорт данных, видео-конвертация).

Как автоматически исключать неработающие бэкенды?

Nginx предоставляет пассивные проверки здоровья через параметры max_fails и fail_timeout. Если сервер не отвечает max_fails раз в течение fail_timeout, он помечается как недоступный на время fail_timeout.

upstream php_backend {
    server 10.0.0.1:9000 max_fails=3 fail_timeout=30s;
    server 10.0.0.2:9000 max_fails=3 fail_timeout=30s;
}
  

Php index сервер (настройка индексного файла php на сервере)

По умолчанию max_fails=1, fail_timeout=10s. Если все серверы недоступны, nginx возвращает 502.

Когда нужно: для автоматического переключения на резервные серверы без вмешательства администратора.

Как динамически выбирать бэкенд (например, по URI)?

С помощью директивы map можно привязать выбор upstream к переменной, например, части URI. Это полезно для разделения трафика (старые и новые версии PHP, A/B тестирование).

map $uri $backend {
    ~^/legacy  php_legacy;
    default    php_main;
}

upstream php_main {
    server unix:/run/php/php8.2-fpm.sock;
}

upstream php_legacy {
    server unix:/run/php/php7.4-fpm.sock;
}

server {
    location ~ \.php$ {
        fastcgi_pass $backend;
        ...
    }
}
  

Случаи использования: миграция на новую версию PHP, разделение окружений (dev/staging), канареечные релизы.